List creatives

get

https://api.uplynk.com/v5/creatives

Retrieves a paginated list of Creatives in your Workspace. Supports title search, filtering by media type, source, lifecycle status, and creation time, and sorting by creation or update time or title. By default only live (non-deleted) Creatives with a ready status are returned.

Use cases:

Populate a media library view with your uploaded and external Creatives
Search by title to locate a specific Creative
Filter by status to find Creatives still being prepared or that failed

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

page

integer

≥ 1

Defaults to 1

The page number to retrieve, starting at 1. Combine with page_size to page through the full result set.

page_size

integer

1 to 100

Defaults to 40

The number of Creatives to return per page. Defaults to 40 and may not exceed 100.

sort

string

enum

Orders the results by the chosen field. Prefix a field with - for descending order. Defaults to newest first by creation time.

Allowed:

string

Returns only Creatives whose title contains this text. Matching is case-insensitive and matches anywhere within the title.

media_type

string

enum

Returns only Creatives of the given media type. Accepts a single value or a comma-separated list of values.

Allowed:

status

string

enum

Defaults to ready

Returns only Creatives in the given lifecycle status. Accepts a single value or a comma-separated list; defaults to ready when omitted.

Allowed:

string

Returns only the Creatives whose IDs are given in this list. Accepts a single ID or a comma-separated list of up to 100 IDs.

created_at[gte]

date-time

Return only creatives created on or after this date-time.

created_at[lte]

date-time

Return only creatives created on or before this date-time.

created_at[gt]

date-time

Return only creatives created strictly after this date-time.

created_at[lt]

date-time

Return only creatives created strictly before this date-time.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Success

400Invalid request

401Unauthorized

500Internal error