CTRL + K

GET /v1/renders endpoint

Use this endpoint to get the status of a render by specifying its ID. You may want to consider using webhooks instead of this endpoint.

Response data

You'll receive a response in the form of Render.

Example request

1curl -X GET https://api.creatomate.com/v1/renders/69ba407b-72a9-4050-a9fb-559827b9623d \
2  -H 'Authorization: Bearer API_KEY'
3

Example response

1{
2  "id": "69ba407b-72a9-4050-a9fb-559827b9623d",
3  "status": "succeeded",
4  "url": "https://cdn.creatomate.com/renders/69ba407b-72a9-4050-a9fb-559827b9623d.mp4",
5  "snapshot_url": "https://cdn.creatomate.com/snapshots/69ba407b-72a9-4050-a9fb-559827b9623d.jpg",
6  "template_id": "9e90d011-52e6-49dc-8a7a-5f25058c2568",
7  "template_name": "Your Template Name",
8  "template_tags": [],
9  "output_format": "mp4",
10  "render_scale": 1,
11  "width": 720,
12  "height": 900,
13  "frame_rate": 60,
14  "duration": 15.5,
15  "file_size": 751089
16}

POST /v1/renders

Webhooks