---
title: "Batch status and a page of results"
method: GET
path: "/batch"
---

# Batch status and a page of results

`GET /batch`

## Request

- Base URL: `https://getyoutubetranscript.com/api/v1`
- URL: `https://getyoutubetranscript.com/api/v1/batch`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Items come back in submission order. Succeeded items include the transcript (and 'segments' if the batch asked for timestamps); failed items carry an error_code such as TRANSCRIPT_DISABLED, VIDEO_UNAVAILABLE, LANGUAGE_NOT_AVAILABLE or PAYMENT_REQUIRED. Free.

## Query parameters

- `id` string, uuid, required
- `offset` integer
- `limit` integer

## Response `200`

Status plus items[offset, offset+limit). next_offset is null on the last page.

## Other responses

- `400`: Bad request - missing or invalid parameters.
- `401`: Missing or invalid API key.
- `404`: No batch with this id for this account.
- `429`: Rate limit exceeded for the key's plan tier (60/200/300 requests per minute on free/monthly/annual).

---

[API](https://skmtc.dev/getyoutubetranscript/apis/getyoutubetranscript-api.md) · [All operations](https://skmtc.dev/getyoutubetranscript/apis/getyoutubetranscript-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getyoutubetranscript/apis/getyoutubetranscript-api/revisions/9e125f131154?raw)