batch_too_large (2002, HTTP 400) · TranscriptFetch API error

The batch exceeds your plan's per-request cap. error.details carries the cap and what was sent.

Number2002

HTTP status400Bad Request

Familyaccount2xxx · your account or plan

Example response

JSON

{
  "ok": false,
  "request_id": "req_…",
  "error": {
    "code": "batch_too_large",
    "number": 2002,
    "message": "The batch exceeds your plan's per-request cap. error.details carries the cap and what was sent.",
    "docs": "https://transcriptfetch.com/docs/errors/batch_too_large",
    "details": {
      "max": 50,
      "sent": 120
    }
  }
}

Every failure carries error.code, error.number, error.message and error.docs, plus at most one of retry_with (the request change that would succeed), details (structured specifics) or issues (validation problems).

What it means

The batch exceeds your plan's per-request cap. error.details carries the cap and what was sent.

Why it happens

More video ids than your plan allows in one batch call. error.details carries max (your cap) and sent.

What to do

Split the list into batches of at most details.max.
Upgrade for a larger cap: 50 on the free tier, Basic and Pro; 500 on Mega and Scale.

Retryable? Only with a smaller batch. Nothing was fetched or charged. Every error response carries a request_id; include it when contacting support.