List promotion usage records

get

Authorizations

OmnitronTokenAuth

AuthorizationstringRequired

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

Query parameters

pageinteger · min: 1Optional

Page number (1-based)

Default: 1

limitinteger · min: 1 · max: 200Optional

Number of results per page

Default: 10

sortstringOptional

Field to sort by. Prefix with - for descending (e.g. -created_date)

pre_order_call_idintegerOptional

promotion_idintegerOptional

basket_idstringOptional

order_numberstringOptional

Responses

200

Paginated promotion usage records

application/json

countintegerOptional

nextstring · uri · nullableOptional

previousstring · uri · nullableOptional

401

Unauthorized

get/admin/promotion-usages/

HTTPcURLJavaScriptPython

GET /api/v1/admin/promotion-usages/ HTTP/1.1
Host: your-bankaci-instance.example.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "count": 1,
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "id": 1,
      "pre_order_call": {
        "id": 1,
        "pre_order": {
          "id": 1,
          "basket_id": 1,
          "basket_modified_date": "2026-07-10T21:24:07.964Z",
          "tokenized_card": 1,
          "bin_6": "text",
          "fingerprint": "text",
          "currency": "aed",
          "created_date": "2026-07-10T21:24:07.964Z",
          "modified_date": "2026-07-10T21:24:07.964Z"
        },
        "promotion": {
          "id": 1,
          "created_date": "2026-07-10T21:24:07.964Z",
          "modified_date": "2026-07-10T21:24:07.964Z",
          "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-07-10T21:24:07.964Z",
          "end_date": "2026-07-10T21:24:07.964Z",
          "usable_with_voucher_code": false
        },
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "created_date": "2026-07-10T21:24:07.964Z",
        "modified_date": "2026-07-10T21:24:07.964Z"
      },
      "promotion": {
        "id": 1,
        "created_date": "2026-07-10T21:24:07.964Z",
        "modified_date": "2026-07-10T21:24:07.964Z",
        "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-07-10T21:24:07.964Z",
        "end_date": "2026-07-10T21:24:07.964Z",
        "usable_with_voucher_code": false
      },
      "tokenized_card": 1,
      "basket_id": "text",
      "order_number": "text",
      "fingerprint": "text",
      "reset_date": "2026-07-10T21:24:07.964Z",
      "created_date": "2026-07-10T21:24:07.964Z",
      "modified_date": "2026-07-10T21:24:07.964Z"
    }
  ]
}