---
title: "List bank-match suggestions"
method: GET
path: "/public/v2/bank-match/suggestions/"
tags: ["Bank Match"]
---

# List bank-match suggestions

`GET /public/v2/bank-match/suggestions/`

Return the suggestions DualEntry has produced for your organization, newest
first. Each suggestion pairs a bank-feed row with an accounting transaction —
either one you already have on file (`match`) or one we'd draft on your
behalf if you accept it (`create`).

Filters:

- `financial_transaction_id` — see every candidate match for one bank row.
- `suggestion_type` — narrow to `match` or `create`.
- `is_highest_ranked=true` — return just the top pick per bank row (the same
  one the DualEntry UI defaults to). Leave off to see all candidates.

## Query parameters

- `financial_transaction_id` integer, nullable
- `suggestion_type` 'match' | 'create'
- `is_highest_ranked` boolean, nullable
- `limit` integer — Number of records to return per page (capped at 100)
- `offset` integer — Number of records to skip before starting to return results

## Response `200`

OK

- PagedPublicBankMatchSuggestionSchemaOut
  - `items` PublicBankMatchSuggestionSchemaOut[], required
    - `id` integer, required
    - `financial_transaction_id` integer, required
    - `transaction_id` integer, required
    - `suggestion_type` 'match' | 'create', required
    - `confidence_score` string, nullable — How confident the AI is, from 0.00 to 100.00. Null for deterministic (rule-based) matches where confidence doesn't apply.
  - `count` integer, required

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/dualentry/apis/dualentry-public-api.md) · [All operations](https://skmtc.net/dualentry/apis/dualentry-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dualentry/dualentry-public-api/versions/525a590a98f8/schema)