> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokensmind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get video job status

## Veo video

Poll by `task_id` for status and the playable URL when the job succeeds.

***

### Basics

* **Endpoint**: `GET /v1/video/generations/{task_id}`
* **Auth**: `Bearer Token` (`Authorization: Bearer {{YOUR_API_KEY}}`)
* **Content-Type**: `application/json`

***

### Path

| Field        | Type     | Required | Description        |
| :----------- | :------- | :------- | :----------------- |
| **task\_id** | `string` | **Yes**  | From job creation. |

***

### Response

**200 OK**

***

### cURL

```bash theme={null}
curl -X GET "https://api.your-server.com/v1/video/generations/task_LK8YADXPxyoGME6wv79x8qId62v76PO5" \
 -H "Authorization: Bearer $YOUR_API_KEY"
```

***

### Example (completed)

```json theme={null}
{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "succeeded",
    "task_id": "task_**",
    "url": "https://tokensmind.ai/v1/videos/task_MQKsdsosLYRreob4Z4NzTFxZKtSoVRWZ/content"
  }
}
```

### Status codes

```json theme={null}
  VeoStatusPending = "pending"
  VeoStatusImageDownloading = "image_downloading"
  VeoStatusVideoGenerating = "video_generating"
  VeoStatusVideoGenerationCompleted = "video_generation_completed"
  VeoStatusVideoGenerationFailed = "video_generation_failed"
  VeoStatusVideoUpsampling = "video_upsampling"
  VeoStatusVideoUpsamplingCompleted = "video_upsampling_completed"
  VeoStatusVideoUpsamplingFailed = "video_upsampling_failed"
  VeoStatusCompleted = "completed"
  VeoStatusFailed = "failed"
  VeoStatusError = "error"
```

***

### Notes

1. **URL expiry**: Some providers return short-lived presigned URLs (`X-Amz-Signature`, \~24h)—copy to your storage promptly.
2. **Audio stems**: If the job created separate speech/SFX URLs, use them for post-production (when applicable).
3. **Progress**: Use `data.progress` for UI when present.
4. **Credits**: Use nested credit fields for billing reconciliation when the API returns them.

***