Promotion

Retrieve promotion

get

Retrieve a specific promotion by ID

Authorizations

Token

AuthorizationstringRequired

Path parameters

idintegerRequired

Unique identifier of the resource

Example: 1

Responses

200

Promotion successfully retrieved

application/json

401

Unauthorized Access

application/json

404

The given resource or object was not found or does not exist.

application/json

500

Server Error

get

/api/v1/promotions/{id}/

HTTPcURLJavaScriptPython

GET /api/v1/promotions/{id}/ HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "pk": 1,
  "name": "text",
  "slug": "text",
  "integration": 1,
  "created_date": "2026-01-19T23:27:04.386Z",
  "modified_date": "2026-01-19T23:27:04.386Z"
}

List promotions

get

List all promotions

Authorizations

Token

AuthorizationstringRequired

Query parameters

pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1

limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10

pkintegerOptional

Filters by primary key

pk__gtstringOptional

Filter by primary key greater than a specific value.

pk__gteintegerOptional

Filters by primary key greater than or equal to the given value

pk__ltintegerOptional

Filters by primary key less than the given value

pk__lteintegerOptional

Filters by primary key less than or equal to the given value

namestringOptional

Filter by name.

slugstringOptional

Filter by slug.

created_datestring · date-timeOptional

Filter by creation date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: created_date__gt=2024-01-01T00:00:00Z

modified_datestring · date-timeOptional

Filter by modification date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: modified_date__lt=2024-01-01T00:00:00Z

Responses

200

Promotions successfully listed

application/json

401

Unauthorized Access

application/json

500

Server Error

get

/api/v1/promotions/

HTTPcURLJavaScriptPython

GET /api/v1/promotions/ HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "count": 1,
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "created_date": "2026-01-19T23:27:04.386Z",
      "modified_date": "2026-01-19T23:27:04.386Z"
    }
  ]
}