Matching

Create a matching configuration

Link a reference dataset to a target scope via weighted field mappings. The reference dataset must belong to the authenticated customer.

post/v1/matching/configs

Request

Base URL: https://api.talonic.com
URL: https://api.talonic.com/v1/matching/configs
Auth: HTTP bearer

Request body

namestring required

Human-readable configuration name.

reference_data_idstring uuid required

UUID of the reference dataset to match against.

thresholdnumber float

Auto-accept confidence threshold (defaults to 0.85 server-side).

target_type'run' | 'schema' | 'document_filter'

Target scope type (defaults to run).

target_valueobject

Free-form target identifier payload (e.g. { run_id }).

Example request

{
  "reference_data_id": "b8c9d0e1-f2a3-4567-bcde-678901234567",
  "field_mappings": [
    {
      "extracted_field": "vendor_name",
      "reference_column": "supplier_legal_name",
      "match_type": "exact",
      "weight": 0.6
    }
  ]
}

Response

Matching configuration created (alias of 201).

idstring uuid required

namestring required

reference_data_idstring uuid required

target_type'run' | 'schema' | 'document_filter'

target_valueobject

Target identifier payload (e.g. run_id, schema_id).

thresholdnumber float required

Auto-accept confidence threshold.

created_atstring date-time

updated_atstring date-time nullable

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Supplier lookup",
  "reference_data_id": "b8c9d0e1-f2a3-4567-bcde-678901234567",
  "target_type": "run",
  "field_mappings": [
    {
      "extracted_field": "vendor_name",
      "reference_column": "supplier_legal_name",
      "match_type": "exact",
      "weight": 0.6
    }
  ],
  "threshold": 0.85,
  "created_at": "2026-04-25T14:30:00.000Z",
  "updated_at": "2026-04-25T14:30:00.000Z"
}

Changes

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