talonic_filter

Filter documents by extracted field values using composable conditions (eq, gt, between, contains, etc.).

Accepts canonical field names (e.g. vendor.name, policy.0_coverage_type) which the Talonic API resolves to IDs server-side, or UUIDs directly.

Parameter	Type	Description
conditions *	array	Filter conditions, AND-ed together. Each has `field` or `field_id`, `operator`, and `value`.
search	string	Optional free-text search applied alongside filters.
sort	object	Sort by a field: `{ field, direction: "asc" \| "desc" }`.
page	integer	Page number for pagination.
limit	integer	Results per page. Default: 50.

The is_not_empty operator currently underreports. Use specific operators (eq, gt, contains, etc.) against known values when possible.

Example

Tool input

{
  "conditions": [
    { "field": "vendor.name", "operator": "eq", "value": "Meridian Energy AG" },
    { "field": "invoice.total_eur", "operator": "gt", "value": 1000 }
  ],
  "sort": { "field": "invoice.total_eur", "direction": "desc" },
  "limit": 20
}

Tool response

{
  "data": [
    {
      "document_id": "doc_8f3a...",
      "filename": "invoice-2026-001.pdf",
      "fields": {
        "vendor.name": "Meridian Energy AG",
        "invoice.total_eur": 1500.00,
        "invoice.due_date": "2026-06-15"
      }
    },
    {
      "document_id": "doc_c2d9...",
      "filename": "invoice-2026-003.pdf",
      "fields": {
        "vendor.name": "Meridian Energy AG",
        "invoice.total_eur": 1200.00,
        "invoice.due_date": "2026-04-30"
      }
    }
  ],
  "total": 2,
  "page": 1
}