Import transactions

Imports bank transactions directly as a JSON array for a bank account.

POST /v1/bank-transactions

Authorization

Authorization string header required API key in the format ll_.... Pass as a Bearer token.

Request Body

bank_account_id uuid required Target bank account

transactions array required Transactions (max 1000)

Transaction

tx_date string required Booking date (YYYY-MM-DD)

amount number required Amount (positive = incoming, negative = outgoing)

currency string optional Currency (default: EUR)

counterparty_name string optional Name of the counter account

counterparty_iban string optional IBAN of the counter account

reference string optional Payment reference

bank_reference string optional Bank reference number

tx_type string optional Transaction type

value_date string optional Value date (YYYY-MM-DD)

Responses

201

Success

400

INVALID_INPUT Required fields are missing or values do not match the expected format.

404

NOT_FOUND The requested resource was not found.

POST /v1/bank-transactions

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/bank-transactions' -punct">\
  --header 'Authorization: Bearer ll_your_key'

201 Response

JSON

{
  "batch_id": "<string>",
  "total_rows": 1,
  "imported": 1,
  "skipped_duplicates": 1,
  "errors": []
}