---
title: "Retrieve one reconciliation record"
method: GET
path: "/v1/reconciliation/records/{record_id}"
tags: ["Reconciliation"]
---

# Retrieve one reconciliation record

`GET /v1/reconciliation/records/{record_id}`

Returns a single reconciliation record by id, including its matches (`matches_as_a`,
`matches_as_b`), the records it is matched against (`matched_records`), the remaining
`amount_to_be_reconciled`, and whether it is `exhausted`. The embedding vector is omitted.
Non-admin callers only see records of their companies.

**Note:** the record is looked up with `find_by` (not `find_by!`), so an unknown `record_id`
does **not** return a `404` — the endpoint responds `200` with a `null` body.

## Path parameters

- `record_id` string, uuid, required

## Headers

- `company-id` string, uuid, required

## Response `200`

The requested reconciliation record, or `null` when `record_id` is unknown.

- ReconciliationRecord — A reconciliation record — a normalized, read-only projection over reconcilable sources (bank transactions, payables, credit/debit notes, expense reports, imprest funds). Records are matched against each other to reconcile payables with the transactions that paid them. The `embedding` vector is never included in responses.
  - `id` string, uuid, required — The record id (equal to the underlying source record id).
  - `type` string, required — The reconciliation-record subtype.
  - `source_type` string — The polymorphic type of the underlying source record.
  - `company_id` string, uuid
  - `amount_cents` integer — The record's amount in cents.
  - `currency` string
  - `reference_date` string, date-time, nullable — Display date (issue/authorized/created date depending on the source).
  - `document_type` string, nullable — SII document type, for payable-like records.
  - `counterpart_company_id` string, uuid, nullable — The counterpart company id, when applicable.
  - `amount_to_be_reconciled` integer — Remaining amount still to reconcile, in cents.
  - `exhausted` boolean — Whether the record's available balance is genuinely zero.
  - `embedding_content` string, nullable — Text used to build the record's semantic embedding.
  - `matches_as_a` ReconciliationMatch[] — Matches where this record is `record_a`.
    - `id` string, uuid, required
    - `company_id` string, uuid
    - `record_a_id` string, uuid, required — One side of the match.
    - `record_b_id` string, uuid, required — The other side of the match.
    - `amount` integer, nullable — The reconciled amount in cents.
    - `type` 'Reconciliation::Match::PayableTransaction' | 'Reconciliation::Match::SubPayable' | 'Reconciliation::Match::PayableCreditNote' | 'Reconciliation::Match::PayableDebitNote' | 'Reconciliation::Match::PayableReimbursement', nullable — Fully-namespaced STI class name of the match, derived from the linked record pair.
    - `record_a` ReconciliationRecord — recursive
    - `record_b` ReconciliationRecord — recursive
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `matches_as_b` ReconciliationMatch[] — Matches where this record is `record_b`.
    - `id` string, uuid, required
    - `company_id` string, uuid
    - `record_a_id` string, uuid, required — One side of the match.
    - `record_b_id` string, uuid, required — The other side of the match.
    - `amount` integer, nullable — The reconciled amount in cents.
    - `type` 'Reconciliation::Match::PayableTransaction' | 'Reconciliation::Match::SubPayable' | 'Reconciliation::Match::PayableCreditNote' | 'Reconciliation::Match::PayableDebitNote' | 'Reconciliation::Match::PayableReimbursement', nullable — Fully-namespaced STI class name of the match, derived from the linked record pair.
    - `record_a` ReconciliationRecord — recursive
    - `record_b` ReconciliationRecord — recursive
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `matched_records` ReconciliationRecord[] — The records reconciled against this one.
  - `created_at` string, date-time

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)