---
title: "Run reconciliation against a reference dataset"
method: POST
path: "/v1/reconciliation/run"
tags: ["Reconciliation"]
---

# Run reconciliation against a reference dataset

`POST /v1/reconciliation/run`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/reconciliation/run`
- Auth: HTTP bearer

## Request body

- object
  - `reference_data_id` string, uuid, required
  - `target_type` 'documents' | 'run', required
  - `target_value` object, required: { document_ids: uuid[] } or { run_id: uuid }
  - `config` object, required
    - `lookup_fields` string[], required
    - `reference_key_columns` string[]
    - `narrowing_columns` string[]
    - `key_patterns` object
    - `checks` object[]
      - `name` string, required
      - `type` 'exact' | 'numeric_tolerance' | 'containment' | 'any_field' | 'fuzzy_name' | 'fuzzy_address' | 'extract_only', required
      - `extracted_fields` string[], required
      - `reference_fields` string[], required
      - `tolerance` number
      - `required` boolean
      - `document_type` string
      - `fuzzy_threshold` number

## Response `200`

Reconciliation result

---

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