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.
Details · query
| Kind | query |
|---|---|
| Authority | event.rocksky.app |
| Indexed |
Checks
Validunlimited-stringdefs.main.parameters.properties.artistNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.parameters.properties.genreNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.parameters.properties.kindNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "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.",
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"events": {
"items": {
"ref": "app.rocksky.event.defs#eventView",
"type": "ref"
},
"type": "array"
}
},
"required": [
"events"
],
"type": "object"
}
},
"parameters": {
"properties": {
"artist": {
"description": "Only events this artist plays: the artist's AT-URI, id or sha256.",
"type": "string"
},
"did": {
"description": "Only events published by this repo.",
"format": "did",
"type": "string"
},
"from": {
"description": "Only events that end at or after this time. Defaults to the start of today (UTC) when neither `to` nor `includePast` is given.",
"format": "datetime",
"type": "string"
},
"genre": {
"description": "Only events whose genre matches (case-insensitive).",
"type": "string"
},
"includePast": {
"description": "Return past events too, most recent first, instead of upcoming ones.",
"type": "boolean"
},
"kind": {
"description": "Only events of this kind (concert, festival...).",
"type": "string"
},
"limit": {
"default": 20,
"description": "The maximum number of events to return.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "The offset for pagination.",
"minimum": 0,
"type": "integer"
},
"rsvpBy": {
"description": "Only events this DID has RSVP'd to (going or interested).",
"format": "did",
"type": "string"
},
"to": {
"description": "Only events that start at or before this time.",
"format": "datetime",
"type": "string"
}
},
"type": "params"
},
"type": "query"
}
},
"id": "app.rocksky.event.getEvents",
"lexicon": 1
}