List customers

Lists all customers of the tenant with optional search and active filter. Each entry includes the aggregated open amount.

list_customers

Authorization

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

Scopes

debitoren:read

Parameters

search string optional Free-text search over name and VAT ID

is_active boolean optional Only active (true) or inactive (false) customers

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

offset number optional Offset for pagination (default: 0)

Response

200

Success

MCP list_customers

JSON

{
  "tool": "list_customers",
  "params": {
    "search": "<string>",
    "is_active": true,
    "limit": 1,
    "offset": 1
  }
}

200 Response

JSON

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