---
title: "Super-admin confirm an explicit set of document-match proposal pairs"
method: POST
path: "/companies/{companyId}/documents/match-proposals/confirm"
tags: ["Documents"]
---

# Super-admin confirm an explicit set of document-match proposal pairs

`POST /companies/{companyId}/documents/match-proposals/confirm`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/documents/match-proposals/confirm`
- Auth: HTTP bearer

## Request body

- ConfirmDocumentMatchProposalsInput
  - `dryRun` boolean
  - `pairs` object[], required
    - `documentId` string, uuid, required
    - `transactionId` string, uuid, required

## Response `200`

Confirmation outcomes for every requested pair

- DocumentMatchConfirmResponse
  - `success` boolean, required
  - `data` object, required
    - `scanned` integer, required
    - `confirmed` integer, required
    - `skipped` integer, required
    - `results` object[], required
      - `documentId` string, uuid, required
      - `transactionId` string, uuid, required
      - `outcome` 'confirmed' | 'would_confirm' | 'skipped', required
      - `reason` string

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `422`: Request failed validation

---

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