Pagination
Page through list endpoints with page and per_page, and read the paginated envelope.
Endpoints that return lists use pagination based on the page and per_page parameters.
Pagination Parameters
- page (integer, optional): Page number (1-based, default: 1)
- per_page (integer, optional): Number of items per page (max: 1000, default: 100)
Paginated Response Structure
{
"items": [...],
"page": 1,
"perPage": 100,
"totalPages": 5,
"hasMore": true,
"nextPage": "https://platform.billyapp.live/v1/events?page=2&per_page=100"
}204 Response Code
When you request a page that does not exist (out of range), the API returns a 204 No Content status with an empty body.