---
title: "List inline batches"
method: GET
path: "/api/beta/batches"
tags: ["Batch"]
---

# List inline batches

`GET /api/beta/batches`

## Request

- Base URL: `https://api.nano-gpt.com`
- URL: `https://api.nano-gpt.com/api/beta/batches`
- Auth: HTTP bearer

Lists inline batches visible to the authenticated credential, newest first. The response is metadata-only: results is always null, including for completed batches. Use GET /api/beta/batches/{id} to retrieve completed inline results. Preserve the same filters on every paginated request.

## Query parameters

- `limit` integer
- `after` string
- `before` string
- `status` BatchStatus[]
- `created_after` union
  - integer
  - string
- `created_before` union
  - integer
  - string

## Response `200`

A page of inline batch metadata ordered newest first.

- InlineBatchList
  - `object` 'list', required
  - `data` InlineBatchListItem[], required: Inline batch metadata ordered newest first.
    - `id` string, required: Inline batch ID.
    - `object` 'batch', required
    - `endpoint` '/v1/chat/completions' | '/v1/responses', required
    - `model` string, required
    - `completion_window` '24h', required
    - `status` 'validating' | 'in_progress' | 'finalizing' | 'completed' | 'failed' | 'expired' | 'cancelling' | 'cancelled', required
    - `created_at` integer, required: Unix timestamp in seconds.
    - `finalized_at` integer, nullable: Unix timestamp in seconds, or null before finalization.
    - `request_counts` BatchRequestCounts, required
      - `total` integer, required
      - `completed` integer, required
      - `failed` integer, required
    - `usage` BatchUsage
      - `prompt_tokens` integer
      - `completion_tokens` integer
      - `total_tokens` integer
    - `results` unknown, required
    - `error` object, nullable
  - `first_id` string, nullable, required: First batch ID in this page, or null for an empty page. Pass as before to return to the adjacent newer page.
  - `last_id` string, nullable, required: Last batch ID in this page, or null for an empty page. Pass as after to fetch the next older page.
  - `has_more` boolean, required: Whether more records exist in the direction being paged.

## Other responses

- `400`: Invalid filters, timestamp range, or cursor.
- `401`: Missing or invalid authentication.

## Changes

- **2026-11-03** `cc8b07d75689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nano-gpt/apis/nanogpt-api/changes/api/beta/batches/get.md)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)