app.rocksky.event.getEvents

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.

Repository @rocksky.app did:plc:vegqomyce4ssoqs7zwqvgqty namespace authority
Details · query
Kindquery
Authorityevent.rocksky.app
Indexed

Query

query · GET

Parameters

query string

artist

string

Only events this artist plays: the artist's AT-URI, id or sha256.

did

string · did

Only events published by this repo.

from

string · datetime

Only events that end at or after this time. Defaults to the start of today (UTC) when neither `to` nor `includePast` is given.

genre

string

Only events whose genre matches (case-insensitive).

Return past events too, most recent first, instead of upcoming ones.

kind

string

Only events of this kind (concert, festival...).

limit

integer

The maximum number of events to return.

  • minimum: 1
  • maximum: 100
  • default: 20

offset

integer

The offset for pagination.

  • minimum: 0
  • default: 0

rsvpBy

string · did

Only events this DID has RSVP'd to (going or interested).

to

string · datetime

Only events that start at or before this time.

Output

application/json

events

requiredarray

Similar lexicons

semantic match

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

  • Get a music event by the AT-URI of either its calendar event record or its app.rocksky.event.music record.

  • 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).

  • An artist on an event lineup, linked to the Rocksky artist when one was resolved.

  • Marks a community.lexicon.calendar.event as a music event (concert, festival, club night...) and links it to the artists performing. The calendar event carries the name, dates and venue; this record carries what is specific to music. Rocksky only indexes calendar events that have one of these attached.

  • List who responded to an event, most recent first.