Fetch Many Events

List events with visibility enforcement, filtering, sorting, geo, and free-text search

GET /:projectId/api/v7/events

Fetch Many Events

cURL

curl --request GET \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/events

Returns a paginated list of events. The server-side visibility predicate is always applied: anonymous callers see only public events; authenticated callers additionally see members events of spaces they belong to, invite events they were invited to, and any event they host. Service/master keys see everything.

Each event includes inline rsvpCounts, and—with the userRsvp include and an authenticated caller—the caller’s own userRsvp.

Authentication is optional (optionalUserAuth). Several filters interact with the caller’s identity (myRsvp, userRsvp).

Query Parameters

page · number

Page number (1-indexed). Defaults to 1.

limit · number

Results per page. Capped at 100. Defaults to 10.

sortBy · string

"startTime" (chronological) or "going" (by going-RSVP count). Defaults to "startTime".

sortDir · string

"asc" or "desc". Defaults to "asc".

timeWindow · string

Derived time window: "upcoming" (startTime in the future), "ongoing" (started, has an endTime, not yet ended), or "past". Events without an endTime become past once they start.

startsAfter · string

ISO datetime. Only events starting after this. ANDed with timeWindow.

startsBefore · string

ISO datetime. Only events starting before this.

spaceId · string

Restrict to events scoped to this space. Omit for all scopes.

hostId · string

Only events hosted by this user (array containment on hostIds).

type · string

Filter by "online", "physical", or "hybrid".

status · string

"active" or "cancelled". Defaults to "active".

myRsvp · string

Comma-separated RSVP statuses the caller responded with, e.g. "going,maybe". Requires an authenticated caller (or a service/master key passing userId); otherwise returns 400.

locationFilters · object

Proximity filter { latitude, longitude, radius } (radius in meters). Uses ST_DWithin.

titleFilters · object

Free-text filter on title: { hasTitle?, includes?, doesNotInclude? }. includes/doesNotInclude accept a string or array.

descriptionFilters · object

Free-text filter on description: { hasDescription?, includes?, doesNotInclude? }.

include · string

Comma-separated associations to expand: "user", "space", "files", "userRsvp".

userId · string

The requester id. Used for the myRsvp filter, userRsvp enrichment, and visibility resolution. For non-privileged callers the server infers this from the auth token; service/master keys may pass it explicitly.

Response

Returns a paginated response: { data: Event[], pagination: { page, limit, totalItems, hasMore, ... } }. See Event.

Error Responses

myRsvp Requires Auth — 400

{ "error": "The myRsvp filter requires an authenticated caller (or a service/master key acting via a userId query param).", "code": "event/my-rsvp-requires-auth" }

Invalid Query — 400

{ "error": "Limit must be a positive number", "code": "event/invalid-query" }

See also: useFetchManyEvents · useFetchManyEventsWrapper