List Promotions
List central promotions for the authenticated organization with filters and offset pagination matching the workspace Promotions listing. Requires promotions:read.
Authorizations
Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.
Query Parameters
Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token.
120Search promotion name.
200Effective status filter: all, draft, scheduled, active, paused, ended, or archived.
all, draft, scheduled, active, paused, ended, archived Comma-separated marketplaces, for example shopee,lazada,tiktok,shopify.
200Comma-separated promotion store keys (marketplace:country:storeId).
2000Sort field.
createdAt, name, startsAt, status Sort direction.
asc, desc Page size. Default 20, max 50.
1 <= x <= 50Zero-based pagination offset.
x >= 0