Matching

Trigger a matching run

Queue a new matching run for this configuration. The run is processed asynchronously; poll GET /v1/matching/runs/{id} for status.

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

Request

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

Path parameters

idstring uuid required
Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Resource UUID.

Response

Matching run queued (alias of 201).

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.