---
title: "Full match history for a document"
method: GET
path: "/accountant/companies/{customerId}/documents/{documentId}/matches"
tags: ["Accountant Documents"]
---

# Full match history for a document

`GET /accountant/companies/{customerId}/documents/{documentId}/matches`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/companies/{customerId}/documents/{documentId}/matches`
- Auth: HTTP bearer

Every document_matches row for the document — proposed, applied, and rejected — in created_at order, with provenance: honest `method` (system_auto_apply vs accountant_manual), `appliedByActorType` (engine | system | accountant | founder; null on rows predating migration 393), and the rejection/unmatch audit keys merged into match metadata by the reject/unmatch flows.

## Response `200`

Match history rows

- AccountantDocumentMatchHistoryResponse
  - `success` boolean, required
  - `data` object, required
    - `matches` AccountantDocumentMatchHistoryItem[], required
      - `id` string, uuid, required
      - `documentId` string, uuid, required
      - `transactionId` string, uuid, required
      - `status` 'proposed' | 'applied' | 'rejected', required
      - `method` string, nullable, required
      - `confidence` number, nullable, required
      - `amountCents` integer, nullable, required
      - `currency` string, nullable, required
      - `minorUnitExponent` 2 | null, nullable, required
      - `appliedByActorType` 'engine' | 'system' | 'accountant' | 'founder' | 'null', nullable, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `rejectedAt` string, nullable, required
      - `rejectionReason` string, nullable, required
      - `unmatchedAt` string, nullable, required
      - `unmatchReason` string, nullable, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)