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

## Example Usage

```typescript theme={null}
import { BatchListItem } from "@openrouter/sdk/models";

let value: BatchListItem = {
  completionWindow: "24h",
  createdAt: 818782,
  endpoint: "<value>",
  error: {
    message: "<value>",
  },
  expiresAt: 579660,
  finalizedAt: 311945,
  id: "<id>",
  model: "CX-9",
  object: "batch",
  provider: "<value>",
  requestCounts: {
    completed: 792652,
    failed: 217575,
    total: 502267,
  },
  results: null,
  status: "expired",
  usage: {
    completionTokens: 601843,
    promptTokens: 355617,
    totalTokens: 566859,
  },
};
```

## Fields

| Field | Type | Required | Description |
| - | - | - | - |
| `completionWindow` | [models.BatchListItemCompletionWindow](../models/batchlistitemcompletionwindow.mdx) | ✔️ | N/A |
| `createdAt` | *number* | ✔️ | N/A |
| `endpoint` | *string* | ✔️ | N/A |
| `error` | [models.BatchListItemError](../models/batchlistitemerror.mdx) | ✔️ | N/A |
| `expiresAt` | *number* | ✔️ | 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. |
| `finalizedAt` | *number* | ✔️ | N/A |
| `id` | *string* | ✔️ | N/A |
| `model` | *string* | ✔️ | N/A |
| `object` | [models.BatchListItemObject](../models/batchlistitemobject.mdx) | ✔️ | N/A |
| `output` | [models.BatchOutputReference](../models/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` | *string* | ✔️ | Provider OpenRouter assigned to run the batch, using the same name as the `provider` field of sync responses. |
| `requestCounts` | [models.BatchListItemRequestCounts](../models/batchlistitemrequestcounts.mdx) | ✔️ | N/A |
| `results` | *any* | ✔️ | Always null: retrieve the batch with `GET /batches/{id}` to access its results. |
| `status` | [models.BatchListItemStatus](../models/batchlistitemstatus.mdx) | ✔️ | N/A |
| `usage` | [models.BatchListItemUsage](../models/batchlistitemusage.mdx) | ✔️ | N/A |