Skip to main content
POST
Batch import of account entries

Re-importing an existing IBAN

The import is create-only. If an IBAN already exists in your directory, that entry is not overwritten: it is reported in failed_entries with the reason Account already exists, it is not counted in imported_count, and the request still returns HTTP 200 for the remaining entries. To change the name, aliases or identifiers of an existing IBAN, use the update endpoints (by IBAN or by client ID). To replace an entry completely, delete it and import it again.

Headers

Idempotency-Key
string
required

Unique idempotency key to prevent duplicate batch account import requests

Body

application/json

Batch import request containing account entries

accounts
object
required

Payload for importing a single account via IBAN and owner identification.

Example:

"[{iban: LT121000011101001000, account_holder_names: [Alice Johnson]}]"

Response

Response returned after a batch account import operation

Response returned after a batch account import operation

failed_count
integer<int32>
required

Number of account entries that failed to import

Example:

15

failed_entries
object
required

List of account entries that failed to be imported along with reasons

imported_count
integer<int32>
required

Number of account entries successfully imported

Example:

85

imported_entries
object
required

List of account entries that were successfully imported

total_count
integer<int32>
required

Total number of account entries submitted for import

Example:

100

Last modified on September 2, 2026