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

# Get Batch

> Progress of a batch and its results, page by page.

Returns the batch counts and one page of its items, in submit order. Completed items carry a temporary `resultImageUrl`.

## Parameters

<ParamField path="batchId" type="string" required>
  From [Create Batch](/docs/tryon-api/endpoints/create-batch).
</ParamField>

<ParamField query="cursor" type="string">
  `nextCursor` of the previous page.
</ParamField>

<ParamField query="limit" type="number" default="100">
  Items per page, up to 500.
</ParamField>

## Status

| `status` | Meaning |
| - | - |
| `RUNNING` | Items are still queued or running. |
| `COMPLETED` | Every item is done. `chargedCredits` is set. |
| `CANCELLED` | You cancelled it; items that had not started failed with `BATCH_CANCELLED`. |
| `EXPIRED` | Some items did not run within 4 hours (`BATCH_EXPIRED`). |

<ResponseExample>
  ```json 200 theme={null}
  {
    "batchId": "c4b1s2...",
    "status": "COMPLETED",
    "itemCount": 2,
    "completedCount": 2,
    "failedCount": 0,
    "reservedCredits": 1,
    "chargedCredits": 1,
    "createdAt": "2026-10-07T09:00:00.000Z",
    "expiresAt": "2026-10-07T13:00:00.000Z",
    "items": [
      {
        "customId": "look-1",
        "generationId": "g1...",
        "status": "COMPLETED",
        "resultImageUrl": "https://storage.googleapis.com/..."
      },
      {
        "customId": "look-2",
        "generationId": "g2...",
        "status": "COMPLETED",
        "resultImageUrl": "https://storage.googleapis.com/..."
      }
    ],
    "nextCursor": null
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.