Query the Registry

Filter across previously-ingested documents by field values. Zero re-extraction, zero AI calls. This is Mode 3 of the Talonic API — "Ingest once, query forever" as an endpoint.

Request body

The request accepts filter conditions with optional sorting and pagination.

curl -X POST https://api.talonic.com/v1/documents/filter \
  -H "Authorization: Bearer $TALONIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conditions": [
      {"fieldId": "vendor_name", "operator": "eq", "value": "Meridian Energy AG"},
      {"fieldId": "contract_year", "operator": "eq", "value": "2026"}
    ],
    "limit": 50
  }'

Parameters

conditions (required) — Array of filter objects, each with fieldId, operator, and value. Operators: eq, neq, gt, gte, lt, lte, contains, starts_with, in.

source_id (optional) — Scope to a specific source.

search (optional) — Full-text search across all fields.

sort (optional) — Sort field and direction.

page (optional) — Page number (default: 1).

limit (optional) — Results per page (default: 20, max: 500).

Response

{
  "data": [
    {
      "id": "doc_abc123",
      "type": "Vendor Contract",
      "fields": {
        "vendor_name": "Meridian Energy AG",
        "contract_value": 248000.00,
        "auto_renew": true,
        "notice_period_days": 90
      }
    }
  ],
  "total": 47,
  "links": { "self": "/v1/documents/filter" }
}