List promotions

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)

idintegerOptional

titlestringOptional

title__icontainsstringOptional

title__containsstringOptional

statusstring · enumOptional

Lifecycle status of a promotion

Possible values:

currencystring · enumOptional

ISO 4217 currency codes supported by Bankaci

Example: aedPossible values:

per_card_limitintegerOptional

priorityintegerOptional

start_datestring · date-timeOptional

start_date__gtstring · date-timeOptional

start_date__gtestring · date-timeOptional

start_date__ltstring · date-timeOptional

start_date__ltestring · date-timeOptional

end_datestring · date-timeOptional

end_date__gtstring · date-timeOptional

end_date__gtestring · date-timeOptional

end_date__ltstring · date-timeOptional

end_date__ltestring · date-timeOptional

basket_offer_ids__containsstring[]Optional

basket_offer_ids__overlapstring[]Optional

Responses

200

Paginated promotions

application/json

countintegerOptional

nextstring · uri · nullableOptional

previousstring · uri · nullableOptional

401

Unauthorized

get/admin/promotions/

HTTPcURLJavaScriptPython

GET /api/v1/admin/promotions/ 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,
      "created_date": "2026-07-10T20:27:12.379Z",
      "modified_date": "2026-07-10T20:27:12.379Z",
      "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-10T20:27:12.379Z",
      "end_date": "2026-07-10T20:27:12.379Z",
      "usable_with_voucher_code": false
    }
  ]
}