For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get promotion usage record

get
Authorizations
AuthorizationstringRequired

Omnitron staff token. Format: Token <token>. Validated against Omnitron active_user API — user must have is_staff: true.

Path parameters
promotion_usage_idintegerRequired
Responses
200

Promotion usage details

application/json
idintegerRead-onlyOptional
tokenized_cardintegerOptional

FK to TokenizedCard

basket_idstringOptional

Omnitron basket ID (stored as string)

order_numberstring · nullableOptional

Omnitron order number, populated after order is placed

fingerprintstring · max: 1024Optional
reset_datestring · date-time · nullableOptional

Date after which this usage record no longer counts toward per_card_limit. Calculated from promotion.reset_schedule at the time of order placement. null when the promotion has no reset schedule (lifetime limit).

created_datestring · date-timeRead-onlyOptional
modified_datestring · date-timeRead-onlyOptional
get/admin/promotion-usages/{promotion_usage_id}/
GET /api/v1/admin/promotion-usages/{promotion_usage_id}/ HTTP/1.1
Host: your-bankaci-instance.example.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "id": 1,
  "pre_order_call": {
    "id": 1,
    "pre_order": {
      "id": 1,
      "basket_id": 1,
      "basket_modified_date": "2026-01-01T00:00:00.000Z",
      "tokenized_card": 1,
      "bin_6": "text",
      "fingerprint": "text",
      "currency": "aed",
      "created_date": "2026-01-01T00:00:00.000Z",
      "modified_date": "2026-01-01T00:00:00.000Z"
    },
    "promotion": {
      "id": 1,
      "created_date": "2026-01-01T00:00:00.000Z",
      "modified_date": "2026-01-01T00:00:00.000Z",
      "title": "text",
      "status": "ACTIVE",
      "currency": "aed",
      "per_card_limit": 1,
      "reset_schedule": "0 0 * * *",
      "bin_6_list": [
        "512345",
        "411111"
      ],
      "priority": 0,
      "basket_offer_ids": [
        "123",
        "456"
      ],
      "start_date": "2026-01-01T00:00:00.000Z",
      "end_date": "2026-01-01T00:00:00.000Z",
      "usable_with_voucher_code": false
    },
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "created_date": "2026-01-01T00:00:00.000Z",
    "modified_date": "2026-01-01T00:00:00.000Z"
  },
  "promotion": {
    "id": 1,
    "created_date": "2026-01-01T00:00:00.000Z",
    "modified_date": "2026-01-01T00:00:00.000Z",
    "title": "text",
    "status": "ACTIVE",
    "currency": "aed",
    "per_card_limit": 1,
    "reset_schedule": "0 0 * * *",
    "bin_6_list": [
      "512345",
      "411111"
    ],
    "priority": 0,
    "basket_offer_ids": [
      "123",
      "456"
    ],
    "start_date": "2026-01-01T00:00:00.000Z",
    "end_date": "2026-01-01T00:00:00.000Z",
    "usable_with_voucher_code": false
  },
  "tokenized_card": 1,
  "basket_id": "text",
  "order_number": "text",
  "fingerprint": "text",
  "reset_date": "2026-01-01T00:00:00.000Z",
  "created_date": "2026-01-01T00:00:00.000Z",
  "modified_date": "2026-01-01T00:00:00.000Z"
}

Last updated

Was this helpful?