List Documents

List all uploaded and processed documents with filtering by source, status, date range, and full-text search with pagination support.

Documents represent files that have been uploaded and processed. Each document retains its original file, extracted text, and metadata.

Use query parameters to filter by source connection, processing status, date range, or full-text search across filenames and extracted content. Results are paginated with cursor-based navigation.

Documents include triage metadata (sensitivity, department, jurisdiction, PII detection) when available. Triage is populated automatically during ingestion via Document AI annotations or Haiku LLM calls.

GET/v1/documents

Response

Response fields

dataarrayArray of document objects.

data[].idstringDocument UUID.

data[].filenamestringOriginal filename of the uploaded document.

data[].pagesintegerEstimated page count.

data[].size_bytesintegerFile size in bytes.

data[].mime_typestringMIME type of the original file.

data[].type_detectedstring | nullDocument type inferred during processing (e.g. invoice, contract).

data[].language_detectedstring | nullISO 639-1 language code detected during extraction.

data[].statusstringProcessing status: pending, processing, completed, error.

data[].errorstring | nullError message when status is error.

data[].sourceobjectSource information: id (source connection ID or null) and type (e.g. manual, google_drive).

data[].triageobject | nullTriage metadata: sensitivity, department, jurisdiction, pii_detected, pii_categories, regulated_data, confidentiality_marking.

data[].original_pathstring | nullOriginal file path if ingested via a connector.

data[].extraction_countintegerNumber of extractions performed on this document (0 or 1).

data[].latest_extraction_idstring | nullID of the most recent extraction, if any.

data[].created_atstringISO 8601 creation timestamp.

data[].linksobjectRelated resource URLs: self, extractions, dashboard.

pagination.totalintegerTotal number of documents matching the query.

pagination.limitintegerMaximum results per page.

pagination.has_morebooleanWhether more results exist beyond this page.

pagination.next_cursorstring | nullCursor to fetch the next page. Null if no more results.

Response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "filename": "invoice-0847.pdf",
      "pages": 2,
      "size_bytes": 184320,
      "mime_type": "application/pdf",
      "type_detected": "invoice",
      "language_detected": "en",
      "status": "completed",
      "error": null,
      "source": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "type": "manual"
      },
      "triage": {
        "sensitivity": "internal",
        "department": "finance",
        "jurisdiction": "EU",
        "pii_detected": false,
        "pii_categories": [],
        "regulated_data": false,
        "confidentiality_marking": null
      },
      "original_path": null,
      "extraction_count": 1,
      "latest_extraction_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "created_at": "2024-09-14T10:32:00.000Z",
      "links": {
        "self": "/v1/documents/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "extractions": "/v1/documents/a1b2c3d4-e5f6-7890-abcd-ef1234567890/extractions",
        "dashboard": "https://app.talonic.com/documents/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    }
  ],
  "pagination": {
    "total": 234,
    "limit": 20,
    "has_more": true,
    "next_cursor": "eyJpZCI6ImExYjJjM2Q0IiwiY3JlYXRlZEF0IjoiMjAyNC0wOS0xNFQxMDozMjowMFoifQ=="
  }
}

Errors

Error responses

401unauthorizedMissing or invalid API key.

429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Get Document

List Extractions