Get a promotion, a list of promotions, or promotion search results

post

https://api.use.deducto.io/v1/manage/{projectId}/promotion/list

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

projectId

string

required

The project ID

Body Params

Request schema for retrieving promotions, either as a single promotion, a list of promotions, or paginated search results.

promotionId

uuid

If a promotion ID is specified, only data about that specific promotion will be returned. This option takes precedence over all other filters.

versionId

uuid

Specify the exact version of the promotion to return data for. If this is not specified, the latest version will be returned.

promotionIds

array of uuids

length ≥ 1

If promotion IDs are specified, only data about those specific promotions will be returned. This option takes precedence over all other filters except the singular promotion ID filter.

promotionIds

sortAttribute

string

enum

The attribute to sort the retrieved promotions by.

Allowed:

descending

boolean

If the results should be in reverse order

cursor

string

A cursor from a previous request to fetch the next page of results

string

Search terms to filter promotions by

pageSize

number

The number of items to return in a page

status

string

enum

Allowed:

Response

200Successful operation