---
title: "Categorize transactions"
method: POST
path: "/rpc/categorize"
tags: ["Categorization"]
---

# Categorize transactions

`POST /rpc/categorize`

Categorize transactions on the fly. The transaction data is provided in the request rather than fetched from the bank.
**Note**: Currently the number of transactions that can be sent in one request is limited to 2000.

## Parameters

- `#/paths/~1auth~1user/post/parameters/0` — unresolved $ref
- `#/paths/~1catalog/get/parameters/0` — unresolved $ref

## Request body

- object[]
  - `id` string, required — An identifier that should be used for mapping this transaction to the categorization result. It is highly recommended to make this ID unique for the scope of the request.
  - `amount` number, required — Monetary value.
  - `currency` string, ISO 4217:2015, required — Three-letter currency code.
  - `iban` string, ISO 13616:2007 — International Bank Account Number (IBAN).
  - `name` string — Name of counterparty.
  - `purpose` string — Purpose of the transaction potentially including other structured SEPA information (e.g. `EREF+`, `MREF+`).
  - `sepa_purpose_code` string, ISO 20022 — SEPA category purpose code classifying the transfer as defined in [ISO 20022](https://www.iso20022.org/external_code_list.page) (e.g. `SALA` for salary payment or `GDDS` for purchase/sale of goods).
  - `creditor_id` string — SEPA creditor identifier (for SEPA direct debits). Must be unique in combination with `mandate_reference`.
  - `mandate_reference` string — SEPA mandate reference (for SEPA direct debits). Must be unique in combination with `creditor_id`.
  - `end_to_end_reference` string — A reference code that can be used by the creditor for further identification of the transaction (e.g. a customer number or invoice number).
  - `booked_at` EndedAt — unresolved $ref
  - `user_id` string — A free-form identifier of the user to which the transaction belongs to.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref

---

[API](https://skmtc.net/qwist/apis/finx-api.md) · [All operations](https://skmtc.net/qwist/apis/finx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qwist/finx-api/revisions/b75f5c1aa39e/schema)