List customers
easybill_list_customersList easybill customers with filters for name, email, country, and more. Paginate through results to retrieve customer data efficiently.
Instructions
List customers from easybill with optional filters and pagination.
NOTE: easybill has no fuzzy full-text customer search. The filters below match exact values (though each accepts several comma-separated values). To find a customer by a partial name, filter on company_name or last_name with the exact spelling, or page through the list and match locally.
Returns a compact field set by default; pass 'fields' for specific columns or ['all'] for everything.
Returns: { total, count, page, pages, has_more, next_page, items[] }. Use 'next_page' to continue paging. Monetary values are integers in cents (150 = 1.50 EUR).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting at 1. Use 'next_page' from a previous response to continue. | |
| limit | No | Items per page, 1-1000 (default 25). Keep this small unless you need bulk data. | |
| emails | No | Filter by email address. Accepts one value or a list of values. | |
| fields | No | Limit returned columns to these field names (e.g. ['number','amount','paid_at']). Pass ['all'] for every field. Omit for a compact default set. Fewer fields = less context used. | |
| number | No | Filter by your customer number. Accepts one value or a list of values. | |
| country | No | Filter by country (ISO 2-letter code, e.g. 'DE' or 'DE,AT,CH'). Accepts one value or a list of values. | |
| group_id | No | Filter by customer group ID. Accepts one value or a list of values. | |
| zip_code | No | Filter by postal code. Accepts one value or a list of values. | |
| last_name | No | Filter by exact last name. Accepts one value or a list of values. | |
| created_at | No | Filter by creation date. Single date 'YYYY-MM-DD' or an inclusive range 'YYYY-MM-DD,YYYY-MM-DD' | |
| first_name | No | Filter by exact first name. Accepts one value or a list of values. | |
| company_name | No | Filter by exact company name. Accepts one value or a list of values. | |
| response_format | No | Output format: 'markdown' for readable prose, 'json' for machine-readable data | markdown |
| additional_group_id | No | Filter by an additional customer group ID. Accepts one value or a list of values. |