---
title: "List unreconciled bank-transaction candidates for a bill"
method: GET
path: "/companies/{companyId}/ap/{id}/match-candidates"
tags: ["AR/AP"]
---

# List unreconciled bank-transaction candidates for a bill

`GET /companies/{companyId}/ap/{id}/match-candidates`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/ap/{id}/match-candidates`
- Auth: HTTP bearer

DARK — 404s unless company_subledger_flags.ar_ap_items_enabled is true. Reuses the shared document match ranker to score already-ingested, unreconciled bank transactions by amount / date-window / vendor against this bill's linked document. Entity-scoped; an item with no linked document (or nothing matchable yet) returns an honest empty array.

## Query parameters

- `query` string
- `limit` integer

## Response `200`

Ranked candidate transactions (possibly empty)

## Other responses

- `404`: Not found or AR/AP not enabled

---

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