v2

latestOpenAPI 3.1.02026-08-07750280.6 KB
Events

List events grouped by date

Retrieve events grouped by date with limited events per day.

Pagination model: limit and offset paginate across the total event pool (i.e. across all days in the requested range). events_per_day then caps how many events are shown inside each day bucket. meta.total_items reflects the total number of matching events (not days). remaining_count on each day group indicates how many additional events exist beyond events_per_day for that day.

Existing response keys (date, events, remaining_count) are unchanged.

get/events

Query parameters

events_per_dayinteger

Maximum number of events to show per day

Maximum number of events to show per day

limitinteger

Maximum total number of events to include across all day groups. Controls how many events are fetched before grouping by date.

Maximum total number of events to include across all day groups. Controls how many events are fetched before grouping by date.

offsetinteger

Number of events to skip before applying the day grouping.

Number of events to skip before applying the day grouping.

start_datestring date nullable

Start date for event range (YYYY-MM-DD)

Start date for event range (YYYY-MM-DD)

end_datestring date nullable

End date for event range (YYYY-MM-DD)

End date for event range (YYYY-MM-DD)

Response

Successfully retrieved events grouped by date

okboolean required