API reference
Returns the data record of one approved creative of your organisation. Use it to fetch a single creative, or to check whether a creative you stored is still available.
GET /api/delivery/v1/creatives/{id}Scope: creatives:export
Description
Returns the same record as List creatives, wrapped in the {code, message, data, server_time} envelope. A creative that does not exist, belongs to another organisation, or is not in status approved or pushed returns the same 404, so you cannot tell these cases apart.
Request parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization |
header | string | Yes | Bearer <API key> for a key with the creatives:export scope. |
id |
path | string (UUID) | Yes | The creative_id of the creative. A value that is not a UUID returns 404. |
Request example
curl -s https://www.wandura.ai/api/delivery/v1/creatives/5e1b7c3a-2d4f-4a6b-9c8d-0e1f2a3b4c5d \
-H "Authorization: Bearer $WANDURA_API_KEY"Response
200 OK
| Field | Type | Description |
|---|---|---|
code |
integer | 0. |
message |
string | "ok". |
data |
object | The creative record. Fields are listed in The creative record. |
server_time |
integer | Server time in Unix epoch seconds. |
Response example
{
"code": 0,
"message": "ok",
"data": {
"schema_version": 1,
"creative_id": "5e1b7c3a-2d4f-4a6b-9c8d-0e1f2a3b4c5d",
"creative_code": "ACV001-FILM0001-EP1-2-F1-TEAM",
"name": "Heiress returns - wedding hook",
"status": "pushed",
"created_at": 1790500000,
"approved_at": 1790590000,
"updated_at": 1790640000,
"org": { "slug": "your-org" },
"film": { "code": "FILM0001", "title": "The Heiress Returns", "language": "en", "genres": ["romance", "revenge"] },
"episodes": [1, 2],
"placement": "reels_9x16",
"aspect": "9:16",
"duration_ms": 21500,
"scenes": [
{ "episode_no": 1, "start_ms": 12000, "end_ms": 19500, "duration_ms": 7500, "action": "reveal", "line": "You threw me out. Now watch me take it all back." },
{ "episode_no": 2, "start_ms": 40000, "end_ms": 54000, "duration_ms": 14000, "action": null, "line": null }
],
"hook": { "action": "reveal", "line": "You threw me out. Now watch me take it all back." },
"formula": { "name": "Cliffhanger opener" },
"rights": { "ends_at": 1798675200 },
"lineage": { "parent_creative_id": null },
"final": { "ready": true, "target": { "width": 1080, "height": 1920, "fps": 30, "codec": "h264" } }
},
"server_time": 1790679032
}Errors
| Status | code |
When |
|---|---|---|
| 401 | 4010 | The Authorization: Bearer header is missing. |
| 401 | 4011 | The key is unknown or revoked. |
| 403 | 4030 | The key lacks the creatives:export scope. |
| 403 | 4031 | Your organisation's access is suspended. |
| 404 | 4040 | No approved creative with this ID exists for your organisation, or the ID is not a UUID. |
| 429 | none | Rate limit reached. Flat body with error_code rate_limited, not the envelope. |
| 503 | 5030 | The feed is temporarily unavailable. Retry with backoff. |
| 503 | 5031 | Wandura could not verify the API key in time. The key is not wrong: retry with backoff. |
See Errors for what to do in each case.
Updated 1 Oct 2026 · Change history (2)