---
title: "List matching runs"
method: GET
path: "/v1/matching/runs"
tags: ["Matching"]
---

# List matching runs

`GET /v1/matching/runs`

## Request

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

Returns up to the 100 most recent matching runs for the authenticated
customer, optionally filtered by `config_id`. This endpoint is not
cursor-paginated.

## Query parameters

- `config_id` string, uuid

## Response `200`

Matching runs (most recent first, capped at 100).

- object
  - `data` MatchingRunResponse[]
    - `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

## Other responses

- `401`: Missing or invalid API key.
- `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)