---
title: "Get Task Status"
method: GET
path: "/v2/gt-mage/tasks/{id}"
tags: ["ChatGPT Image"]
---

# Get Task Status

`GET /v2/gt-mage/tasks/{id}`

Poll the status of an image generation task. Use the task ID returned from `POST /v2/gt-mage/create-image`.

### Status values

| Status | Description |
|--------|-------------|
| `processing` | Task is being processed |
| `completed` | Done — `file_urls` contains the generated images |
| `failed` | Error — see `error` field for details. Credits are automatically refunded |

> **Rate limit:** 30 requests/minute

## Path parameters

- `id` string, required

## Response `200`

Task status

- VeoV2TaskStatus — Task status returned from polling and history endpoints
  - `id` string — Task ID
  - `prompt` string — The prompt used for generation
  - `file_urls` string[] — URLs of the generated files (empty while processing)
  - `status` 'processing' | 'completed' | 'failed' — Task status
  - `error` string — Error message (only present when status is `failed`)
  - `created_at` string, date-time — Timestamp when the task was created

## Other responses

- `404` — Task not found or does not belong to the authenticated user
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/genaipro/apis/genaipro-api.md) · [All operations](https://skmtc.dev/genaipro/apis/genaipro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/genaipro/genaipro-api/revisions/91f814eaecbd/schema)