---
title: "Get Tdocs Batch"
method: POST
path: "/tdocs/batch"
tags: ["tdocs"]
---

# Get Tdocs Batch

`POST /tdocs/batch`

## Request

- Base URL: `https://api.3gppscout.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.3gppscout.com/tdocs/batch`
- Auth: none declared

Read up to 10 TDocs in one call, for example every TDoc a summary or search result names.

Each TDoc comes back as `GET /tdocs/{tdoc_id}` returns it (register metadata, sources with roles,
and with `include` its units, text and revision chain), in request order, each with a `status`:
`ok`, `not_indexed` (not in the catalog yet: call fetch_tdoc for it), `not_found`, `withdrawn`
(metadata in `tdoc`), `invalid_tdoc_id`, or `error`. One TDoc that cannot be read does not fail the
others. A TDoc in the catalog whose content was not parsed yet has `status` ok and
`content.status` `not_retrieved`: call fetch_tdoc for it.

Unit and text budgets are per TDoc. Without `max_unit_chars` and `max_text_chars`, 48,000 and
16,000 characters are shared across the TDocs; long unit lists are cut (`units_truncated`).

**Quota:** for REST and MCP this call counts as one request per TDoc (`requests_counted`), the same
as calling get_tdoc once per TDoc. If fewer requests remain than TDocs asked for, it fails with 402
before reading anything.

**Excerpt limit:** each TDoc carries at most 2,000 words of units and text, cut like get_tdoc;
`excerpt` and `official_url` say where to read the rest.

## Request body

- TdocsBatchRequest: Request body for reading several TDocs in one call.
  - `tdoc_ids` string[], required: 1 to 10 TDoc IDs, e.g. ['R1-2605951', 'R2-2604548'].
  - `include` string, nullable: Comma-separated extras for every TDoc, as for GET /tdocs/{tdoc_id}: units, text, revisions.
  - `max_unit_chars` integer, nullable: Character budget for each TDoc's unit quotes. Default 48,000 divided by the number of TDocs.
  - `max_text_chars` integer, nullable: Character budget for each TDoc's text blocks when include has 'text'. Default 16,000 divided by the number of TDocs.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/3gppscout/apis/3gpp-scout-api.md) · [All operations](https://skmtc.dev/3gppscout/apis/3gpp-scout-api/llms.txt) · [OpenAPI document](https://skmtc.dev/3gppscout/apis/3gpp-scout-api/revisions/60bd6896e5b9?raw)