Get a creative

get

https://apps.hivestack.com/api/dsp/creatives/{creative_id}

Retrieves the creatives submitted for approval with the specified creative ID.
Note that the same creative ID can be associated with multiple publishers, so the endpoint may return multiple creatives. To narrow down the results to a specific publisher, include the publisher_id in the query string.

In Perion DOOH, creative approval is handled at the individual file level. The approval_state field in the response indicates the status of each media file associated with the creative.

The approval_state can have one of the following integer values:

Pending: The file is awaiting approval.
Approved: The file has been approved and is ready for use.
Rejected: The file has been rejected and will not be used.

Only files with an approval_state of Approved will be eligible to play.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

creative_id

string

required

The unique identifier for the creative per publisher. This ID corresponds to the crid field sent in a bid response.

Query Params

publisher_id

string

The ID of the publisher responsible for approving the creative. You can find the list of publisher IDs and their corresponding names in our sellers.json.

deal_id

string

The ID of the deal associated with the creative. If a publisher_id is provided, this parameter will be ignored.

$top

integer

The number of items to return, see Paging - Top.

$skip

integer

The number of items to skip before returning the result, see Paging - Skip.

submitted_at_from

string

Filters the results to include only creatives created after or equal to the specified Unix timestamp (in milliseconds) or an ISO 8601 datetime string. For example: 1528221112000 or 2022-06-05T14:25:12Z.

submitted_at_to

string

≥ 0

Defaults to 0

Filters the results to include only creatives created before or equal to the specified Unix timestamp (in milliseconds) or an ISO 8601 datetime string. For example: 1528221112000 or 2022-06-05T14:25:12Z.

approved_at_from

string

Filters the results to include only creatives for which one or more creative files were approved after or equal to the specified Unix timestamp (in milliseconds) or ISO 8601 datetime string. For example: 1528221112000 or 2022-06-05T14:25:12Z.

approved_at_to

string

≥ 0

Defaults to 0

Filters the results to include only creatives for which one or more creative files were approved before or equal to the specified Unix timestamp (in milliseconds) or ISO 8601 datetime string. For example: 1528221112000 or 2022-06-05T14:25:12Z.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

404

Creative not found.

Language

Credentials

Loading…

Response

Choose an example:

application/json

*/*

200A list of creatives that match the query strings.

401Authorization information is missing.