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
401
Unauthorized
404
Not found
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?

