BillyDocumentation

List event sessions

Retrieves the complete paginated list of sessions of an event, ordered by start date. Supports startAt range filters. Returns 404 when the event does not exist or does not belong to your organization.

GET
/v1/events/{event_id}/sessions

Retrieves the complete paginated list of sessions of an event, ordered by start date. Supports startAt range filters. Returns 404 when the event does not exist or does not belong to your organization.

Authorization

HTTPBearer
AuthorizationBearer <token>

API key authentication. Format: Bearer billy:o:<organization_id>:<api_key>

Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx

In: header

Path Parameters

event_id*Event Id

Query Parameters

page?Page

Page index (1-based, e.g., 1 for first page, 2 for second page)

Range1 <= value
Default1
perPage?|

Maximum number of records to return

startAt.gte?|

Return results where startAt is at or after this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00).

startAt.gt?|

Return results where startAt is strictly after this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00).

startAt.lte?|

Return results where startAt is at or before this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00).

startAt.lt?|

Return results where startAt is strictly before this value. For datetime fields, use ISO 8601 format with timezone offset (e.g. 2026-03-01T00:00:00+02:00).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/events/string/sessions"
{  "items": [    {      "id": "68799a92-c357-454d-afa5-54ed51f1f98f",      "startAt": "2025-03-21T19:30:00+01:00",      "durationMinutes": 180    },    {      "id": "8b1c0f77-95d1-4f0e-9f5a-0f6f1d3f98aa",      "startAt": "2025-03-22T19:30:00+01:00",      "durationMinutes": 180    }  ],  "page": 1,  "perPage": 100,  "totalPages": 1}