Import

POST

/api/public/v1/transactions

Imports new financial transactions.

Request Body ^required

object

transactions

required

Array<object>

>= 1 items <= 1000 items

object

accountIdentifier

required

The unique identifier of a specific account this transaction belongs to, for example an IBAN or a masked CC number.

string

transactionId

The unique identifier of a transaction. This id, combined with the accountIdentifier, is used for deduplicating transactions.

string

text

The description text of a transaction.

string

creditDebit

Specifies whether the transaction is a credit or debit operation.

string

Allowed values: credit debit

amount

required

The amount of the transaction. This is a string to allow for decimal values, and has to be a positive number.

string

currency

required

The currency of the transaction. This is a string that represents the ISO 4217 currency code.

string

Allowed values: AFN EUR ALL DZD USD AOA XCD ARS AMD AWG AUD AZN BSD BHD BDT BBD BYR BZD XOF BMD BTN INR BOB BOV BAM BWP NOK BRL BND BGN BIF KHR XAF CAD CVE KYD CLF CLP CNY COP COU KMF CDF NZD CRC HRK CUC CUP ANG CZK DKK DJF DOP EGP SVC ERN ETB FKP FJD XPF GMD GEL GHS GIP GTQ GBP GNF GYD HTG HNL HKD HUF ISK IDR XDR IRR IQD ILS JMD JPY JOD KZT KES KPW KRW KWD KGS LAK LBP LSL ZAR LRD LYD CHF MOP MKD MGA MWK MYR MVR MRO MUR XUA MXN MXV MDL MNT MAD MZN MMK NAD NPR NIO NGN OMR PKR PAB PGK PYG PEN PHP PLN QAR RON RUB RWF SHP WST STD SAR RSD SCR SLL SGD XSU SBD SOS SSP LKR SDG SRD SZL SEK CHE CHW SYP TWD TJS TZS THB TOP TTD TND TRY TMT UGX UAH AED USN UYI UYU UZS VUV VEF VND YER ZMW ZWL XBA XBB XBC XBD XTS XXX XAU XPD XPT XAG

originalAmount

The original amount of the transaction in the original currency. This is only relevant, if foreign currencies are involved in this transaction (e.g. transaction currency does not match payment currency). This is a string to allow for decimal values, and has to be a positive number.

string

originalCurrency

The currency of the original amount of the transaction. This is only relevant, if foreign currencies are involved in this transaction (e.g. transaction currency does not match payment currency) This is a string that represents the ISO 4217 currency code.

string

Allowed values: AFN EUR ALL DZD USD AOA XCD ARS AMD AWG AUD AZN BSD BHD BDT BBD BYR BZD XOF BMD BTN INR BOB BOV BAM BWP NOK BRL BND BGN BIF KHR XAF CAD CVE KYD CLF CLP CNY COP COU KMF CDF NZD CRC HRK CUC CUP ANG CZK DKK DJF DOP EGP SVC ERN ETB FKP FJD XPF GMD GEL GHS GIP GTQ GBP GNF GYD HTG HNL HKD HUF ISK IDR XDR IRR IQD ILS JMD JPY JOD KZT KES KPW KRW KWD KGS LAK LBP LSL ZAR LRD LYD CHF MOP MKD MGA MWK MYR MVR MRO MUR XUA MXN MXV MDL MNT MAD MZN MMK NAD NPR NIO NGN OMR PKR PAB PGK PYG PEN PHP PLN QAR RON RUB RWF SHP WST STD SAR RSD SCR SLL SGD XSU SBD SOS SSP LKR SDG SRD SZL SEK CHE CHW SYP TWD TJS TZS THB TOP TTD TND TRY TMT UGX UAH AED USN UYI UYU UZS VUV VEF VND YER ZMW ZWL XBA XBB XBC XBD XTS XXX XAU XPD XPT XAG

purchasedAt

The date when the purchase happened. This is a string in the format YYYY-MM-DD.

string

1970-01-01

valutaAt

required

The date when the transaction was valued / valuta at. This is a string in the format YYYY-MM-DD.

string

1970-01-01

bookedAt

The date when the transaction was booked at. This is a string in the format YYYY-MM-DD.

string

1970-01-01

Responses

201

object

existingTransactions

required

Number of transactions that already existed and were deduplicated.

number

newTransactions

required

Number of newly created transactions.

number

errorTransactions

required

Number of transactions that could not be imported due to an error.

number

401