---
title: "List extractions for a document"
method: GET
path: "/v1/documents/{id}/extractions"
tags: ["Documents"]
---

# List extractions for a document

`GET /v1/documents/{id}/extractions`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/documents/{id}/extractions`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

Extractions for the document.

- object
  - `data` ExtractionResponse[]
    - `id` string, uuid, required
    - `status` 'complete' | 'failed' | 'processing', required
    - `document` object, required
      - `id` string, uuid
      - `filename` string
      - `pages` integer
      - `type_detected` string, nullable
    - `data` object, required: Extracted key-value pairs.
    - `confidence` object, required
      - `overall` number, float
      - `fields` object
    - `locked_fields` string[]: Fields that have been manually corrected (locked at confidence 1.0).
    - `batch_id` string: The caller grouping key stamped on this document at ingestion (documents.client_batch_id) — e.g. from POST /v1/run or POST /v1/sources/:id/documents. Present only when set.
    - `metadata` object: The caller's flat metadata bag stamped on this document at ingestion (documents.client_metadata) — for a /v1/run input, its per-request EFFECTIVE merged bag (call-level metadata merged with any file_metadata entry). Present only when set.
    - `processing` object
      - `duration_ms` integer
      - `pages_processed` integer
      - `region` string
    - `created_at` string, date-time
    - `links` object
      - `self` string
      - `data` string
      - `document` string
      - `dashboard` string, uri

## Other responses

- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)