Sign in
Documents

Get extracted document data

Returns the document's classification, extracted fields, line items, and confidence scores. Available when the document status is ready. Returns 404 not_found while extraction is pending or processing. A failed document has no extraction.

get/documents/{documentId}/extraction

Request

  • Base URL: https://next-api.saturation.io/v1
  • URL: https://next-api.saturation.io/v1/documents/{documentId}/extraction
  • Auth: HTTP bearer

Path parameters

documentIdstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

Example:txn_8f2a1c9e

The document ID.

Response

The extracted document data.

documentIdstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

status'pending' | 'processing' | 'ready' | 'failed' required

The document's extraction status. ready means extracted data is available.

classificationstring nullable

The document classification, such as invoice or receipt.

coarseType'financial' | 'tax' | 'legal' | 'insurance' | 'production' | 'other'

The document category found during extraction.

extractedAtstring date-time nullable

When extraction finished, or null while unavailable.

fieldsobject required

Extracted values and confidence scores keyed by field name. Keys vary by classification.

Example response

{
  "documentId": "doc_4b1f0a7c",
  "status": "ready",
  "classification": "invoice",
  "coarseType": "financial",
  "extractedAt": "2026-05-28T14:03:40Z",
  "fields": {
    "invoiceNumber": {
      "value": "4471",
      "confidence": 0.98
    },
    "total": {
      "value": "1529.00",
      "confidence": 0.91
    }
  },
  "lineItems": [
    {
      "description": "Camera body rental - 3 days",
      "amount": {
        "amount": 75000,
        "currency": "USD"
      },
      "confidence": 0.86
    }
  ]
}

Changes

Changes to this operation have not been checked yet.