---
title: "List available documents"
method: GET
path: "/v1/documents"
tags: ["documents"]
---

# List available documents

`GET /v1/documents`

## Request

- Base URL: `https://mcp.techmanual.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.techmanual.ai/v1/documents`
- Auth: none declared

List all ingested manuals with metadata including page count and estimated token count. Supports case-insensitive substring filtering by model_number (within applicable_models), equipment_type, manufacturer, equipment_family, document_type, and title query. Pass featured=true to return only curated homepage showcase documents. By default only documents with visibility_status='live' are returned. Pass include_non_live=true with the admin key to see all documents.

## Query parameters

- `query` string, nullable
- `model_number` string, nullable
- `equipment_type` string, nullable
- `manufacturer` string, nullable
- `equipment_family` string, nullable
- `document_type` string, nullable
- `featured` boolean, nullable
- `include_non_live` boolean
- `limit` integer, nullable
- `offset` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- DocumentOut[]
  - `document_id` integer, required
  - `title` string, required
  - `document_type` string, nullable
  - `document_version` string, nullable
  - `manufacturer` string, nullable
  - `equipment_type` string, nullable
  - `equipment_family` 'test_and_measurement' | 'industrial_controls' | 'automotive' | 'rf_and_communications' | 'power_electronics' | 'ics_and_microcontrollers' | 'miscellaneous', nullable
  - `applicable_models` string[]
  - `page_count` integer, required
  - `estimated_token_count` integer, required
  - `ingestion_status` string, required
  - `visibility_status` string, nullable
  - `toc_start_page` integer, nullable
  - `toc_end_page` integer, nullable
  - `pdf_page_offset` integer, nullable
  - `featured` boolean
  - `enrichment_status` string, nullable
  - `vision_enrichment_status` VisionEnrichmentStatusOut: Per-document vision enrichment progress summary.
    - `total_pages` integer, required
    - `pages_enriched` integer, required
    - `pages_skipped` integer, required
    - `pages_pending` integer, required
    - `pages_failed` integer, required
  - `quarantine_reason` string, nullable
  - `created_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/techmanual/apis/techmanual-ai-api.md) · [All operations](https://skmtc.dev/techmanual/apis/techmanual-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/techmanual/apis/techmanual-ai-api/revisions/97e0fde41040?raw)