Lexicon Garden

app.zeens.getEvents

Browse events. Defaults to upcoming events (startsAt >= now) ordered by startsAt ascending with a stable uri tie-breaker. Supports multi-value category filtering (OR-matched), mode filtering (in person / online / hybrid), and nearby filtering (lat/lng/radius, reusing the getNearbyPhotos coordinate convention).

Repository @zeens.app did:plc:pwpuqwge6g7xrjmfbw73uycw namespace authority
Details · query
Kindquery
Authorityzeens.app
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

category

string

Restrict to events carrying any of these category values. Accepts a single value or a comma-separated list, OR-matched against the event's categories array (categories are multi-value: an event can be both a photowalk and a meetup).

cursor

string

filter

string

Time window relative to now. 'upcoming_first' is the one-list browse: every event, soonest upcoming first, past events below most-recent-first.

  • default: "upcoming"
  • knownValues: upcoming | past | all | upcoming_first

lat

integer

Center latitude in microdegrees (x1e7) for a nearby search.

limit

integer
  • minimum: 1
  • maximum: 100
  • default: 36

lng

integer

Center longitude in microdegrees (x1e7) for a nearby search.

mode

string

Restrict to events happening this way. Stored values are normalised on read (absent -> 'in_person', legacy 'virtual' -> 'online'). A 'hybrid' event matches an 'in_person' or an 'online' request as well as an explicit 'hybrid' one, because it genuinely is both.

  • knownValues: in_person | online | hybrid

radiusKm

integer

Radius in km for a nearby search. Requires lat + lng.

  • minimum: 1
  • maximum: 500

viewer

string · did

Output

application/json

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • app.zeens.getEventFacets

    query

    Category and mode counts for the events filter strip, aggregated in Postgres over the whole catalog (not tallied from a page of results). Lets the client offer only filters that will actually return something. Scoped by the same time window as getEvents, so an Upcoming strip counts upcoming events.

  • app.rocksky.event.getEvents

    query

    List indexed music events, soonest first. Without a time window only unexpired events are returned: those ending (or, with no end, starting) today or later, plus undated ones.

  • community.lexicon.calendar.searchEvents

    query

    Search for events. Supports full-text search, filtering by repository, and filtering by location CIDs.

  • app.zeens.getNearbyPhotos

    query

    Retrieve geotagged Zeens photos inside a geographic bounding box. Powers the Explore map: each result carries its lat/lng (decoded from the int*1e7 stored in postMeta), the first image cid for a thumbnail, the author identity, and the like count for ordering co-located stacks.