List events of an agenda

Numeric uid of the agenda.

Opaque pagination cursor returned in pagination.after of the previous page. Omit it to fetch the first page.

Maximum number of items to return per page. An out-of-range or non-integer value is rejected with 400, never clamped; use the after cursor to page further.

When true, each item in data is returned in its detailed representation, including the detailed-only fields. When false (the default), items are the lighter summary representation.

Ordering of the results. Defaults to timingsWithFeatured.asc, or to score (relevance) when search is set and no sort is given.

Full-text search across title, description, keywords and address. Wrap the value in double quotes for an exact phrase match.

Relevance score floor for search results, used to drop weakly-matching events from the long tail (e.g. a single query term buried in a long description). Ignored when search is not set. off (the default) returns every match. auto derives the floor from the score distribution of the current query: the largest relative drop ("elbow") in the top scores becomes the cutoff, so it adapts to each query. A non-negative number is an absolute minimum score; relevance scores are specific to a query, so a fixed value suits a single tuned query rather than general use - prefer auto. The cutoff applies before counting, so the returned events, their total and the facet counts describe the same trimmed set; pass the same threshold to the facets endpoint to keep its counts aligned with the list.

Restrict to these event uids. Repeat the parameter for multiple values.

Restrict to these event slugs. Repeat the parameter for multiple values.

Match an event by an external identifier: extId[key]=<system>&extId[value]=<id>.

Restrict to events tagged with these keywords. Repeating the parameter narrows the result set (AND semantics).

Restrict to events in these languages (ISO 639-1 codes).

Restrict to events offering these accessibility facilities.

Restrict to these statuses.

Restrict to these attendance modes.

Restrict to featured (true) or non-featured (false) events.

Restrict to events held at these location uids.

Match by a location external identifier: locationExtId[key]=<system>&locationExtId[value]=<id>.

Restrict to events located in these regions.

Restrict to events located in these departments.

Restrict to events located in these cities.

Restrict to events located in these districts.

Restrict to events located in these level-3 administrative areas.

Restrict to events located in these level-5 administrative areas.

Restrict to events located in these countries (ISO 3166-1 alpha-2).

Restrict to events whose location falls within a bounding box, given as west,south,east,north in decimal degrees (WGS84). Example: bbox=2.224,48.815,2.469,48.902.

Center of a proximity search, given as latitude,longitude in decimal degrees. Must be combined with radius.

Proximity radius in metres around near. Requires near to be set.

Restrict to events originally created in these agendas.

Restrict to events whose origin agenda is official (true) or not (false).

Restrict to events aggregated from these source agendas.

Restrict by temporal position relative to now. Combine values (repeat the parameter) to widen the window: passed, upcoming, current.

Restrict to events having a timing that begins within the range, as RFC 3339 date-times: timings[gte]=…&timings[lte]=…. For now-relative windows, prefer relative. Date-times must carry an explicit offset (e.g. Z); a bare date (YYYY-MM-DD) is read as UTC midnight.

Restrict to events with a timing starting within a daily time window, in minutes from local midnight: localTime[gte]=480 (08:00) and/or localTime[lte]=1200 (20:00).

Restrict by creation date, as RFC 3339 date-times: createdAt[gte]=…&createdAt[lte]=…. Date-times must carry an explicit offset (e.g. Z); a bare date (YYYY-MM-DD) is read as UTC midnight.

Restrict by last-update date, as RFC 3339 date-times: updatedAt[gte]=…&updatedAt[lte]=…. Useful for incremental sync. Date-times must carry an explicit offset (e.g. Z); a bare date (YYYY-MM-DD) is read as UTC midnight.

Restrict by the date OpenAgenda last WROTE inventory on the event — the write clock carried by availabilityUpdatedAt, not the rows' own syncedAt. As RFC 3339 date-times: availabilityUpdatedAt[gte]=…&availabilityUpdatedAt[lte]=…. The inventory counterpart of updatedAt, for a consumer following availability: pair it with sort=availabilityUpdatedAt.asc and a watermark. Events that never received availability carry no stamp and never match — following inventory does not mean paging through the whole corpus. Same date-time rules as updatedAt.

Restrict to events whose intended audience age range overlaps the given bounds, in years: age[gte]=7&age[lte]=12.

Filter on agenda-specific additional fields, addressed by field name: additionalFields[<fieldName>]=<value>. Available fields and their value types come from the agenda's event form schema (GET /agendas/{agendaUid}/events/schema). For numeric fields, use a range object: additionalFields[<fieldName>][gte]=…&additionalFields[<fieldName>][lte]=….