---
title: "List Tdocs"
method: GET
path: "/tdocs"
tags: ["tdocs"]
---

# List Tdocs

`GET /tdocs`

## 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`
- Auth: none declared

List TDocs in the catalog by company, meeting, agenda item, kind, status, work item, spec, or title words.

Use this for "what did company X submit", "TDocs on agenda item 10.7 at RAN1#126", or "agreed CRs to
38.213". Company names resolve through aliases, so misspellings such as "Manevir" find Mavenir.
`source_resolution` shows how the name resolved. An ambiguous name returns 409
`organization_ambiguous` with candidates.

Each item has doc_kind, register status, meeting, agenda item, sources with roles, and official_url.
`coverage` names the meetings whose full registers were searched, so an empty result is a real
"nothing found in these meetings". This endpoint searches titles and metadata, not document text:
call get_tdoc with include=units for the content.

## Query parameters

- `source` string, nullable: Company name, alias, or org_id, e.g. 'Mavenir', 'Lekha Wireless', 'huawei'. Misspellings resolve through aliases.
- `role` string, nullable: Comma-separated source roles: submitter, co_submitter, editor. Default all roles; each item reports matched_role.
- `meeting` string, nullable: Comma-separated meeting IDs, e.g. 'R1-126' or 'RAN1#126'.
- `group` string, nullable: Comma-separated groups, e.g. 'R1', 'RAN2', 'S2'.
- `agenda_item` string, nullable: Agenda item; matches the item and its sub-items, e.g. '10.7' matches 10.7.1.
- `doc_kind` string, nullable: Comma-separated kinds: contribution, pcr, cr, draft_cr, summary, way_forward, ls_in, ls_out, report, chair_notes, agenda, wid, sid, status_report, work_plan, draft_spec.
- `status` string, nullable: Comma-separated register statuses, e.g. 'agreed,approved' or 'noted'.
- `work_item` string, nullable: Work item code, e.g. 'NR_NTN_Ph3-Core'.
- `spec` string, nullable: Target spec number, e.g. '38.213'.
- `since` string, nullable: Meetings starting on or after this date (YYYY-MM-DD).
- `until` string, nullable: Meetings starting on or before this date (YYYY-MM-DD).
- `q` string, nullable: Words that must all appear in the title or abstract, e.g. 'NTN timing advance'.
- `include_withdrawn` boolean: Include withdrawn TDocs.
- `limit` integer: Page size.
- `cursor` string, nullable: next_cursor from a previous response.

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