Transactions

Get transaction

Retrieve the details of a single transaction by its ID.

get/rest/transactions/{transaction-id}

Path parameters

transaction-idstring required

finX ID of transaction.

Example:T12345.6

Parameters

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

Response

Transaction details.

account_idSchema required— unresolved $ref
transaction_idSchema required— unresolved $ref
amountAmount required— unresolved $ref
currencyCurrency required— unresolved $ref
account_numberAccountNumber — unresolved $ref
bank_codeBankCode — unresolved $ref
ibanIban required— unresolved $ref
bicBic required— unresolved $ref
namestring required

Name of the counterparty.

purposestring

Purpose of the transaction potentially including other structured SEPA information (e.g. EREF+, MREF+). For the purre purpose text see sepa_remittance_info.

external_idstring

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_infostring

Pure purpose text without other SEPA fields.

sepa_purpose_codeSepaPurposeCode — unresolved $ref
booking_textstring

Booking text further describing the type of transaction.

booking_keystring

SWIFT transaction identification code indicating the purpose of the transaction. Possible codes are specified in MT940 (field 61, subfield 6).

creditor_idCreditorId — unresolved $ref
mandate_referenceMandateReference — unresolved $ref
end_to_end_referenceEndToEndReference — unresolved $ref
typeSchema required— unresolved $ref
prima_nota_numberstring

FinTS: Bank-internal number to group and identify transactions.

transaction_codeinteger required

FinTS: Transaction type as DTA Textschlüssel/Geschäftsvorfallcode.

categoriesItems[] required— unresolved $ref

Category sub-tree associated with this transaction.

payment_partnerPaymentPartner — unresolved $ref
contract_idSchema — unresolved $ref
bookedboolean required

Indicates if the transaction has been settled.

booked_atEndedAt required— unresolved $ref
settled_atEndedAt required— unresolved $ref
created_atCreatedAt required— unresolved $ref
modified_atModifiedAt required— unresolved $ref