Single promo code card

Full code card with lifecycle for audit and incidents.

Why this method exists

Full code card with lifecycle for audit and incidents.

When to use

Row click, search result drill-down.

Endpoint

POST /v1/internal/inventory-promo-codes/get

Authentication: JWT via Authorization: Bearer <token>. User must have project access and inventory_promo_codes permission.

Permission: inventory_promo_codes.view

Request example

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "projectId": "a1b2…", "codeId": "code-uuid" }
}

Response example

{
  "success": true,
  "data": {
    "id": "code-uuid",
    "codeDisplay": "QUEEN14-48AMU",
    "status": "realized",
    "supplierName": "Промомед",
    "validUntil": "2026-12-31T23:59:59Z",
    "platformId": "platform-uuid",
    "realizedAt": "2026-07-01T10:00:00Z"
  }
}

Errors

UNAUTHORIZED / ACCESS_DENIED — access denied
VALIDATION_ERROR — invalid body
NOT_FOUND — resource not found
RATE_LIMIT_EXCEEDED (429) — rate limit

cURL

curl -X POST "https://api-external.promanta.ru/v1/internal/inventory-promo-codes/get" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '{"data": { "projectId": "a1b2…", "codeId": "code-uuid" }}'