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

# Retrieve Happy Horse video task

> Retrieve normalized status and video outputs for a Happy Horse 1.1 task.

```text theme={"dark"}
GET https://gengen.farm/api/gengen/v1/contents/generations/tasks/{id}
```

Retrieve a Happy Horse task with the public ID returned by
[Create Happy Horse video task](/api-reference/happy-horse/video-generation/create-task).

[Try the retrieve workflow](https://gengen.farm/api-explorer/demos/happy-horse-video-generation-query).

## Path parameter

<ParamField path="id" type="string" required>
  Public task ID with the `happyhorse11:` prefix. URL-encode the colon when placing the ID in the
  request path.
</ParamField>

```bash theme={"dark"}
curl --request GET \
  --url https://gengen.farm/api/gengen/v1/contents/generations/tasks/happyhorse11%3Atask_123 \
  --header 'Authorization: Bearer gengen_live_xxxxxxxxxxxxxxxx'
```

## Response

```json theme={"dark"}
{
  "id": "happyhorse11:task_123",
  "model": "happyhorse-1.1",
  "status": "succeeded",
  "outputs": {
    "videos": [
      "https://example.com/happyhorse-output.mp4"
    ],
    "images": []
  },
  "createdAt": "2026-06-25T02:00:00.000Z",
  "updatedAt": "2026-06-25T02:01:00.000Z",
  "statusUpdateTime": "2026-06-25T02:01:00.000Z"
}
```

| Field              | Type      | Description                                        |
| ------------------ | --------- | -------------------------------------------------- |
| `id`               | string    | Public GENGEN task ID                              |
| `model`            | string    | `happyhorse-1.1`                                   |
| `status`           | string    | Normalized task status                             |
| `outputs.videos`   | string\[] | Generated video URLs after success                 |
| `outputs.images`   | string\[] | Reserved image outputs; empty for this video model |
| `createdAt`        | string    | ISO 8601 task creation time when available         |
| `updatedAt`        | string    | ISO 8601 latest update time when available         |
| `statusUpdateTime` | string    | ISO 8601 status transition time when available     |
| `failureReason`    | string    | Failure explanation when the task fails            |

Pending work normally reports `pending` or `processing`. Terminal states include `succeeded`,
`failed`, and `cancelled`.

<Note>
  Retrieve the task with the same GENGEN API key that created it. Another key in the same
  workspace cannot retrieve the task.
</Note>