@talonic/docs 0.20.0 → 0.20.2

package/dist/seo.js

@@ -4,7 +4,7 @@ var openapi_default = {
   info: {
     title: "Talonic API",
     version: "1.0.0",
-    description: 'Structure any document into schema-validated data.\n\nThe Talonic API lets you extract structured data from documents (PDFs, images,\nDOCX, CSV, plain text), manage reusable extraction schemas, track async jobs,\nand organise documents through sources.\n\n## Quick Start\n\n**1. Get your API key**\n\nSign up at [app.talonic.com](https://app.talonic.com) \u2192 Settings \u2192 API Keys \u2192 Create key.\nKeys start with `tlnc_live_` (production) or `tlnc_test_` (sandbox).\nAll examples below use `tlnc_live_abc123` as a placeholder.\n\n**2. Extract your first document**\n\n```bash\ncurl -X POST https://api.talonic.com/v1/extract \\\n  -H "Authorization: Bearer tlnc_live_abc123" \\\n  -F "file=@invoice.pdf" \\\n  -F \'schema={"properties":{"vendor_name":{"type":"string"},"total_amount":{"type":"number"},"invoice_date":{"type":"string"}}}\'\n```\n\n**Python:**\n```python\nimport requests\nresp = requests.post("https://api.talonic.com/v1/extract",\n    headers={"Authorization": "Bearer tlnc_live_abc123"},\n    files={"file": open("invoice.pdf", "rb")},\n    data={"schema": \'{"properties":{"vendor_name":{"type":"string"},"total_amount":{"type":"number"},"invoice_date":{"type":"string"}}}\'})\nprint(resp.json()["data"])\n```\n\n**TypeScript:**\n```typescript\nconst form = new FormData();\nform.append("file", fs.createReadStream("invoice.pdf"));\nform.append("schema", \'{"properties":{"vendor_name":{"type":"string"},"total_amount":{"type":"number"},"invoice_date":{"type":"string"}}}\');\nconst res = await fetch("https://api.talonic.com/v1/extract", {\n  method: "POST",\n  headers: { Authorization: "Bearer tlnc_live_abc123" },\n  body: form,\n}).then(r => r.json());\nconsole.log(res.data);\n```\n\n**3. What you get back**\n\n```json\n{\n  "extraction_id": "d1a2b3c4-5678-9abc-def0-1234567890ab",\n  "request_id": "req_x7y8z9a0b1c2d3e4",\n  "status": "complete",\n  "document": {\n    "id": "f0e1d2c3-b4a5-9687-8765-432109876543",\n    "filename": "invoice.pdf",\n    "pages": 2,\n    "size_bytes": 184320,\n    "type_detected": "Invoice",\n    "language_detected": "en"\n  },\n  "data": {\n    "vendor_name": "Acme GmbH",\n    "total_amount": 14250.00,\n    "invoice_date": "2025-03-15"\n  },\n  "confidence": {\n    "overall": 0.96,\n    "fields": {\n      "vendor_name": 0.97,\n      "total_amount": 0.94,\n      "invoice_date": 0.99\n    }\n  },\n  "processing": {\n    "duration_ms": 1840,\n    "pages_processed": 2,\n    "region": "eu-west"\n  },\n  "links": {\n    "self": "/v1/extractions/d1a2b3c4-5678-9abc-def0-1234567890ab",\n    "document": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543"\n  }\n}\n```\n\n- **`data`** \u2014 extracted fields as key-value pairs matching your schema.\n- **`confidence.fields`** \u2014 per-field score from 0 to 1. Above 0.9 is high confidence; below 0.7 flags for review.\n- **`extraction_id`** \u2014 use this to retrieve, correct, or deliver results later.\n- Full response schema: [ExtractSyncResponse](#/components/schemas/ExtractSyncResponse)\n\n**4. Next steps**\n\n- **50+ pages?** Use async mode \u2014 see [Async Extraction Flow](#section/Async-Extraction-Flow) below.\n- **Reusable schemas** \u2014 save field definitions with `POST /v1/schemas`, then pass `schema_id` on future extractions.\n- **Receive results via webhook** \u2014 configure a delivery destination and listen for `document.extracted` events. See the [Delivery](#tag/Delivery) tag.\n\n---\n\n## Authentication\n\nAll requests require a Bearer token in the `Authorization` header.\nAPI keys are prefixed with `tlnc_` and scoped per customer.\n\n```\nAuthorization: Bearer tlnc_live_abc123...\n```\n\n## Async Extraction Pattern\n\nSmall documents (\u22645 pages) are processed synchronously and return a `200`\nwith the extracted data immediately. Larger documents return a `202 Accepted`\nwith a `poll_url` \u2014 poll `GET /v1/documents/{id}` until `status` transitions\nto `completed`, then fetch results via `GET /v1/documents/{id}/extractions`.\n\nYou can force async processing by passing `options: {"async": true}` on\nany extraction request. Combine with webhooks for a fully event-driven flow:\nconfigure a webhook destination under Delivery and listen for the\n`extraction.complete` event.\n\n**Job status lifecycle:** `pending` \u2192 `processing` \u2192 `complete` | `failed`\n\n## Rate Limits\n\nRequests are metered per calendar day (UTC). Limits depend on your plan tier:\n\n| Tier       | Extract | Platform | Ingest |\n|------------|---------|----------|--------|\n| Free       | 50/day  | 500/day  | 50/day |\n| Pro        | 2,000   | 10,000   | 2,000  |\n| Enterprise | Unlimited | Unlimited | Unlimited |\n\nEvery response includes rate-limit headers:\n- `X-RateLimit-Limit` \u2014 daily cap for the namespace\n- `X-RateLimit-Remaining` \u2014 requests left today\n- `X-RateLimit-Reset` \u2014 ISO 8601 timestamp when the window resets (midnight UTC)\n\n## Pagination\n\nList endpoints use cursor-based pagination. Pass `limit` (1\u2013100, default 20),\n`cursor` (opaque token from `pagination.next_cursor`), and `order` (`asc` or `desc`, default `desc`).\n\n## Errors\n\nAll errors return a JSON body with `error` (machine-readable code) and `message`\n(human-readable explanation). Additional fields vary by error type.\n\n| Code | Error              | Description                              |\n|------|--------------------|------------------------------------------|\n| 400  | validation_error   | Request body is malformed or invalid     |\n| 401  | unauthorized       | Missing or invalid API key               |\n| 403  | insufficient_scope | API key lacks the required scope         |\n| 404  | not_found          | Resource does not exist                  |\n| 409  | conflict           | Resource state conflict                  |\n| 413  | payload_too_large  | File exceeds 500 MB limit                |\n| 422  | extraction_failed  | Document could not be processed          |\n| 429  | rate_limit_exceeded| Daily rate limit reached                 |\n| 500  | internal_error     | Unexpected server error (retryable)      |\n\nEvery error response follows this envelope:\n\n```json\n{\n  "statusCode": 400,\n  "code": "VALIDATION_ERROR",\n  "error": "Bad Request",\n  "message": "name is required.",\n  "retryable": false,\n  "timestamp": "2026-04-25T14:30:00.000Z",\n  "path": "/v1/schemas"\n}\n```\n\nThe `code` field is one of: `VALIDATION_ERROR`, `AUTH_REQUIRED`, `TOKEN_EXPIRED`,\n`INSUFFICIENT_PERMISSIONS`, `RESOURCE_NOT_FOUND`, `QUOTA_EXCEEDED`,\n`INSUFFICIENT_CREDITS`, `LLM_RATE_LIMITED`, `LLM_TIMEOUT`, `LLM_UNAVAILABLE`,\n`OCR_FAILED`, `EXTRACTION_FAILED`, `EXTRACTION_TIMEOUT`, `FILE_TOO_LARGE`,\n`DUPLICATE_RESOURCE`, `DATASPACE_RUN_FAILED`, `INTERNAL_ERROR`.\n\n## Async Extraction Flow\n\nDocuments \u22645 pages return results synchronously (`200`). Larger documents\n\u2014 or any request with `options: {"async": true}` \u2014 return `202 Accepted`.\n\n**1. Submit extraction:**\n\n```bash\ncurl -X POST https://api.talonic.com/v1/extract \\\n  -H "Authorization: Bearer tlnc_live_abc123" \\\n  -F "file=@contract.pdf" \\\n  -F \'options={"async": true}\'\n```\n\nResponse `202`:\n```json\n{\n  "request_id": "req_x7y8z9a0",\n  "status": "processing",\n  "document": { "id": "f0e1d2c3-b4a5-9687-8765-432109876543" },\n  "poll_url": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543"\n}\n```\n\n**2. Poll until complete:**\n\n```bash\ncurl https://api.talonic.com/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543 \\\n  -H "Authorization: Bearer tlnc_live_abc123"\n```\n\nWhile processing: `{ "status": "processing" }`\nWhen done: `{ "status": "completed" }`\n\n**3. Retrieve results:**\n\n```bash\ncurl https://api.talonic.com/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543/extractions \\\n  -H "Authorization: Bearer tlnc_live_abc123"\n```\n\n**Python \u2014 complete async flow with exponential backoff:**\n\n```python\nimport time\nimport requests\n\nAPI_KEY = "tlnc_live_..."\nBASE = "https://api.talonic.com/v1"\nHEADERS = {"Authorization": f"Bearer {API_KEY}"}\n\n# Step 1: Submit async extraction\nresp = requests.post(f"{BASE}/extract",\n    headers=HEADERS,\n    files={"file": open("contract.pdf", "rb")},\n    data={"options": \'{"async": true}\'})\ndoc_id = resp.json()["document"]["id"]\n\n# Step 2: Poll with exponential backoff (2s \u2192 4s \u2192 8s \u2192 16s \u2192 30s cap)\ndelay = 2\nfor _ in range(20):\n    time.sleep(delay)\n    doc = requests.get(f"{BASE}/documents/{doc_id}", headers=HEADERS).json()\n    if doc["status"] == "completed":\n        break\n    if doc["status"] == "error":\n        raise Exception(f"Extraction failed: {doc.get(\'error\')}")\n    delay = min(delay * 2, 30)\n\n# Step 3: Retrieve extracted data\nextractions = requests.get(\n    f"{BASE}/documents/{doc_id}/extractions", headers=HEADERS).json()\ndata = extractions["data"][0]["data"]\nconfidence = extractions["data"][0]["confidence"]["overall"]\nprint(f"Extracted {len(data)} fields (confidence: {confidence})")\nprint(data)\n# \u2192 {"vendor_name": "Acme Corp", "total_amount": 1250.00, ...}\n```\n\n**TypeScript \u2014 same flow:**\n\n```typescript\nconst API_KEY = "tlnc_live_...";\nconst BASE = "https://api.talonic.com/v1";\nconst headers = { Authorization: `Bearer ${API_KEY}` };\n\n// Step 1: Submit async extraction\nconst form = new FormData();\nform.append("file", fs.createReadStream("contract.pdf"));\nform.append("options", \'{"async": true}\');\nconst { document } = await fetch(`${BASE}/extract`, {\n  method: "POST", headers, body: form,\n}).then((r) => r.json());\n\n// Step 2: Poll with exponential backoff\nlet delay = 2000;\nlet doc: any;\nfor (let i = 0; i < 20; i++) {\n  await new Promise((r) => setTimeout(r, delay));\n  doc = await fetch(`${BASE}/documents/${document.id}`, { headers }).then((r) => r.json());\n  if (doc.status === "completed") break;\n  if (doc.status === "error") throw new Error(`Extraction failed: ${doc.error}`);\n  delay = Math.min(delay * 2, 30_000);\n}\n\n// Step 3: Retrieve extracted data\nconst { data: extractions } = await fetch(\n  `${BASE}/documents/${document.id}/extractions`, { headers }\n).then((r) => r.json());\nconsole.log(extractions[0].data);\n// \u2192 { vendor_name: "Acme Corp", total_amount: 1250.00, ... }\n```\n\nRecommended polling: 2s initial, exponential backoff (2\u21924\u21928\u219216\u219230s cap),\ntimeout after 5 minutes.\n\n**Alternative \u2014 Webhooks:** Configure a delivery destination and listen for\n`document.extracted` events. See the Delivery tag.\n\n**Job status state machine:**\n`pending` \u2192 `queued` \u2192 `processing` \u2192 `complete` | `failed`\n\n## Performance\n\n| Document size | Expected latency | Max timeout |\n|---------------|------------------|-------------|\n| 1\u20135 pages     | Sync, <3s        | 30s         |\n| 6\u201350 pages    | <30s average     | 5 min       |\n| 50+ pages     | <5 min average   | 30 min      |\n\n**Uptime SLA:** 99.5% (Build), 99.9% (Scale), custom (Enterprise).\n\n**Max file size:** 500 MB. JSON request bodies (schemas, jobs): 1 MB.\n\n**Idempotency:** Pass `Idempotency-Key` header on POST requests. Keys are\nvalid for 24 hours and scoped per API key. Duplicates return the cached\nresponse with `cached: true`.\n',
+    description: 'Structure any document into schema-validated data.\n\nThe Talonic API lets you extract structured data from documents (PDFs, images,\nDOCX, CSV, plain text), manage reusable extraction schemas, track async jobs,\nand organise documents through sources.\n\n## Quick Start\n\n**1. Get your API key**\n\nSign up at [app.talonic.com](https://app.talonic.com) \u2192 Settings \u2192 API Keys \u2192 Create key.\nKeys start with `tlnc_live_` (production) or `tlnc_test_` (sandbox).\nAll examples below use `tlnc_live_abc123` as a placeholder.\n\n**2. Extract your first document**\n\n```bash\ncurl -X POST https://api.talonic.com/v1/extract \\\n  -H "Authorization: Bearer tlnc_live_abc123" \\\n  -F "file=@invoice.pdf" \\\n  -F \'schema={"properties":{"vendor_name":{"type":"string"},"total_amount":{"type":"number"},"invoice_date":{"type":"string"}}}\'\n```\n\n**Python:**\n```python\nimport requests\nresp = requests.post("https://api.talonic.com/v1/extract",\n    headers={"Authorization": "Bearer tlnc_live_abc123"},\n    files={"file": open("invoice.pdf", "rb")},\n    data={"schema": \'{"properties":{"vendor_name":{"type":"string"},"total_amount":{"type":"number"},"invoice_date":{"type":"string"}}}\'})\nprint(resp.json()["data"])\n```\n\n**TypeScript:**\n```typescript\nconst form = new FormData();\nform.append("file", fs.createReadStream("invoice.pdf"));\nform.append("schema", \'{"properties":{"vendor_name":{"type":"string"},"total_amount":{"type":"number"},"invoice_date":{"type":"string"}}}\');\nconst res = await fetch("https://api.talonic.com/v1/extract", {\n  method: "POST",\n  headers: { Authorization: "Bearer tlnc_live_abc123" },\n  body: form,\n}).then(r => r.json());\nconsole.log(res.data);\n```\n\n**3. What you get back**\n\n```json\n{\n  "extraction_id": "d1a2b3c4-5678-9abc-def0-1234567890ab",\n  "request_id": "req_x7y8z9a0b1c2d3e4",\n  "status": "complete",\n  "document": {\n    "id": "f0e1d2c3-b4a5-9687-8765-432109876543",\n    "filename": "invoice.pdf",\n    "pages": 2,\n    "size_bytes": 184320,\n    "type_detected": "Invoice",\n    "language_detected": "en"\n  },\n  "data": {\n    "vendor_name": "Acme GmbH",\n    "total_amount": 14250.00,\n    "invoice_date": "2025-03-15"\n  },\n  "confidence": {\n    "overall": 0.96,\n    "fields": {\n      "vendor_name": 0.97,\n      "total_amount": 0.94,\n      "invoice_date": 0.99\n    }\n  },\n  "processing": {\n    "duration_ms": 1840,\n    "pages_processed": 2,\n    "region": "eu-west"\n  },\n  "links": {\n    "self": "/v1/extractions/d1a2b3c4-5678-9abc-def0-1234567890ab",\n    "document": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543"\n  }\n}\n```\n\n- **`data`** \u2014 extracted fields as key-value pairs matching your schema.\n- **`confidence.fields`** \u2014 per-field score from 0 to 1. Above 0.9 is high confidence; below 0.7 flags for review.\n- **`extraction_id`** \u2014 use this to retrieve, correct, or deliver results later.\n- Full response schema: [ExtractSyncResponse](#/components/schemas/ExtractSyncResponse)\n\n**4. Next steps**\n\n- **50+ pages?** Use async mode \u2014 see [Async Extraction Flow](#section/Async-Extraction-Flow) below.\n- **Reusable schemas** \u2014 save field definitions with `POST /v1/schemas`, then pass `schema_id` on future extractions.\n- **Receive results via webhook** \u2014 configure a delivery destination and listen for `document.extracted` events. See the [Delivery](#tag/Delivery) tag.\n\n---\n\n## Authentication\n\nAll requests require a Bearer token in the `Authorization` header.\nAPI keys are prefixed with `tlnc_` and scoped per customer.\n\n```\nAuthorization: Bearer tlnc_live_abc123...\n```\n\n## Async Extraction Pattern\n\nSmall documents (\u22645 pages) are processed synchronously and return a `200`\nwith the extracted data immediately. Larger documents return a `202 Accepted`\nwith a `poll_url` \u2014 poll `GET /v1/documents/{id}` until `status` transitions\nto `completed`, then fetch results via `GET /v1/documents/{id}/extractions`.\n\nYou can force async processing by passing `options: {"async": true}` on\nany extraction request. Combine with webhooks for a fully event-driven flow:\nconfigure a webhook destination under Delivery and listen for the\n`extraction.complete` event.\n\n**Job status lifecycle:** `pending` \u2192 `processing` \u2192 `complete` | `failed`\n\n## Rate Limits\n\nRequests are metered per calendar day (UTC). Limits depend on your plan tier:\n\n| Tier       | Extract | Platform | Ingest |\n|------------|---------|----------|--------|\n| Free       | 50/day  | 500/day  | 50/day |\n| Pro        | 2,000   | 10,000   | 2,000  |\n| Enterprise | Unlimited | Unlimited | Unlimited |\n\nEvery response includes rate-limit headers:\n- `X-RateLimit-Limit` \u2014 daily cap for the namespace\n- `X-RateLimit-Remaining` \u2014 requests left today\n- `X-RateLimit-Reset` \u2014 ISO 8601 timestamp when the window resets (midnight UTC)\n\n## Pagination\n\nList endpoints use cursor-based pagination. Pass `limit` (1\u2013100, default 20),\n`cursor` (opaque token from `pagination.next_cursor`), and `order` (`asc` or `desc`, default `desc`).\n\n## Errors\n\nAll errors return a JSON body with `error` (machine-readable code) and `message`\n(human-readable explanation). Additional fields vary by error type.\n\n| Code | Error              | Description                              |\n|------|--------------------|------------------------------------------|\n| 400  | validation_error   | Request body is malformed or invalid     |\n| 401  | unauthorized       | Missing or invalid API key               |\n| 403  | insufficient_scope | API key lacks the required scope         |\n| 404  | not_found          | Resource does not exist                  |\n| 409  | conflict           | Resource state conflict                  |\n| 413  | payload_too_large  | File exceeds 500 MB limit                |\n| 422  | extraction_failed  | Document could not be processed          |\n| 429  | rate_limit_exceeded| Daily rate limit reached                 |\n| 500  | internal_error     | Unexpected server error (retryable)      |\n\nEvery error response follows this envelope:\n\n```json\n{\n  "statusCode": 400,\n  "code": "VALIDATION_ERROR",\n  "error": "Bad Request",\n  "message": "name is required.",\n  "retryable": false,\n  "timestamp": "2026-04-25T14:30:00.000Z",\n  "path": "/v1/schemas"\n}\n```\n\nThe `code` field is one of: `VALIDATION_ERROR`, `AUTH_REQUIRED`, `TOKEN_EXPIRED`,\n`INSUFFICIENT_PERMISSIONS`, `RESOURCE_NOT_FOUND`, `QUOTA_EXCEEDED`,\n`INSUFFICIENT_CREDITS`, `LLM_RATE_LIMITED`, `LLM_TIMEOUT`, `LLM_UNAVAILABLE`,\n`OCR_FAILED`, `EXTRACTION_FAILED`, `EXTRACTION_TIMEOUT`, `FILE_TOO_LARGE`,\n`DUPLICATE_RESOURCE`, `DATASPACE_RUN_FAILED`, `INTERNAL_ERROR`.\n\n## Async Extraction Flow\n\nDocuments \u22645 pages return results synchronously (`200`). Larger documents\n\u2014 or any request with `options: {"async": true}` \u2014 return `202 Accepted`.\n\n**1. Submit extraction:**\n\n```bash\ncurl -X POST https://api.talonic.com/v1/extract \\\n  -H "Authorization: Bearer tlnc_live_abc123" \\\n  -F "file=@contract.pdf" \\\n  -F \'options={"async": true}\'\n```\n\nResponse `202`:\n```json\n{\n  "request_id": "req_x7y8z9a0",\n  "status": "processing",\n  "document": { "id": "f0e1d2c3-b4a5-9687-8765-432109876543" },\n  "poll_url": "/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543"\n}\n```\n\n**2. Poll until complete:**\n\n```bash\ncurl https://api.talonic.com/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543 \\\n  -H "Authorization: Bearer tlnc_live_abc123"\n```\n\nWhile processing: `{ "status": "processing" }`\nWhen done: `{ "status": "completed" }`\n\n**3. Retrieve results:**\n\n```bash\ncurl https://api.talonic.com/v1/documents/f0e1d2c3-b4a5-9687-8765-432109876543/extractions \\\n  -H "Authorization: Bearer tlnc_live_abc123"\n```\n\n**Python \u2014 complete async flow with exponential backoff:**\n\n```python\nimport time\nimport requests\n\nAPI_KEY = "tlnc_live_..."\nBASE = "https://api.talonic.com/v1"\nHEADERS = {"Authorization": f"Bearer {API_KEY}"}\n\n# Step 1: Submit async extraction\nresp = requests.post(f"{BASE}/extract",\n    headers=HEADERS,\n    files={"file": open("contract.pdf", "rb")},\n    data={"options": \'{"async": true}\'})\ndoc_id = resp.json()["document"]["id"]\n\n# Step 2: Poll with exponential backoff (2s \u2192 4s \u2192 8s \u2192 16s \u2192 30s cap)\ndelay = 2\nfor _ in range(20):\n    time.sleep(delay)\n    doc = requests.get(f"{BASE}/documents/{doc_id}", headers=HEADERS).json()\n    if doc["status"] == "completed":\n        break\n    if doc["status"] == "error":\n        raise Exception(f"Extraction failed: {doc.get(\'error\')}")\n    delay = min(delay * 2, 30)\n\n# Step 3: Retrieve extracted data\nextractions = requests.get(\n    f"{BASE}/documents/{doc_id}/extractions", headers=HEADERS).json()\ndata = extractions["data"][0]["data"]\nconfidence = extractions["data"][0]["confidence"]["overall"]\nprint(f"Extracted {len(data)} fields (confidence: {confidence})")\nprint(data)\n# \u2192 {"vendor_name": "Acme Corp", "total_amount": 1250.00, ...}\n```\n\n**TypeScript \u2014 same flow:**\n\n```typescript\nconst API_KEY = "tlnc_live_...";\nconst BASE = "https://api.talonic.com/v1";\nconst headers = { Authorization: `Bearer ${API_KEY}` };\n\n// Step 1: Submit async extraction\nconst form = new FormData();\nform.append("file", fs.createReadStream("contract.pdf"));\nform.append("options", \'{"async": true}\');\nconst { document } = await fetch(`${BASE}/extract`, {\n  method: "POST", headers, body: form,\n}).then((r) => r.json());\n\n// Step 2: Poll with exponential backoff\nlet delay = 2000;\nlet doc: any;\nfor (let i = 0; i < 20; i++) {\n  await new Promise((r) => setTimeout(r, delay));\n  doc = await fetch(`${BASE}/documents/${document.id}`, { headers }).then((r) => r.json());\n  if (doc.status === "completed") break;\n  if (doc.status === "error") throw new Error(`Extraction failed: ${doc.error}`);\n  delay = Math.min(delay * 2, 30_000);\n}\n\n// Step 3: Retrieve extracted data\nconst { data: extractions } = await fetch(\n  `${BASE}/documents/${document.id}/extractions`, { headers }\n).then((r) => r.json());\nconsole.log(extractions[0].data);\n// \u2192 { vendor_name: "Acme Corp", total_amount: 1250.00, ... }\n```\n\nRecommended polling: 2s initial, exponential backoff (2\u21924\u21928\u219216\u219230s cap),\ntimeout after 5 minutes.\n\n**Alternative \u2014 Webhooks:** Configure a delivery destination and listen for\n`document.extracted` events. See the Delivery tag.\n\n**Job status state machine:**\n`pending` \u2192 `queued` \u2192 `processing` \u2192 `complete` | `failed`\n\n## Performance\n\n| Document size | Expected latency | Max timeout |\n|---------------|------------------|-------------|\n| 1\u20135 pages     | Sync, <3s        | 30s         |\n| 6\u201350 pages    | <30s average     | 5 min       |\n| 50+ pages     | <5 min average   | 30 min      |\n\n**Uptime SLA:** 99.5% (Pro), custom (Enterprise).\n\n**Max file size:** 500 MB. JSON request bodies (schemas, jobs): 1 MB.\n\n**Idempotency:** Pass `Idempotency-Key` header on POST requests. Keys are\nvalid for 24 hours and scoped per API key. Duplicates return the cached\nresponse with `cached: true`.\n',
     contact: {
       name: "Talonic Support",
       email: "support@talonic.ai",
@@ -10477,6 +10477,481 @@ var openapi_default = {
           }
         }
       }
+    },
+    "/v1/registry/query": {
+      post: {
+        operationId: "registryQuery",
+        summary: "Query extracted field values across documents",
+        description: "Search previously-extracted field values across all documents without re-extraction. Zero AI calls. Filter by field values and select which fields to return. Max 500 rows.",
+        tags: [
+          "Platform"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                required: [
+                  "where"
+                ],
+                properties: {
+                  where: {
+                    type: "object",
+                    description: "Field-value conditions. Keys are field names, values are expected values. All conditions are ANDed.",
+                    additionalProperties: {
+                      type: "string"
+                    }
+                  },
+                  select: {
+                    type: "array",
+                    items: {
+                      type: "string"
+                    },
+                    description: "Field names to return in results. If omitted, returns all fields referenced in where."
+                  },
+                  limit: {
+                    type: "integer",
+                    default: 100,
+                    maximum: 500,
+                    description: "Maximum rows to return (default 100, max 500)."
+                  }
+                }
+              },
+              example: {
+                where: {
+                  vendor_name: "Meridian Energy AG",
+                  contract_year: "2026"
+                },
+                select: [
+                  "contract_value",
+                  "auto_renew",
+                  "notice_period_days"
+                ],
+                limit: 50
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Matching documents with their field values.",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    data: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          document_id: {
+                            type: "string",
+                            format: "uuid"
+                          },
+                          filename: {
+                            type: "string"
+                          },
+                          document_type: {
+                            type: "string",
+                            nullable: true
+                          }
+                        },
+                        additionalProperties: {
+                          type: "string"
+                        }
+                      }
+                    },
+                    total: {
+                      type: "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            description: "Missing where or unknown field name."
+          },
+          "401": {
+            description: "Missing or invalid API key."
+          },
+          "429": {
+            description: "Rate limit exceeded."
+          }
+        }
+      }
+    },
+    "/v1/saved-filters": {
+      get: {
+        operationId: "listSavedFilters",
+        summary: "List saved filters",
+        description: "Returns all saved filter configurations, optionally scoped to a source.",
+        tags: [
+          "Documents"
+        ],
+        parameters: [
+          {
+            name: "sourceId",
+            in: "query",
+            schema: {
+              type: "string"
+            },
+            description: "Filter by source connection."
+          }
+        ],
+        responses: {
+          "200": {
+            description: "List of saved filters.",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    data: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          id: {
+                            type: "string",
+                            format: "uuid"
+                          },
+                          name: {
+                            type: "string"
+                          },
+                          conditions: {
+                            type: "array",
+                            items: {
+                              type: "object"
+                            }
+                          },
+                          search: {
+                            type: "string",
+                            nullable: true
+                          },
+                          sort: {
+                            type: "object",
+                            nullable: true
+                          },
+                          source_connection_id: {
+                            type: "string",
+                            nullable: true
+                          },
+                          created_at: {
+                            type: "string",
+                            format: "date-time"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      post: {
+        operationId: "createSavedFilter",
+        summary: "Create a saved filter",
+        description: "Persist a filter configuration for reuse.",
+        tags: [
+          "Documents"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                required: [
+                  "name",
+                  "conditions"
+                ],
+                properties: {
+                  name: {
+                    type: "string",
+                    description: "Display name for the saved filter."
+                  },
+                  conditions: {
+                    type: "array",
+                    items: {
+                      type: "object"
+                    },
+                    description: "Array of filter conditions."
+                  },
+                  search: {
+                    type: "string",
+                    description: "Optional free-text search."
+                  },
+                  sort: {
+                    type: "object",
+                    description: "Optional sort configuration."
+                  },
+                  source_connection_id: {
+                    type: "string",
+                    description: "Scope to a specific source."
+                  }
+                }
+              }
+            }
+          }
+        },
+        responses: {
+          "201": {
+            description: "Saved filter created."
+          },
+          "401": {
+            description: "Missing or invalid API key."
+          }
+        }
+      }
+    },
+    "/v1/saved-filters/{id}": {
+      delete: {
+        operationId: "deleteSavedFilter",
+        summary: "Delete a saved filter",
+        tags: [
+          "Documents"
+        ],
+        parameters: [
+          {
+            name: "id",
+            in: "path",
+            required: true,
+            schema: {
+              type: "string",
+              format: "uuid"
+            }
+          }
+        ],
+        responses: {
+          "200": {
+            description: "Filter deleted."
+          },
+          "404": {
+            description: "Saved filter not found."
+          }
+        }
+      }
+    },
+    "/v1/webhooks": {
+      get: {
+        operationId: "listWebhooks",
+        summary: "List webhook configurations",
+        description: "Returns all webhook configurations for the customer.",
+        tags: [
+          "Delivery"
+        ],
+        responses: {
+          "200": {
+            description: "List of webhook configurations.",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    data: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          id: {
+                            type: "string",
+                            format: "uuid"
+                          },
+                          url: {
+                            type: "string",
+                            format: "uri"
+                          },
+                          events: {
+                            type: "array",
+                            items: {
+                              type: "string"
+                            }
+                          },
+                          source_id: {
+                            type: "string",
+                            nullable: true
+                          },
+                          active: {
+                            type: "boolean"
+                          },
+                          created_at: {
+                            type: "string",
+                            format: "date-time"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      post: {
+        operationId: "createWebhook",
+        summary: "Create a webhook configuration",
+        description: "Configure a new webhook endpoint to receive event notifications.",
+        tags: [
+          "Delivery"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                required: [
+                  "url",
+                  "events"
+                ],
+                properties: {
+                  url: {
+                    type: "string",
+                    format: "uri",
+                    description: "HTTPS endpoint URL."
+                  },
+                  events: {
+                    type: "array",
+                    items: {
+                      type: "string"
+                    },
+                    description: "Event types to subscribe to."
+                  },
+                  source_id: {
+                    type: "string",
+                    description: "Scope to a specific source (optional)."
+                  },
+                  secret: {
+                    type: "string",
+                    description: "Signing secret. Auto-generated if omitted."
+                  }
+                }
+              }
+            }
+          }
+        },
+        responses: {
+          "201": {
+            description: "Webhook created. Returns the webhook config including the signing secret."
+          },
+          "400": {
+            description: "Invalid URL or event types."
+          },
+          "401": {
+            description: "Missing or invalid API key."
+          }
+        }
+      }
+    },
+    "/v1/webhooks/{id}": {
+      get: {
+        operationId: "getWebhook",
+        summary: "Get webhook configuration",
+        tags: [
+          "Delivery"
+        ],
+        parameters: [
+          {
+            name: "id",
+            in: "path",
+            required: true,
+            schema: {
+              type: "string",
+              format: "uuid"
+            }
+          }
+        ],
+        responses: {
+          "200": {
+            description: "Webhook configuration."
+          },
+          "404": {
+            description: "Webhook not found."
+          }
+        }
+      },
+      patch: {
+        operationId: "updateWebhook",
+        summary: "Update webhook configuration",
+        tags: [
+          "Delivery"
+        ],
+        parameters: [
+          {
+            name: "id",
+            in: "path",
+            required: true,
+            schema: {
+              type: "string",
+              format: "uuid"
+            }
+          }
+        ],
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  url: {
+                    type: "string",
+                    format: "uri"
+                  },
+                  events: {
+                    type: "array",
+                    items: {
+                      type: "string"
+                    }
+                  },
+                  active: {
+                    type: "boolean"
+                  }
+                }
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Webhook updated."
+          },
+          "404": {
+            description: "Webhook not found."
+          }
+        }
+      },
+      delete: {
+        operationId: "deleteWebhook",
+        summary: "Delete webhook configuration",
+        tags: [
+          "Delivery"
+        ],
+        parameters: [
+          {
+            name: "id",
+            in: "path",
+            required: true,
+            schema: {
+              type: "string",
+              format: "uuid"
+            }
+          }
+        ],
+        responses: {
+          "200": {
+            description: "Webhook deleted."
+          },
+          "404": {
+            description: "Webhook not found."
+          }
+        }
+      }
     }
   },
   components: {
@@ -16304,7 +16779,9 @@ var API_NAV_SECTIONS = [
     { id: "introduction", label: "Introduction" },
     { id: "authentication", label: "Authentication" },
     { id: "base-url", label: "Base URL" },
-    { id: "quick-start", label: "Quick Start" }
+    { id: "quick-start", label: "Quick Start" },
+    { id: "pagination", label: "Pagination" },
+    { id: "idempotency", label: "Idempotency" }
   ] },
   { id: "extract", label: "Extract", children: [
     { id: "post-extract", label: "POST /v1/extract" },

package/dist/tailwind-preset.d.cts

@@ -0,0 +1,45 @@
+/**
+ * Tailwind CSS preset for @talonic/docs consumers.
+ * Adds the Void design system color tokens and font families
+ * so doc components render correctly in any host app.
+ */
+declare const voidDocsPreset: {
+    darkMode: "class";
+    theme: {
+        extend: {
+            colors: {
+                'void-bg': string;
+                'void-bg-elevated': string;
+                'void-surface': string;
+                'void-surface-2': string;
+                'void-surface-3': string;
+                'void-border': string;
+                'void-border-hover': string;
+                'void-text-primary': string;
+                'void-text-secondary': string;
+                'void-text-muted': string;
+                'void-text-tertiary': string;
+                'void-accent': string;
+                'void-accent-hover': string;
+                'void-accent-dim': string;
+                'void-accent-tint': string;
+                'void-danger': string;
+                'void-danger-solid': string;
+                'void-divider': string;
+                'void-warning': string;
+                'void-warning-dim': string;
+                'void-tier-1': string;
+                'void-tier-2': string;
+                'void-tier-3': string;
+            };
+            fontFamily: {
+                space: string[];
+                body: string[];
+                mono: string[];
+            };
+        };
+    };
+    plugins: never[];
+};
+
+export { voidDocsPreset as default };

package/dist/tailwind-preset.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Tailwind CSS preset for @talonic/docs consumers.
+ * Adds the Void design system color tokens and font families
+ * so doc components render correctly in any host app.
+ */
+declare const voidDocsPreset: {
+    darkMode: "class";
+    theme: {
+        extend: {
+            colors: {
+                'void-bg': string;
+                'void-bg-elevated': string;
+                'void-surface': string;
+                'void-surface-2': string;
+                'void-surface-3': string;
+                'void-border': string;
+                'void-border-hover': string;
+                'void-text-primary': string;
+                'void-text-secondary': string;
+                'void-text-muted': string;
+                'void-text-tertiary': string;
+                'void-accent': string;
+                'void-accent-hover': string;
+                'void-accent-dim': string;
+                'void-accent-tint': string;
+                'void-danger': string;
+                'void-danger-solid': string;
+                'void-divider': string;
+                'void-warning': string;
+                'void-warning-dim': string;
+                'void-tier-1': string;
+                'void-tier-2': string;
+                'void-tier-3': string;
+            };
+            fontFamily: {
+                space: string[];
+                body: string[];
+                mono: string[];
+            };
+        };
+    };
+    plugins: never[];
+};
+
+export { voidDocsPreset as default };