Sign in
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

Request

  • Base URL: https://api.yourang.ai/v1
  • URL: https://api.yourang.ai/v1/events
  • Auth: API Key (a scheme the document does not define)

Query parameters

events_per_dayinteger

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.

offsetinteger

Number of events to skip before applying the day grouping.

start_datestring date nullable

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

end_datestring date nullable

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

Response

Successfully retrieved events grouped by date

okboolean required

Changes

No recorded changes to this endpoint across all 8 revisions of this API.