Skip to main content
GET
Get promotion

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Headers

X-External-User-ID
string
required

Identifier of the acting user in the calling system (e.g. a Workfront user id). Recorded against every audited action this request performs.

X-External-User-Email
string<email>

Acting user email. Only meaningful on keys with act-on-behalf enabled, where it is resolved to the matching Adclear user and is mandatory on writes. Ignored on ordinary keys.

Path Parameters

promotionId
string<uuid>
required

Promotion ID

Response

The promotion's latest version

promotionId
string<uuid>
required
latestVersionId
string<uuid>
required

ID of the latest version: the one with the highest version number, whether it was created through the API or in the Adclear app. Use it with the version-level endpoints, such as GET .../decision.

latestVersion
integer
required

Version number of the latest version

status
enum<string>
required

Review status of the latest version. Same values as GET .../decision.

Available options:
approved,
rejected,
changes_requested,
conditionally_approved,
in_review,
pending,
expired,
none
versionCount
integer
required

Number of versions the promotion has

correlationId
string<uuid>
required

Correlation ID for request tracing. Include in support requests.