---
title: "Matches bank transactions with new quick entries"
method: POST
path: "/bank-transactions/reconcile/quick-entry"
tags: ["Cash Matching"]
---

# Matches bank transactions with new quick entries

`POST /bank-transactions/reconcile/quick-entry`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/bank-transactions/reconcile/quick-entry`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/bank-transactions/reconcile/quick-entry/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a separate quick entry for each bank transaction in transaction_ids, using the same requested details.
The transactions are not combined into one many-to-one (N:1) match. With line_items, supply exactly one ID.

## Request body

- MatchBankTransactionsQuickEntryRequest
  - `transaction_ids` string[], required: One or more bank transaction IDs from the same subsidiary. Without line_items, each transaction gets a separate quick entry using these request details, not an N:1 match. With line_items, supply exactly one transaction ID.
  - `type` 'VENDOR' | 'EMPLOYEE' | 'OTHER' | 'FEE' | 'ADJUSTMENT' | 'CUSTOMER' | 'NONE', required: Type of quick entry to create. VENDOR requires vendor_id; other types do not require a vendor.
  - `account_id` string, uuid, required: GL account for the offsetting entry line. Required in the request even when line_items supply explicit accounts.
  - `vendor_id` string, uuid: Vendor associated with the quick entry. Required when type is VENDOR.
  - `customer_id` string, uuid: Optional customer associated with the quick entry.
  - `name` string, required: Name of the new quick entry.
  - `description` string: Optional description on the generated entry when line_items are not supplied.
  - `fields` object[]
    - `field_id` string, uuid, required
    - `field_value_id` string, uuid, required
  - `attachment_url` string, uri: Optional attachment URL for the quick entry.
  - `line_items` CashMatchQuickEntryLine[]: Optional balanced debit and credit lines for a split quick entry. Use only when transaction_ids contains exactly one ID.
    - `side` 'DEBIT' | 'CREDIT', required: DEBIT or CREDIT side of this journal entry line.
    - `account_id` string, uuid, required: GL account for this journal entry line.
    - `amount` RoundedMonetaryAmount, required: A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
      - `amount` string, required: Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
      - `currency` string, required: Currency code following ISO-4217
    - `fx_amount` CashMatchFxAmount
      - `amount` RoundedMonetaryAmount, required: A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
        - `amount` string, required: Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
        - `currency` string, required: Currency code following ISO-4217
      - `rate` string, required: Decimal rate converting the original amount into this line booked amount in the subsidiary currency.
    - `description` string: Optional description for this journal entry line.
    - `fields` object[]
      - `field_id` string, uuid, required
      - `field_value_id` string, uuid, required
  - `fees_account_id` string, uuid: GL account for bank fees. If omitted, the provider mapped account is used; a fee without either account fails the match.

## Response `204`

Bank transactions matched.

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/bank-transactions/reconcile/quick-entry/post.md)

---

[API](https://skmtc.dev/rillet/apis/rillet-accounting-api.md) - [All operations](https://skmtc.dev/rillet/apis/rillet-accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rillet/apis/rillet-accounting-api/revisions/c393d0102005?raw)