---
title: "Get transaction"
method: GET
path: "/rest/transactions/{transaction-id}"
tags: ["Transactions"]
---

# Get transaction

`GET /rest/transactions/{transaction-id}`

Retrieve the details of a single transaction by its ID.

## Path parameters

- `transaction-id` string, required — finX ID of transaction.

## Parameters

- `#/paths/~1catalog/get/parameters/0` — unresolved $ref
- `#/paths/~1rest~1payments/get/parameters/5` — unresolved $ref

## Response `200`

Transaction details.

- object
  - `account_id` Schema, required — unresolved $ref
  - `transaction_id` Schema, required — unresolved $ref
  - `amount` Amount, required — unresolved $ref
  - `currency` Currency, required — unresolved $ref
  - `account_number` AccountNumber — unresolved $ref
  - `bank_code` BankCode — unresolved $ref
  - `iban` Iban, required — unresolved $ref
  - `bic` Bic, required — unresolved $ref
  - `name` string, required — Name of the counterparty.
  - `purpose` string — Purpose of the transaction potentially including other structured SEPA information (e.g. `EREF+`, `MREF+`). For the purre purpose text see `sepa_remittance_info`.
  - `external_id` string — The identification field provided by the bank. This is not the same as the `transaction_id`. The difference between these two fields is that while the `transaction_id` is generated internally by our systems, the `external_id` is provided by the bank as its way to identify the transaction. This is an optional field since not every bank provides an internal transaction id.
  - `sepa_remittance_info` string — Pure purpose text without other SEPA fields.
  - `sepa_purpose_code` SepaPurposeCode — unresolved $ref
  - `booking_text` string — Booking text further describing the type of transaction.
  - `booking_key` string — SWIFT transaction identification code indicating the purpose of the transaction. Possible codes are specified in [MT940](https://www2.swift.com/knowledgecentre/publications/us9m_20210723/3.0?topic=con_sfld_G-krv9uqEeqF57jgqTEwJQ_1564595035fld.htm) (field 61, subfield 6).
  - `creditor_id` CreditorId — unresolved $ref
  - `mandate_reference` MandateReference — unresolved $ref
  - `end_to_end_reference` EndToEndReference — unresolved $ref
  - `type` Schema, required — unresolved $ref
  - `prima_nota_number` string — *FinTS*: Bank-internal number to group and identify transactions.
  - `transaction_code` integer, required — *FinTS*: Transaction type as DTA Textschlüssel/Geschäftsvorfallcode.
  - `additional_info` object — Additional info on the transaction, if available.
    - `bank_reference` string — Bank reference or instruction ID, can be filled by the payers bank.
    - `reference_party_debitor` string — Deviating sender of the transfer.
    - `reference_party_creditor` string — Deviating receiver of the transfer.
    - `fee` number, float — Paid fees.
    - `gross_amount` number, float — Gross amount of the transaction.
    - `debitor_id` string — *FinTS*: An identifier of the payer.
    - `compensation_amount` string — *FinTS*: Sum of reimbursement of out-of-pocket expenses plus processing fee in case of a national return / refund debit as well as an optional interest equalization (for SEPA direct debit returns).
    - `original_amount` string — *FinTS*: Amount of the original direct debit (for SEPA direct debit returns).
  - `categories` Items[], required — Category sub-tree associated with this transaction. — unresolved $ref
  - `payment_partner` PaymentPartner — unresolved $ref
  - `contract_id` Schema — unresolved $ref
  - `booked` boolean, required — Indicates if the transaction has been settled.
  - `booked_at` EndedAt, required — unresolved $ref
  - `settled_at` EndedAt, required — unresolved $ref
  - `created_at` CreatedAt, required — unresolved $ref
  - `modified_at` ModifiedAt, required — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `404` — unresolved $ref
- `4XX` — 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)