Get movie status#

GET https://api.json2video.com/v2/movies

Retrieves the status and metadata of a single project, or lists all projects for the authenticated account.

Request#

Headers#

Query parameters#

Body#

None.

Response#

200 OK — single project#

{
  "success": true,
  "movie": {
    "success": true,
    "status": "done",
    "message": "",
    "project": "JkGxEoPRF9EgRb32",
    "url": "https://assets.json2video.com/clients/xxxxxxxx/renders/2026-05-12-36066.mp4",
    "thumbnail": "https://assets.json2video.com/clients/xxxxxxxx/renders/2026-05-12-36066.jpg",
    "ass": "https://assets.json2video.com/clients/xxxxxxxx/renders/2026-05-12-36066.ass",
    "created_at": "2026-05-12T07:41:41.946Z",
    "ended_at": "2026-05-12T07:44:57.108Z",
    "duration": 108.2,
    "size": 6876189,
    "width": 1080,
    "height": 1920,
    "rendering_time": 195,
    "client-data": {},
    "consumed_credits": []
  },
  "remaining_quota": { "movies": 0, "drafts": 0, "time": 1807 }
}

200 OK — list of projects#

{
  "success": true,
  "from": "2026-05-01T00:00:00.000Z",
  "to":   "2026-05-12T23:59:59.999Z",
  "count": 25,
  "limit": 100,
  "has_next": false,
  "has_prev": false,
  "next_token": null,
  "movies": [ { "...": "movie object as above" } ],
  "remaining_quota": { "time": 1807 }
}

Pagination#

Keep requesting pages with the previous response's next_token until has_next is false. Do not stop because count is lower than limit: a page can hold fewer movies than limit while more exist.

That happens when the movies' json would make the response too large (about 5 MB). The page then ends early, has_next is true, and next_token continues right after the last movie returned, so every movie is listed exactly once. In the rare case that a single movie's json is too large to fit in a page on its own, that movie is listed without json; get it with ?project=.

If you don't need json, add format=simple: pages are much smaller and faster. Some older movies may still include json in list pages even with format=simple.

Status enum#

Movie object fields#

Delivery results#

When the movie has output destinations (exports[].destinations[]: webhooks, FTP, SFTP, Amazon S3, email), a single-project response includes destinations_result, one entry per destination, in the order of the movie JSON. The list response (movies) does not include it.

{
  "destinations_result": [
    {
      "index": 0,
      "type": "ftp",
      "id": "media-server",
      "status": "error",
      "http_status": null,
      "attempts": 1,
      "message": "…",
      "duration_ms": 30112,
      "at": "2026-09-17T10:15:01.702Z"
    },
    {
      "index": 1,
      "type": "webhook",
      "id": null,
      "status": "ok",
      "http_status": 200,
      "attempts": 1,
      "message": "Delivered to https://example.com (HTTP 200).",
      "duration_ms": 412,
      "at": "2026-09-17T10:15:02.114Z"
    }
  ]
}

The same results appear in the dashboard under Render logs → the render → Deliveries. Retry rules for webhooks: Webhooks → Delivery and retries.

Errors#

A project ID that is not found returns 400 with success: false and the Movie <project> not found… message above. It is not a render failure: retrying with the same ID returns the same error, so polling loops should stop on it.

Examples#

Poll a single project#

curl --location --request GET \
  'https://api.json2video.com/v2/movies?project=JkGxEoPRF9EgRb32' \
  --header 'x-api-key: YOUR_API_KEY'

List the last 50 projects#

curl --location --request GET \
  'https://api.json2video.com/v2/movies?limit=50&date_start=2026-04-12&date_end=2026-05-12' \
  --header 'x-api-key: YOUR_API_KEY'

Paginate#

# First page
curl 'https://api.json2video.com/v2/movies?limit=100' -H 'x-api-key: …'
# Subsequent pages: pass the previous response's `next_token`
curl 'https://api.json2video.com/v2/movies?limit=100&next_token=AAA…' -H 'x-api-key: …'