Skip to content
Elara One docs
Catalogue

List countries

GET
/v1/countries

Authorization

tenantKey
headerX-Tenant-Key<token>

The public store key (pk_live_…). Required on every call.

Header Parameters

X-Client-IP?string

Optional. IP address of the shopper (one IPv4/IPv6, no port, no list). Honoured only together with a valid X-Tenant-Secret; ignored otherwise. Used for rate limits and recorded with form submissions.

X-Tenant-Secret?string

Optional here. Server secret of the store: server-to-server only, never from a browser. Enables X-Client-IP.

Response Body

A list.

application/json
  1. response
data*array<>
meta*
Example Request
curl -X GET 'https://api.elaraone.app/api/v1/countries' \  -H 'X-Tenant-Key: pk_live_…' \  -H 'X-Tenant-Secret: your-server-secret'
Example Response
{  "data": [    {      "id": 0,      "iso2": "string",      "iso3": "string",      "name": "string",      "phonecode": "string"    }  ],  "meta": {    "default_country": "string"  }}

List promotions GET

Previous Page

Search products GET

Full product cards for a results page. For the same `q` and `locale` with no filters, `meta.total` equals the suggest endpoint's `data.products.total`. An empty `q` with a filter is a browse (e.g. every product with a tag). `meta.facets` counts the store's facets (Meilisearch only; empty on the database fallback), `meta.facet_labels` names them and `meta.facet_value_labels` names identifier values (`brand_slug` => brand names). Prices in filters are integer minor units of `meta.currency`. Every 200 carries `X-Search-Total` (equal to `meta.total`) and a fresh `X-Search-Id` header (a ULID) for click beacons, cached body or not.