LedgerLou Docs is optimized for desktop.

Please open this page on a device with a wider screen.

Payables

Create payment run

Creates a new payment run in draft status with selected invoices. All vendors must have valid IBANs. Each invoice can only be in one active run.

POST /v1/payment-runs
Authorization
Authorization string header required API key in the format ll_.... Pass as a Bearer token.
Request Body
bank_account_id string (UUID) required Bank account to pay from.
execution_date string (YYYY-MM-DD) required Requested SEPA execution date.
invoice_ids array of UUID required Invoice UUIDs to include.
label string optional Optional label for the run.
Responses
201
Success
400
VENDOR_IBAN_MISSING
409
INVOICE_ALREADY_IN_ACTIVE_RUN
404
INVOICE_NOT_FOUND
404
BANK_ACCOUNT_NOT_FOUND
POST /v1/payment-runs
cURL
-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/payment-runs' -punct">\
  --header 'Authorization: Bearer ll_your_key'
201 Response
JSON
{
  "id": "<string>",
  "status": "<string>",
  "total_amount": "<string>",
  "invoice_count": 1,
  "items": []
}