# matching.candidates

List what an entry could be matched with, best first. For a receipt: unmatched bank or card lines in the same direction across available history, ranked by amount (including a charge in another currency that names the receipt amount), vendor name, what people matched before, and how usual the date gap is. For a bank entry: unlinked receipts with the same amount across available history. Each candidate has its amount, date, a name and why it was suggested. Confirm with accounting_match_transaction or accounting_attach_receipt.

`GET | POST /api/v1/accounting/matching.candidates`

Permissions: `accounting:read` · Roles: admin, finance

MCP tool: `accounting_matching_candidates`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `entryId` | string (ID) | Yes | The ID of an accounting entry, from entries.list or attention.mine. |
| `limit` | integer |  | How many results to return at most. 1 to 20. Default `10`. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/matching.candidates \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'entryId=7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10'
```

Reference page: https://app.getoatmilk.com/docs/api/matching.candidates