rsvp.atmo.event.listRecords

atmo.rsvp

Documentation

Query community.lexicon.calendar.event records with filters

main query

Query community.lexicon.calendar.event records with filters

Parameters

actor string at-identifier Optional

Filter by DID or handle (triggers on-demand backfill)

byUser string did Optional

Only used with spaceUri — filter to records authored by this DID.

createdAtMax string Optional

Maximum value for createdAt

createdAtMin string Optional

Minimum value for createdAt

cursor string Optional

No description available.

description string Optional

Filter by description

endsAtMax string Optional

Maximum value for endsAt

endsAtMin string Optional

Minimum value for endsAt

hydrateRsvps integer Optional

Number of rsvps records to embed per record

limit integer Optional

No description available.

mode string Optional

Filter by mode

name string Optional

Filter by name

order string Optional

Sort direction (default: desc for dates/numbers/counts, asc for strings)

profiles boolean Optional

Include profile + identity info keyed by DID

rsvpsCountMin integer Optional

Minimum total rsvps count

rsvpsGoingCountMin integer Optional

Minimum rsvps count where status = going

rsvpsInterestedCountMin integer Optional

Minimum rsvps count where status = interested

rsvpsNotgoingCountMin integer Optional

Minimum rsvps count where status = notgoing

search string Optional

Full-text search across: mode, name, status, description

sort string Optional

Field to sort by (default: time_us)

spaceUri string at-uri Optional

If set, query records inside this permissioned space (requires service-auth JWT).

startsAtMax string Optional

Maximum value for startsAt

startsAtMin string Optional

Minimum value for startsAt

status string Optional

Filter by status

Output

Encodingapplication/json

cursor string Optional

No description available.

profiles array Optional

No description available.

records array Required

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

actor Filter by DID or handle (triggers on-demand backfill)

byUser Only used with spaceUri — filter to records authored by this DID.

createdAtMax Maximum value for createdAt

createdAtMin Minimum value for createdAt

cursor

description Filter by description

endsAtMax Maximum value for endsAt

endsAtMin Minimum value for endsAt

hydrateRsvps Number of rsvps records to embed per record

limit

mode Filter by mode

name Filter by name

order Sort direction (default: desc for dates/numbers/counts, asc for strings)

profiles Include profile + identity info keyed by DID

rsvpsCountMin Minimum total rsvps count

rsvpsGoingCountMin Minimum rsvps count where status = going

rsvpsInterestedCountMin Minimum rsvps count where status = interested

rsvpsNotgoingCountMin Minimum rsvps count where status = notgoing

search Full-text search across: mode, name, status, description

sort Field to sort by (default: time_us)

spaceUri If set, query records inside this permissioned space (requires service-auth JWT).

startsAtMax Maximum value for startsAt

startsAtMin Minimum value for startsAt

status Filter by status

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "records"
      ],
      "properties": {
        "cursor": {
          "type": "string"
        },
        "records": {
          "type": "array",
          "items": {
            "ref": "#record",
            "type": "ref"
          }
        },
        "profiles": {
          "type": "array",
          "items": {
            "ref": "#profileEntry",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "mode": {
        "type": "string",
        "description": "Filter by mode"
      },
      "name": {
        "type": "string",
        "description": "Filter by name"
      },
      "sort": {
        "type": "string",
        "description": "Field to sort by (default: time_us)",
        "knownValues": [
          "mode",
          "name",
          "endsAt",
          "status",
          "startsAt",
          "createdAt",
          "description",
          "rsvpsCount",
          "rsvpsInterestedCount",
          "rsvpsGoingCount",
          "rsvpsNotgoingCount"
        ]
      },
      "actor": {
        "type": "string",
        "format": "at-identifier",
        "description": "Filter by DID or handle (triggers on-demand backfill)"
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 200,
        "minimum": 1
      },
      "order": {
        "type": "string",
        "description": "Sort direction (default: desc for dates/numbers/counts, asc for strings)",
        "knownValues": [
          "asc",
          "desc"
        ]
      },
      "byUser": {
        "type": "string",
        "format": "did",
        "description": "Only used with spaceUri — filter to records authored by this DID."
      },
      "cursor": {
        "type": "string"
      },
      "search": {
        "type": "string",
        "description": "Full-text search across: mode, name, status, description"
      },
      "status": {
        "type": "string",
        "description": "Filter by status"
      },
      "profiles": {
        "type": "boolean",
        "description": "Include profile + identity info keyed by DID"
      },
      "spaceUri": {
        "type": "string",
        "format": "at-uri",
        "description": "If set, query records inside this permissioned space (requires service-auth JWT)."
      },
      "endsAtMax": {
        "type": "string",
        "description": "Maximum value for endsAt"
      },
      "endsAtMin": {
        "type": "string",
        "description": "Minimum value for endsAt"
      },
      "description": {
        "type": "string",
        "description": "Filter by description"
      },
      "startsAtMax": {
        "type": "string",
        "description": "Maximum value for startsAt"
      },
      "startsAtMin": {
        "type": "string",
        "description": "Minimum value for startsAt"
      },
      "createdAtMax": {
        "type": "string",
        "description": "Maximum value for createdAt"
      },
      "createdAtMin": {
        "type": "string",
        "description": "Minimum value for createdAt"
      },
      "hydrateRsvps": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1,
        "description": "Number of rsvps records to embed per record"
      },
      "rsvpsCountMin": {
        "type": "integer",
        "description": "Minimum total rsvps count"
      },
      "rsvpsGoingCountMin": {
        "type": "integer",
        "description": "Minimum rsvps count where status = going"
      },
      "rsvpsNotgoingCountMin": {
        "type": "integer",
        "description": "Minimum rsvps count where status = notgoing"
      },
      "rsvpsInterestedCountMin": {
        "type": "integer",
        "description": "Minimum rsvps count where status = interested"
      }
    }
  },
  "description": "Query community.lexicon.calendar.event records with filters"
}

appBskyActorProfile object

No description available.

Properties

avatar blob Optional

Small image to be displayed next to posts from account. AKA, 'profile picture'

maxSize: 1.0 MB

banner blob Optional

Larger horizontal image to display behind profile view.

maxSize: 1.0 MB

createdAt string datetime Optional

An RFC 3339 formatted timestamp.

description string Optional

Free-form profile description text.

maxLength: 2560 bytesmaxGraphemes: 256 graphemes

displayName string Optional

No description available.

maxLength: 640 bytesmaxGraphemes: 64 graphemes

joinedViaStarterPack ref com.atproto.repo.strongRef Optional

No description available.

labels union Optional

Self-label values, specific to the Bluesky application, on the overall account.

Known types:

com.atproto.label.defs#selfLabels

pinnedPost ref com.atproto.repo.strongRef Optional

No description available.

pronouns string Optional

Free-form pronouns text.

maxLength: 200 bytesmaxGraphemes: 20 graphemes

website string uri Optional

A valid URI.

View raw schema

{
  "type": "object",
  "properties": {
    "avatar": {
      "type": "blob",
      "accept": [
        "image/png",
        "image/jpeg"
      ],
      "maxSize": 1000000,
      "description": "Small image to be displayed next to posts from account. AKA, 'profile picture'"
    },
    "banner": {
      "type": "blob",
      "accept": [
        "image/png",
        "image/jpeg"
      ],
      "maxSize": 1000000,
      "description": "Larger horizontal image to display behind profile view."
    },
    "labels": {
      "refs": [
        "com.atproto.label.defs#selfLabels"
      ],
      "type": "union",
      "description": "Self-label values, specific to the Bluesky application, on the overall account."
    },
    "website": {
      "type": "string",
      "format": "uri"
    },
    "pronouns": {
      "type": "string",
      "maxLength": 200,
      "description": "Free-form pronouns text.",
      "maxGraphemes": 20
    },
    "createdAt": {
      "type": "string",
      "format": "datetime"
    },
    "pinnedPost": {
      "ref": "com.atproto.repo.strongRef",
      "type": "ref"
    },
    "description": {
      "type": "string",
      "maxLength": 2560,
      "description": "Free-form profile description text.",
      "maxGraphemes": 256
    },
    "displayName": {
      "type": "string",
      "maxLength": 640,
      "maxGraphemes": 64
    },
    "joinedViaStarterPack": {
      "ref": "com.atproto.repo.strongRef",
      "type": "ref"
    }
  }
}

hydrateRsvps object

No description available.

Properties

going array of ref#hydrateRsvpsRecord Optional

No description available.

interested array of ref#hydrateRsvpsRecord Optional

No description available.

notgoing array of ref#hydrateRsvpsRecord Optional

No description available.

other array of ref#hydrateRsvpsRecord Optional

No description available.

View raw schema

{
  "type": "object",
  "properties": {
    "going": {
      "type": "array",
      "items": {
        "ref": "#hydrateRsvpsRecord",
        "type": "ref"
      }
    },
    "other": {
      "type": "array",
      "items": {
        "ref": "#hydrateRsvpsRecord",
        "type": "ref"
      }
    },
    "notgoing": {
      "type": "array",
      "items": {
        "ref": "#hydrateRsvpsRecord",
        "type": "ref"
      }
    },
    "interested": {
      "type": "array",
      "items": {
        "ref": "#hydrateRsvpsRecord",
        "type": "ref"
      }
    }
  }
}

hydrateRsvpsRecord object

No description available.

Properties

cid string Optional

No description available.

collection string nsid Required

A namespaced identifier (e.g., app.bsky.feed.post).

did string did Required

A decentralized identifier (DID).

record ref community.lexicon.calendar.rsvp#main Optional

No description available.

rkey string Required

No description available.

space string at-uri Optional

Present when the record was read from a permissioned space.

time_us integer Required

No description available.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema

{
  "type": "object",
  "required": [
    "uri",
    "did",
    "collection",
    "rkey",
    "time_us"
  ],
  "properties": {
    "cid": {
      "type": "string"
    },
    "did": {
      "type": "string",
      "format": "did"
    },
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "rkey": {
      "type": "string"
    },
    "space": {
      "type": "string",
      "format": "at-uri",
      "description": "Present when the record was read from a permissioned space."
    },
    "record": {
      "ref": "community.lexicon.calendar.rsvp#main",
      "type": "ref"
    },
    "time_us": {
      "type": "integer"
    },
    "collection": {
      "type": "string",
      "format": "nsid"
    }
  }
}

profileEntry object

No description available.

Properties

cid string Optional

No description available.

collection string nsid Optional

A namespaced identifier (e.g., app.bsky.feed.post).

did string did Required

A decentralized identifier (DID).

handle string Optional

No description available.

record ref #appBskyActorProfile Optional

No description available.

rkey string Optional

No description available.

uri string at-uri Optional

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema

{
  "type": "object",
  "required": [
    "did"
  ],
  "properties": {
    "cid": {
      "type": "string"
    },
    "did": {
      "type": "string",
      "format": "did"
    },
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "rkey": {
      "type": "string"
    },
    "handle": {
      "type": "string"
    },
    "record": {
      "ref": "#appBskyActorProfile",
      "type": "ref"
    },
    "collection": {
      "type": "string",
      "format": "nsid"
    }
  }
}

record object

No description available.

Properties

cid string Optional

No description available.

collection string nsid Required

A namespaced identifier (e.g., app.bsky.feed.post).

did string did Required

A decentralized identifier (DID).

record ref community.lexicon.calendar.event#main Optional

No description available.

rkey string Required

No description available.

rsvps ref #hydrateRsvps Optional

No description available.

rsvpsCount integer Optional

Total rsvps count

rsvpsGoingCount integer Optional

rsvps count where status = going

rsvpsInterestedCount integer Optional

rsvps count where status = interested

rsvpsNotgoingCount integer Optional

rsvps count where status = notgoing

space string at-uri Optional

Present when the record was read from a permissioned space; its value is the space URI.

time_us integer Required

No description available.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema

{
  "type": "object",
  "required": [
    "uri",
    "did",
    "collection",
    "rkey",
    "time_us"
  ],
  "properties": {
    "cid": {
      "type": "string"
    },
    "did": {
      "type": "string",
      "format": "did"
    },
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "rkey": {
      "type": "string"
    },
    "rsvps": {
      "ref": "#hydrateRsvps",
      "type": "ref"
    },
    "space": {
      "type": "string",
      "format": "at-uri",
      "description": "Present when the record was read from a permissioned space; its value is the space URI."
    },
    "record": {
      "ref": "community.lexicon.calendar.event#main",
      "type": "ref"
    },
    "time_us": {
      "type": "integer"
    },
    "collection": {
      "type": "string",
      "format": "nsid"
    },
    "rsvpsCount": {
      "type": "integer",
      "description": "Total rsvps count"
    },
    "rsvpsGoingCount": {
      "type": "integer",
      "description": "rsvps count where status = going"
    },
    "rsvpsNotgoingCount": {
      "type": "integer",
      "description": "rsvps count where status = notgoing"
    },
    "rsvpsInterestedCount": {
      "type": "integer",
      "description": "rsvps count where status = interested"
    }
  }
}