> ## 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>",
  },
  finalizedAt: 579660,
  id: "<id>",
  model: "Durango",
  object: "batch",
  requestCounts: {
    completed: 311945,
    failed: 214442,
    total: 609620,
  },
  results: "<value>",
  status: "in_progress",
  usage: {
    completionTokens: 20018,
    promptTokens: 657059,
    totalTokens: 490076,
  },
};
```

## Fields

| Field | Type | Required | Description |
| - | - | - | - |
| `completionWindow` | [models.BatchListItemCompletionWindow](../models/batchlistitemcompletionwindow.mdx) | :heavy\_check\_mark: | N/A |
| `createdAt` | *number* | :heavy\_check\_mark: | N/A |
| `endpoint` | *string* | :heavy\_check\_mark: | N/A |
| `error` | [models.BatchListItemError](../models/batchlistitemerror.mdx) | :heavy\_check\_mark: | N/A |
| `finalizedAt` | *number* | :heavy\_check\_mark: | N/A |
| `id` | *string* | :heavy\_check\_mark: | N/A |
| `model` | *string* | :heavy\_check\_mark: | N/A |
| `object` | [models.BatchListItemObject](../models/batchlistitemobject.mdx) | :heavy\_check\_mark: | N/A |
| `requestCounts` | [models.BatchListItemRequestCounts](../models/batchlistitemrequestcounts.mdx) | :heavy\_check\_mark: | N/A |
| `results` | *any* | :heavy\_check\_mark: | Always null: retrieve the batch with `GET /batches/{id}` to access its results. |
| `status` | [models.BatchListItemStatus](../models/batchlistitemstatus.mdx) | :heavy\_check\_mark: | N/A |
| `usage` | [models.BatchListItemUsage](../models/batchlistitemusage.mdx) | :heavy\_check\_mark: | N/A |