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

# BatchListItem

Metadata-only batch object. `results` is always `null` in list responses.

## Fields

| Field | Type | Required | Description |
| - | - | - | - |
| `completion_window` | [components.BatchListItemCompletionWindow](../components/batchlistitemcompletionwindow.mdx) | ✔️ | N/A |
| `created_at` | *int* | ✔️ | N/A |
| `endpoint` | *str* | ✔️ | N/A |
| `error` | [Nullable\[components.BatchListItemError\]](../components/batchlistitemerror.mdx) | ✔️ | N/A |
| `expires_at` | *Nullable\[int]* | ✔️ | Unix timestamp after which the assigned provider no longer completes unfinished requests. Derived from the provider's documented batch window, so it can exceed `created_at` plus `completion_window` (Google Vertex can take up to 96 hours). `null` when the provider documents no hard expiry. |
| `finalized_at` | *Nullable\[int]* | ✔️ | N/A |
| `id` | *str* | ✔️ | N/A |
| `model` | *str* | ✔️ | N/A |
| `object` | [components.BatchListItemObject](../components/batchlistitemobject.mdx) | ✔️ | N/A |
| `output` | [Optional\[components.BatchOutputReference\]](../components/batchoutputreference.mdx) | ➖ | The output location of a batch submitted with `input`, whose `results` are `null`. Returned only by `GET /batches/{id}`, once the batch has ended and the provider reported an output folder or table. Batch lists and responses for a batch with an unpaid charge leave it out. |
| `provider` | *Nullable\[str]* | ✔️ | Provider OpenRouter assigned to run the batch, using the same name as the `provider` field of sync responses. |
| `request_counts` | [components.BatchListItemRequestCounts](../components/batchlistitemrequestcounts.mdx) | ✔️ | N/A |
| `results` | *Nullable\[Any]* | ✔️ | Always null: retrieve the batch with `GET /batches/{id}` to access its results. |
| `status` | [components.BatchListItemStatus](../components/batchlistitemstatus.mdx) | ✔️ | N/A |
| `usage` | [Nullable\[components.BatchListItemUsage\]](../components/batchlistitemusage.mdx) | ✔️ | N/A |