---
title: "Get a matching configuration"
method: GET
path: "/v1/matching/configs/{id}"
tags: ["Matching"]
---

# Get a matching configuration

`GET /v1/matching/configs/{id}`

## Request

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

## Path parameters

- `id` string, uuid, required

## Response `200`

Matching configuration.

- MatchingConfigResponse
  - `id` string, uuid, required
  - `name` string, required
  - `reference_data_id` string, uuid, required
  - `target_type` 'run' | 'schema' | 'document_filter'
  - `target_value` object: Target identifier payload (e.g. run_id, schema_id).
  - `field_mappings` MatchingFieldMapping[], required
    - `extracted_field` string: Name or id of the extracted field.
    - `reference_column` string: Reference dataset column to match against.
    - `match_type` 'exact' | 'fuzzy' | 'date_range' | 'numeric_range': Matching strategy applied to this pair.
    - `weight` number, float: Relative weight used to aggregate the final confidence.
  - `threshold` number, float, required: Auto-accept confidence threshold.
  - `created_at` string, date-time
  - `updated_at` string, date-time, nullable
  - `links` object
    - `self` string
    - `runs` string

## Other responses

- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)