Skip to main content

Document Detail

Every document in Talonic has a detail page with four views: Raw Extraction, Resolved Data, Processing Log, and Original File. The detail page is where you inspect individual extraction results, verify field accuracy, and debug processing issues. It serves as the single source of truth for everything the platform knows about a document, from raw AI output to resolved canonical fields.

ParameterTypeDescription
Raw ExtractiontabEvery field the AI extracted, with confidence scores and source text.
Resolved DatatabFields mapped to the canonical registry with maturity indicators.
Processing LogtabTimeline of each processing stage with timing information.
Original FiletabView or download the source document.

The Raw Extraction tab is the most detailed view, showing every field the AI discovered along with its confidence score and the source text that the value was extracted from. Each field displays a maturity badge (Core, Proven, or Candidate) indicating how well-established that field is across your document corpus. Synthetic metadata fields like filename and source_file_path appear here too, with full confidence (1.0).

Classification Pills: Language, Region, and PII

The document header shows Language and Region as pills led by a flag. The language pill reads the detected ISO language code, and the region pill reads the jurisdiction as an upper-case ISO country code. An explicit region subtag wins over the language default, so a document detected as en-GB shows the British flag rather than the default one for English. When triage flagged personal data, a PII marker appears beside them. These signals come from the triage ingest stage, and routing rules and access rules can read the same values.

The Documents list uses the same facts in its Classification column. Each row reads the document type first, then the jurisdiction (for example DE), the language (for example de), and PII when the row is flagged. Sensitivity and department fold into a +N pill whose tooltip names them, so long classification strings do not push the column around. The Status column is a single coloured dot (green done, amber partial, pulsing purple processing, gray queued, red failed), and hovering it shows the legend with the row's status named.

The Resolved Data tab shows how raw extracted fields map to your canonical field registry. Fields that matched automatically (similarity >= 0.80) display their canonical name and cluster. Fields in the confirm band (0.50-0.79) are flagged for review. This view helps you understand how the platform is normalizing field names across different document types and formats.

The Processing Log tab provides a stage-by-stage timeline of how the document was processed, including per-stage timing. You can see exactly how long OCR, classification, and extraction took, which is useful for diagnosing slow processing or understanding why a document was classified a particular way. The Original File tab lets you view or download the source file, so you can always compare the AI's extraction against the original document.

When reviewing extraction quality, start with the Raw Extraction tab to check that the AI found all expected fields. Compare the confidence scores across fields — values above 0.90 are typically reliable, while values below 0.70 may warrant manual verification. If a field is missing, check the Original File tab to confirm the information exists in the source document. The Processing Log tab can reveal whether the document was split into chunks, which sometimes causes fields near chunk boundaries to be missed.

You can open the AI Agent (Cmd+I) from any document detail page. The agent automatically has the current document in scope and can answer questions about its fields, classification, or processing status without you needing to specify which document you mean.

Accessing Document Details via API

The document detail information visible in the UI is fully accessible through the REST API. You can retrieve a document's extraction results, download the OCR markdown, and inspect the processing metadata programmatically. This is particularly useful for building quality assurance workflows where you need to verify extraction results across hundreds of documents without clicking through each one manually.

Get a document's captured fields
curl https://api.talonic.com/v1/documents/doc_7f3a1b2c/fields \
  -H "Authorization: Bearer $TALONIC_API_KEY"
Response
{
  "document_id": "doc_7f3a1b2c",
  "data": [
    {
      "field_id": "fld_1a2b3c",
      "canonical_name": "invoice_number",
      "tier": 1,
      "value": "INV-2026-0472",
      "confidence": 0.98
    },
    {
      "field_id": "fld_4d5e6f",
      "canonical_name": "total_amount",
      "tier": 1,
      "value": "4,250.00",
      "confidence": 0.95
    }
  ]
}

The fields response includes every captured field bound into the Field Registry, one row per occurrence, with its canonical concept, maturity level (the numeric tier: 1 = Core, 2 = Proven, 3 = Candidate), value, and confidence score. Fields with confidence below 0.70 typically warrant manual review, while fields above 0.90 are highly reliable. You can use this data to build automated validation rules: for example, flagging documents where critical fields like invoice_number or total_amount have low confidence scores and routing them to a human reviewer.

The document detail page also provides access to the OCR-generated markdown through both the UI and the API. This markdown representation preserves the document's structure — headings, tables, lists, and paragraphs — in a machine-readable format. Comparing the markdown against the extracted fields is a useful debugging technique: if a field is missing from the extraction, check whether the value appears in the markdown. If it does, the extraction model may need a master instruction to guide it to the right location. If it does not, the OCR stage may have missed the content, which can happen with low-resolution scans or complex layouts.

Frequently asked questions

What tabs are available on the document detail page?+
Four tabs: Raw Extraction (AI-extracted fields with confidence), Resolved Data (canonical registry mapping), Processing Log (stage timeline), and Original File (view/download source).
How can I see the confidence score of an extracted field?+
Open the document detail page and navigate to the Raw Extraction tab. Each field displays its confidence score alongside the extracted value and source text.
What do the maturity badges on fields mean?+
Maturity badges indicate how well-established a field is across your document corpus. Core fields occur regularly across documents, Proven fields have been seen across multiple documents, and Candidate fields are newly discovered or rare.
What do the Language, Region, and PII pills show?+
They are the triage signals for the document. Language is the detected ISO language code, Region is the jurisdiction as an upper-case ISO country code with a flag, and PII appears when the document was flagged as containing personal data. The same values drive routing rules, access rules, and the triage tag filters on the Documents list.
Can I retrieve extraction results via the API?+
Yes. Use GET /v1/documents/:id/fields to retrieve every captured field for a document, including canonical names, values, confidence scores, and maturity (tier) information. GET /v1/documents/:id/extractions lists the document's extractions with per-field confidence, and GET /v1/documents/:id/markdown returns the OCR-generated markdown of the original document for comparison.
How do I debug a missing field in extraction results?+
Start by comparing the Raw Extraction tab against the Original File tab to confirm the field exists in the source document. Then check the OCR markdown (available via the Processing Log or the /v1/documents/:id/markdown API endpoint) to verify the OCR stage captured the relevant text. If the text is present in the markdown but the field is missing from extraction, a master instruction may be needed to guide the AI to the correct location. If the text is absent from the markdown, the OCR stage missed it — try re-uploading a higher-resolution version of the document.