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

# BatchObject

## Example Usage

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

let value: BatchObject = {
  completionWindow: "24h",
  createdAt: 931790,
  endpoint: "<value>",
  error: {
    message: "<value>",
  },
  expiresAt: 113361,
  finalizedAt: 325090,
  id: "<id>",
  model: "El Camino",
  object: "batch",
  provider: "<value>",
  requestCounts: {
    completed: 393587,
    failed: 626049,
    total: 108649,
  },
  results: [],
  status: "cancelled",
  usage: {
    completionTokens: 401122,
    promptTokens: 291986,
    totalTokens: 319092,
  },
};
```

## Fields

| Field | Type | Required | Description |
| - | - | - | - |
| `completionWindow` | [models.BatchObjectCompletionWindow](../models/batchobjectcompletionwindow.mdx) | ✔️ | N/A |
| `createdAt` | *number* | ✔️ | N/A |
| `endpoint` | *string* | ✔️ | N/A |
| `error` | [models.BatchObjectError](../models/batchobjecterror.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.BatchObjectObjectBatch](../models/batchobjectobjectbatch.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.BatchObjectRequestCounts](../models/batchobjectrequestcounts.mdx) | ✔️ | N/A |
| `results` | [models.Result](../models/result.mdx)\[] | ✔️ | N/A |
| `status` | [models.BatchObjectStatus](../models/batchobjectstatus.mdx) | ✔️ | N/A |
| `usage` | [models.BatchObjectUsage](../models/batchobjectusage.mdx) | ✔️ | N/A |