Pagination, Filtering, and Errors

Pagination

Paginated endpoints accept:

ParameterDefaultNotes
page1Minimum value is 1.
limit50Maximum value is 100.

Responses include meta.total, meta.page, meta.limit, and meta.totalPages.

Common Filters

Services support filters such as date range, unscheduled inclusion, customer email, and text search.

Customers support filters such as email, name, phone, and parent-customer status.

Errors

Common error responses include:

StatusMeaning
400Required field, malformed date, or invalid request body.
401Missing or invalid API key.
403The authenticated user or session lacks access.
404Resource not found or not visible to the authenticated organization.
500Unexpected server error.

Error bodies usually include an error string and may include details for server-side diagnostics.