Skip to content
Elara One docs
Catalogue

List promotions

GET
/v1/promotions

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<>
Example Request
curl -X GET 'https://api.elaraone.app/api/v1/promotions' \  -H 'X-Tenant-Key: pk_live_…' \  -H 'X-Tenant-Secret: your-server-secret'
Example Response
{  "data": [    {      "id": 0,      "kind": "string",      "label": "string",      "badge": "string",      "banner": {        "title": "string",        "body": "string"      },      "ends_at": "string",      "target": {        "type": "string",        "id": 0,        "slug": "string"      },      "scope": "all"    }  ]}