Get promotion by ID

Retrieve detailed information about a specific promotion including rules and actions

POST /api/public/v1/promotions/getById

Get promotion by ID

cURL

curl --request POST \
  --url https://app.tagadapay.com/api/public/v1/promotions/getById \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "promo_123",
  "storeId": "store_123"
}
'

200

{
  "id": "promo_123",
  "name": "Summer Sale 20% Off",
  "code": "SUMMER20",
  "enabled": true,
  "automatic": false,
  "usageLimit": 100,
  "usageCount": 42,
  "startDate": "2025-06-01T00:00:00.000Z",
  "endDate": "2025-08-31T23:59:59.000Z",
  "ruleOperator": "AND",
  "rules": [],
  "actions": []
}

Authorizations

Authorization · string · header · required

Enter your API key as: Bearer your-api-key

Body

application/json

id · string · required

storeId · string · required

Response

200

application/json

Successful response