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

# Get a matching run

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

## Request

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

Returns the run summary together with up to the 50 top-confidence match results.

## Path parameters

- `id` string, uuid, required

## Response `200`

Matching run with result summary.

- MatchingRunDetailResponse
  - `id` string, uuid, required
  - `matching_config_id` string, uuid, required
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled', required
  - `triggered_by` string
  - `rows_processed` integer, nullable
  - `rows_matched` integer, nullable
  - `avg_confidence` number, float, nullable
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `error` string, nullable
  - `created_at` string, date-time
  - `links` object
    - `self` string
    - `config` string
  - `results` MatchResultItem[]: Up to the 50 highest-confidence match results.
    - `id` string, uuid
    - `document_id` string, uuid
    - `document_filename` string, nullable
    - `matched_reference_row_id` string, uuid, nullable
    - `confidence` number, float
    - `status` 'matched' | 'review' | 'no_match': Per-result match status — `matched` (best candidate at or above the accept threshold), `review` (between the review and accept thresholds), `no_match` (no candidate cleared the review threshold).
    - `evidence` object: Per-result evidence payload (top candidates, per-field scores).

## 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)