> ## 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

## Hailuo video

Poll by `task_id` for progress and the final download URL.

***

### 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**  | Returned when the job was created. |

***

### Response

**200 OK**

| Field                | Type      | Description                             |
| :------------------- | :-------- | :-------------------------------------- |
| **code**             | `string`  | Business code (`"200"` = ok).           |
| **message**          | `string`  | Message.                                |
| **data**             | `object`  | Payload.                                |
| ├─ **status**        | `string`  | `processing`, `success`, `failed`, etc. |
| ├─ **progress**      | `string`  | Percent string, e.g. `"50"`.            |
| ├─ **result\_url**   | `string`  | Video URL when done.                    |
| ├─ **fail\_reason**  | `string`  | If failed.                              |
| ├─ **submit\_time**  | `integer` | Submitted at.                           |
| ├─ **finish\_time**  | `integer` | Finished at.                            |
| └─ **video\_width**  | `integer` | Output width.                           |
| └─ **video\_height** | `integer` | Output height.                          |

***

### cURL

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

***

### Success example

```json theme={null}
{
  "code": "200",
  "message": "success",
  "data": {
    "task_id": "task_pNzpa5Aw21zihhdYrACj6Jy0ZVW76BEe",
    "status": "success",
    "progress": "100",
    "result_url": "https://cdn.example.com/generated_video.mp4",
    "video_width": 1280,
    "video_height": 720,
    "submit_time": 1774595255,
    "finish_time": 1774595315
  }
}
```

Possible **status** values:

* Preparing
* Queueing
* Processing
* Success
* Fail

Allowed values: Preparing, Queueing, Processing, Success, Fail

***