Talonic API

Extract any document into schema-validated data with a single API call. The Talonic API provides programmatic access to the full extraction pipeline — from document upload through schema validation to structured data delivery with per-cell provenance.

Base URL

https://api.talonic.com

Protocol

HTTPS + JSON

Auth

Bearer tlnc_...

Quick start

Three calls. A schema, an ingest, a query. See authentication for API key setup and schema formats for all schema options.

curl -X POST https://api.talonic.com/v1/extract \
  -H "Authorization: Bearer tlnc_sk_live_7f3a...x9k2" \
  -F "file=@contract.pdf" \
  -F 'schema={"vendor_name":"string","total_amount":"number","due_date":"date"}'

Endpoints

Extract

The primary extraction endpoint — send any document and receive schema-validated structured data.

POST/v1/extractExtract a document

Documents

Manage uploaded documents — list, retrieve, re-extract, or download markdown representations.

GET/v1/documentsList documents GET/v1/documents/:idGet document DELETE/v1/documents/:idDelete document POST/v1/documents/:id/re-extractRe-extract GET/v1/documents/:id/markdownGet markdown

Extractions

Access extraction results — structured row data with per-cell provenance and confidence scores.

GET/v1/extractionsList extractions GET/v1/extractions/:idGet extraction GET/v1/extractions/:id/dataGet extraction data POST/v1/extractions/:id/correctCorrect fields

Schemas

Create and manage extraction schemas — define field names, types, and validation rules.

GET/v1/schemasList schemas POST/v1/schemasCreate schema GET/v1/schemas/:idGet schema PATCH/v1/schemas/:idUpdate schema DELETE/v1/schemas/:idDelete schema

Jobs

Track asynchronous extraction jobs — poll status or cancel in-progress work.

GET/v1/jobsList jobs GET/v1/jobs/:idGet job POST/v1/jobs/:id/cancelCancel job

Sources

Manage document sources — folders, integrations, and batch ingestion pipelines.

GET/v1/sourcesList sources POST/v1/sourcesCreate source GET/v1/sources/:idGet source PATCH/v1/sources/:idUpdate source DELETE/v1/sources/:idDelete source POST/v1/sources/:id/ingestIngest documents GET/v1/sources/:id/documentsList source documents

Search

Query structured data across extractions — filter, autocomplete, and materialize views.

GET/v1/search/autocompleteAutocomplete GET/v1/search/field-valuesField values POST/v1/search/filterFilter documents POST/v1/search/omnisearchOmnisearch GET/v1/search/saved-filtersSaved filters POST/v1/search/materializeMaterialize

Webhooks

Receive real-time notifications — HMAC-SHA256 signed event delivery with automatic retries.

GET/v1/webhooks/eventsEvent types GET/v1/webhooks/deliveryDelivery format GET/v1/webhooks/signaturesSignature verification GET/v1/webhooks/retriesRetry policy

Related

API key setup and Bearer token usage.

Inline JSON, schema_id, and auto-detect modes.

Error codes and troubleshooting.

Request limits by plan tier.

HMAC-SHA256 signed event delivery.