List customers

Returns all customers of the tenant with optional search, active filter and pagination. Each customer includes the aggregated open amount.

GET /v1/customers

Authorization

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

Query Parameters

search string optional Free-text search in name and VAT ID.

is_active string optional "true" or "false" (default: all)

limit integer optional Max. results (1–500, default: 50)

offset integer optional Offset for pagination (default: 0)

Responses

200

Success

400

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

GET /v1/customers

cURL

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

200 Response

JSON

[
  {
    "id": "<string>",
    "name": "<string>",
    "vat_id": "<string>",
    "iban": "<string>",
    "default_account": "<string>",
    "is_active": true,
    "open_amount": 1
  }
]