Get Extraction
Retrieve the full extraction result by ID including extracted data, per-field confidence scores, and document metadata.
GET
/v1/extractions/:idResponse
Response fields
idstringExtraction UUID.
statusstringExtraction status: complete, processing, failed.
documentobjectSource document summary: id, filename, pages, type_detected.
dataobjectExtracted field values as a key-value map.
confidenceobjectConfidence scores: overall (0–1) and fields (per-field score map).
locked_fieldsarrayField names that have been manually corrected and locked.
processingobjectProcessing metadata: duration_ms, pages_processed, region.
created_atstringISO 8601 creation timestamp.
linksobjectRelated resource URLs: self, data, document, dashboard.
Response
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "complete",
"document": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"filename": "invoice-0847.pdf",
"pages": 2,
"type_detected": "invoice"
},
"data": {
"vendor_name": "Acme Corp",
"invoice_number": "INV-2024-0847",
"total_amount": 14250.00,
"due_date": "2024-03-15"
},
"confidence": {
"overall": 0.94,
"fields": {
"vendor_name": 0.99,
"invoice_number": 0.98,
"total_amount": 0.96,
"due_date": 0.91
}
},
"locked_fields": [],
"processing": {
"duration_ms": 3420,
"pages_processed": 2,
"region": "eu-west"
},
"created_at": "2024-09-14T10:33:12.000Z",
"links": {
"self": "/v1/extractions/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"data": "/v1/extractions/a1b2c3d4-e5f6-7890-abcd-ef1234567890/data",
"document": "/v1/documents/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"dashboard": "https://app.talonic.com/documents/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}Errors
Error responses
401unauthorizedMissing or invalid API key.
404not_foundNo extraction with this ID exists for your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.