---
title: "Get reconciliation suggestions"
method: GET
path: "/v1/banking/transactions/{transactionId}/suggestions"
tags: ["Banking"]
---

# Get reconciliation suggestions

`GET /v1/banking/transactions/{transactionId}/suggestions`

## Request

- Base URL: `https://api.frihet.io`
- URL: `https://api.frihet.io/v1/banking/transactions/{transactionId}/suggestions`
- Auth: API key in header `X-API-Key`

Read-only ranked reconciliation candidates for a bank transaction.
This endpoint does not mutate the transaction, invoices, expenses,
ledger entries, or reconciled fields.

## Path parameters

- `transactionId` string, required

## Query parameters

- `limit` integer

## Response `200`

Read-only reconciliation suggestions

- object
  - `data` object
    - `transactionId` string
    - `limit` integer
    - `suggestions` ReconciliationSuggestion[]
      - `documentType` 'invoice' | 'expense'
      - `documentId` string
      - `score` integer
      - `confidence` integer
      - `suggested` boolean
      - `amountDiff` number
      - `dateDiff` number
      - `reasons` string[]
      - `breakdown` object[]
        - `signal` 'amount' | 'date' | 'reference' | 'counterparty'
        - `points` integer
        - `similarity` number
        - `reason` string

## Other responses

- `400`: Bad request - invalid parameters or request body
- `401`: Authentication required or invalid API key
- `404`: Resource not found
- `429`: Rate limit exceeded (100 requests per minute)

---

[API](https://skmtc.dev/frihet/apis/frihet-api.md) · [All operations](https://skmtc.dev/frihet/apis/frihet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frihet/apis/frihet-api/revisions/3dd37f6a72d1?raw)