Pagination & filtering

List endpoints are paginated. Pass page and limit, or turn pagination off to fetch everything in one request.

Pagination#

List endpoints accept:

page — 1-based page number (default 1).
limit — rows per page (default 20).
paginate=false — return every row; the response is no longer split into pages.

bash

curl "${BASE}/customers?page=2&limit=50" -H "x-mba-api-key: $MBA_API_KEY"

# every row in one request (server pagination off)
curl "${BASE}/customers?paginate=false" -H "x-mba-api-key: $MBA_API_KEY"

Note

In mba-cli, --page / --limit map to the query params and --all sets paginate=false.

Filtering#

List endpoints expose endpoint-specific filters (team, date range, status, search text, …). The exact parameters for each endpoint are documented in the API reference.

Was this page helpful?