List creatives
const url = 'https://ads.wortise.com/api/public/v1/creatives/list';const options = { method: 'POST', headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'}, body: '{"cursor":1,"pagination":{},"filter":{"_id":["2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"],"brand":["2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"],"campaign":{"exists":true},"isDraft":[true],"organization":["2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"],"product":["2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"],"team":["2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"],"type":"banner"},"populate":[{"path":"adGroup","projection":{"additionalProperty":1}}],"term":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://ads.wortise.com/api/public/v1/creatives/list \ --header 'Content-Type: application/json' \ --header 'x-api-key: <x-api-key>' \ --data '{ "cursor": 1, "pagination": {}, "filter": { "_id": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "brand": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "campaign": { "exists": true }, "isDraft": [ true ], "organization": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "product": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "team": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "type": "banner" }, "populate": [ { "path": "adGroup", "projection": { "additionalProperty": 1 } } ], "term": "example" }'Lists the creatives of the organization with filters, sorting and pagination.
Requires the creatives:read scope.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
object
Matches Mongo Document type, e.g. { name: 1, age: -1 }
object
Matches Mongo Document type, e.g. { name: 1, age: -1 }
object
object
Ref to brands collection
Campaign the creative belongs to. Optional: a creative can be saved first and used in a campaign later
object
object
Campaign the creative belongs to. Optional: a creative can be saved first and used in a campaign later
Ref to products collection
object
object
Responses
Section titled “Responses”One page of creatives and the total count.
object
object
Ref to ad_groups collection. When set, this creative is resolved against its ad group instead of the campaign directly
object
object
object
Narrate the ad with an AI voice, one line per scene.
Language of the narration. Omit to narrate in the on-screen language.
Speaking speed, from 1 to 1.5; the pitch is kept.
Voice of the narration. cedar and onyx sound best in Spanish.
object
object
object
E.g: “1”, “20”.
object
object
object
object
object
Exact inventory locations or geographic areas to target.
object
object
Only explicitly requested targeting exclusions.
object
object
object
object
object
object
object
object
object
E.g: “1”, “20”.
object
object
object
object
Exact inventory locations or geographic areas to target.
object
object
object
object
object
object
object
object
object
object
object
Optional demographic filters. Age codes are ranges: -18=under 18, 18=18–24, 25=25–34, 35=35–44, 45=45–54, 55=55–64, 65=65+. Adults 18+ requires all six adult ranges, not just 18. Gender ?? means unknown, not all genders; omit gender on creation or use [] on update for unrestricted gender.
object
object
object
object
Optional demographic filters. Age codes are ranges: -18=under 18, 18=18–24, 25=25–34, 35=35–44, 45=45–54, 55=55–64, 65=65+. Adults 18+ requires all six adult ranges, not just 18. Gender ?? means unknown, not all genders; omit gender on creation or use [] on update for unrestricted gender.
object
object
Ref to brands collection
object
object
object
object
object
object
object
object
object
HTML content of the creative. Optional until first render.
Creative ID in ADS service
Position of the creative inside its ad group
Ref to products collection
object
Relevant product image URLs as seen on the page (max 3).
The main price the page shows for the item.
The discounted price when the page also shows a higher regular price for the same item, 0 when it shows no discount. Never a price without taxes or per installment.
object
Destination URL (redirect)
object
object
object
object
object
object
Narrate the ad with an AI voice, one line per scene.
Language of the narration. Omit to narrate in the on-screen language.
Speaking speed, from 1 to 1.5; the pitch is kept.
Voice of the narration. cedar and onyx sound best in Spanish.
Example
{ "list": [ { "asset": { "aspectRatio": "5:4", "extension": "jpeg", "type": "image" }, "audience": { "app": { "list": [ { "platform": "android" } ] }, "device": { "os": [ "android", "ios" ], "type": [ "mobile" ] }, "location": [ { "source": "google_places", "type": "place" } ], "not": { "device": { "os": [ "android", "ios" ], "type": [ "mobile" ] }, "app": { "list": [ { "platform": "android" } ] }, "appFilters": { "platform": [ "android" ] }, "location": [ { "source": "google_places", "type": "place" } ], "user": { "gender": [ "female" ], "age": [ "-18" ] } }, "user": { "gender": [ "female" ], "age": [ "-18" ] } }, "brand": { "adn": { "colorScheme": "light" } }, "cta": "contact_us", "isDraft": false, "locale": "en", "status": "enabled", "type": "banner", "v": { "additionalProperty": { "asset": { "aspectRatio": "5:4", "extension": "jpeg", "type": "image" } } }, "verification": "approved" } ]}The JSON body is malformed or fails the input validation.
object
Zod issues
object
Location of the invalid field in the procedure input
object
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "errors": [ { "code": "custom" } ], "message": "Validation Error"}The API key is missing, invalid, disabled or expired.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key lacks the scope, or its owner lacks the dashboard permission.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key exceeded its rate limit; retry after the Retry-After seconds.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}Headers
Section titled “Headers”Seconds to wait before retrying.
Unexpected server error.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}© 2026 Wortise. All rights reserved.