# Get Translation Status
Retrieves the real-time status of a specific video translation using its ID.
**Note:**
* The video file `url` remains valid for 7 days. The video itself does not expire, only the link does. To ensure continuous access, you have two options:
1. **Download the Video:** Save the video locally within the 7-day window.
2. **Regenerate the URL:** Call the endpoint again whenever you need to access the video file.
* Scroll down to the **Response** section below and expand the status code(s) to view the detailed response schema.
* Refer to the **RESPONSE** panel on the right and choose an example to explore different video processing statuses (such as pending, running, success, or failed) and see how each status appears in the API response examples.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "heygen-api",
"version": "4.0.8"
},
"servers": [
{
"url": "https://api.heygen.com"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"name": "x-api-key",
"in": "header",
"x-default": ""
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/v2/video_translate/{video_translate_id}": {
"get": {
"summary": "Check Translation Status",
"description": "Track the progress and status of your video translations in real-time",
"operationId": "video-translate-status",
"parameters": [
{
"name": "video_translate_id",
"in": "path",
"schema": {
"type": "string"
},
"required": true,
"description": "Unique identifier of the translated video. Can be retrieved from either the Translate Video or Translate Video from Proofread endpoint. "
}
],
"responses": {
"200": {
"description": "Status retrieved successfully - Expand to view the detailed response schema.",
"content": {
"application/json": {
"examples": {
"Success": {
"value": "// If the video rendering is completed, the response looks like this: \n\n{\n \"error\": null,\n \"data\": {\n \"video_translate_id\": \"7544c0b52ada44fda693a15b1181b5b4-ur_ur-PK\",\n \"title\": \"My Translated Video\",\n \"output_language\": \"Urdu (Pakistan)\",\n \"status\": \"success\",\n \"url\": \"https://resource2.heygen.ai/video_translate/7544c0b52ada44fda693a15b1181b5b4-ur_ur-PK/original.mp4?response-content-disposition=attachment%3B+filename%2A%3DUTF-8%27%27My%2520Translated%2520Video.mp4%3B\",\n \"message\": null,\n \"callback_id\": null,\n \"caption_url\": null\n }\n}",
"summary": "Success"
},
"Running": {
"summary": "Running",
"value": "// If the video is running, the response will look like this:\n\n{\n \"error\": null,\n \"data\": {\n \"video_translate_id\": \"7544c0b52ada44fda693a15b1181b5b4-ur_ur-PK\",\n \"title\": \"My Translated Video\",\n \"status\": \"running\",\n \"url\": null,\n \"message\": null,\n \"callback_id\": null,\n \"caption_url\": null\n }\n}"
},
"Pending": {
"summary": "Pending",
"value": "// If the video is in the queue, you will get a response like this:\n\n{\n \"error\": null,\n \"data\": {\n \"video_translate_id\": \"7544c0b52ada44fda693a15b1181b5b4-ur_ur-PK\",\n \"title\": \"My Translated Video\",\n \"status\": \"pending\",\n \"url\": null,\n \"message\": null,\n \"callback_id\": null,\n \"caption_url\": null\n }\n}"
},
"Failed": {
"summary": "Failed",
"value": "/*\nIf an error occurs during the rendering process, the status is set to `\"failed\"`, \nand detailed information is returned in the `error` field.\n*/\n\n{\n \"error\": null,\n \"data\": {\n \"video_translate_id\": \"7544c0b52ada44fda693a15b1181b5b4-ur_ur-PK\",\n \"title\": \"My Translated Video\",\n \"status\": \"failed\",\n \"url\": null,\n \"message\": \"\"\n \"callback_id\": null,\n \"caption_url\": null\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Displays error message when the request fails; null if the request is successful."
},
"data": {
"type": "object",
"description": "Contains details of the translated video.",
"properties": {
"video_translate_id": {
"type": "string",
"description": "Unique identifier of the translated video."
},
"title": {
"type": "string",
"description": "Title of the video."
},
"output_language": {
"type": "string",
"description": "The language in which the video is translated."
},
"status": {
"type": "string",
"description": "Current status of the video.",
"enum": [
"failed: Video rendering failed",
"pending: Waiting in queue",
"success: Video rendered successfully",
"running: Video is rendering"
]
},
"url": {
"type": "string",
"description": "URL of the translated video. This URL will expire in 7 days. Call the endpoint again to generate a new one after expiration."
},
"message": {
"type": "string",
"description": "New field for messages. Contains human-readable messages explaining the status of the request. In case of errors, it returns an explanation."
},
"callback_id": {
"type": "string",
"description": "Custom ID for callback. Returned in the webhook for tracking purposes."
},
"caption_url": {
"type": "string",
"description": "URL of the captions file in .ass format, if generated. Returned only if 'caption: true' is specified when translating videos."
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```