---
title: "Get an extraction"
method: GET
path: "/v1/extractions/{id}"
tags: ["Extractions"]
---

# Get an extraction

`GET /v1/extractions/{id}`

## Request

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

## Path parameters

- `id` string, uuid, required

## Response `200`

Full extraction with data and confidence scores.

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