History: List creatives

Every change to this page, newest first. Expand an entry to see what changed.

← List creatives

1. 1 Oct 2026 · +6 −5 lines
   Show changes

   ⋯
     |---|---|---|---|---|
     | `Authorization` | header | string | Yes | `Bearer <API key>` for a key with the `creatives:export` scope. |
   - | `updated_since` | query | integer | No | Unix epoch seconds (up to 11 digits). Returns only records updated after this time. |
   + | `updated_since` | query | integer | No | Unix epoch seconds (up to 11 digits). Returns only records whose exact update time is strictly after this second (`>`, not `>=`). |
     | `cursor` | query | string | No | The `next_cursor` from the previous page. Opaque; pass it back unchanged. |
     | `limit` | query | integer | No | Records per page, 1 to 100. Default `50`. |
     
   - You can combine `updated_since` and `cursor`. Keep the same `updated_since` on every page of one sync.
   + You can combine `updated_since` and `cursor`. Keep the same `updated_since` on every page of one sync. Because `updated_at` in each record is rounded down to the second, passing the largest `updated_at` you received usually returns the last records again; overwrite them by `creative_id`.
     
     ## Request example
   ⋯
     | `hook` | object or null | `action` and `line` of the first scene. `null` when there are no scenes. |
     | `formula` | object or null | `{ "name": ... }` of the formula the creative was built with. |
   - | `rights.ends_at` | integer or null | Last day of your export rights for the film, as Unix seconds at 00:00 UTC of that day. `null` when Wandura has no end date on record for your export rights. |
   + | `rights.ends_at` | integer or null | Last day of your export rights for the film, as Unix seconds at 00:00 UTC of that day. Your rights include that whole day: stop using the creative after that UTC day ends, that is at `ends_at + 86400`. `null` when Wandura has no end date on record for your export rights. |
     | `lineage.parent_creative_id` | string (UUID) or null | The creative this one was derived from. |
   - | `final.ready` | boolean | Whether the final render exists. |
   - | `final.target` | object | Target render spec: `width`, `height`, `fps`, `codec`. |
   + | `final.ready` | boolean | Whether the final render exists. A creative in status `pushed` has one. |
   + | `final.target` | object | Target render spec: `width`, `height`, `fps`, `codec`. Today it is the same for every creative (1080 × 1920, 30 fps, `h264`) and does not follow `placement`, so do not derive the frame size from it. |
     
     `scenes` lists only clips taken from film episodes. Other elements of the creative are not listed, so `duration_ms` can be shorter than the final video.
   ⋯
     | 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](../concepts/errors.md#creatives-errors) for what to do in each case.

2. 29 Sept 2026 · Page created