Matching

Trigger a smart matching run for a config

Run a previously-generated AI matching strategy against the documents scoped by the matching config.

post/v1/matching/configs/{id}/smart-run

Request

Base URL: https://api.talonic.com
URL: https://api.talonic.com/v1/matching/configs/{id}/smart-run
Auth: HTTP bearer

Path parameters

idstring uuid required

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Resource UUID.

Request body

strategy_idstring uuid required

Strategy generated via POST /v1/matching/strategies/generate to execute against this config.

Example request

{
  "strategy_id": "c9d0e1f2-a3b4-5678-cdef-789012345678"
}

Response

Smart matching run queued.

idstring uuid required

matching_config_idstring uuid required

status'queued' | 'running' | 'completed' | 'failed' | 'cancelled' required

triggered_bystring

rows_processedinteger nullable

rows_matchedinteger nullable

avg_confidencenumber float nullable

started_atstring date-time nullable

completed_atstring date-time nullable

errorstring nullable

created_atstring date-time

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "matching_config_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "triggered_by": "manual",
  "started_at": "2026-04-25T14:30:00.000Z",
  "completed_at": "2026-04-25T14:30:00.000Z",
  "created_at": "2026-04-25T14:30:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.