Get creatives

Retrieves the list of creatives submitted by a buyer from an external DSP along with their approval statuses.

In Hivestack, 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:

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

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

To control pagination in the API, the client can use the following query parameters:

• $top: Specifies the number of items to return per page. By default, the API returns 25 items per page.
• $skip: Determines the offset, or how many items to skip before starting to return results. By default, the API starts at the beginning of the dataset.

The response will include the following headers:

• x-page-offset: Indicates the starting point (offset) of the current page.
• x-page-size: Shows how many items are included in the current page.
• x-total-count: Provides the total number of items available across all pages.

For example:

• If you set $top=20 and $skip=40, the API will return items 41 through 60.
• The x-total-count header will indicate the total number of available items across all pages.

These parameters and headers allow efficient pagination through large datasets, ensuring that clients can fetch data in manageable chunks.