# rsvp.atmo.rsvp.listRecords

> Published by [atmo.rsvp](https://lexicon.garden/identity/did:plc:b63bmauox6z5rbibwrhxrdnw)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:b63bmauox6z5rbibwrhxrdnw/rsvp.atmo.rsvp.listRecords)
- [Documentation](https://lexicon.garden/lexicon/did:plc:b63bmauox6z5rbibwrhxrdnw/rsvp.atmo.rsvp.listRecords/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:b63bmauox6z5rbibwrhxrdnw/rsvp.atmo.rsvp.listRecords/examples)

## Definitions

### `rsvp.atmo.rsvp.listRecords`

**Type**: `query`

Query community.lexicon.calendar.rsvp records with filters

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `sort` | `string` | No | Field to sort by (default: time_us) |
| `actor` | `string` (at-identifier) | No | Filter by DID or handle (triggers on-demand backfill) |
| `limit` | `integer` | No |  |
| `order` | `string` | No | Sort direction (default: desc for dates/numbers/counts, asc for strings) |
| `byUser` | `string` (did) | No | Only used with spaceUri — filter to records authored by this DID. |
| `cursor` | `string` | No |  |
| `status` | `string` | No | Filter by status |
| `profiles` | `boolean` | No | Include profile + identity info keyed by DID |
| `spaceUri` | `string` (at-uri) | No | If set, query records inside this permissioned space (requires service-auth JWT). |
| `subjectUri` | `string` | No | Filter by subject.uri |
| `hydrateEvent` | `boolean` | No | Embed the referenced event record |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cursor` | `string` | No |  |
| `records` | `array` | Yes |  |
| `profiles` | `array` | No |  |

### `rsvp.atmo.rsvp.listRecords#record`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` | No |  |
| `did` | `string` (did) | Yes |  |
| `uri` | `string` (at-uri) | Yes |  |
| `rkey` | `string` | Yes |  |
| `event` | `ref` → `#refEventRecord` | No |  |
| `space` | `string` (at-uri) | No | Present when the record was read from a permissioned space; its value is the space URI. |
| `record` | `ref` → `community.lexicon.calendar.rsvp#main` | No |  |
| `time_us` | `integer` | Yes |  |
| `collection` | `string` (nsid) | Yes |  |

### `rsvp.atmo.rsvp.listRecords#profileEntry`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` | No |  |
| `did` | `string` (did) | Yes |  |
| `uri` | `string` (at-uri) | No |  |
| `rkey` | `string` | No |  |
| `handle` | `string` | No |  |
| `record` | `ref` → `#appBskyActorProfile` | No |  |
| `collection` | `string` (nsid) | No |  |

### `rsvp.atmo.rsvp.listRecords#refEventRecord`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` | No |  |
| `did` | `string` (did) | Yes |  |
| `uri` | `string` (at-uri) | Yes |  |
| `rkey` | `string` | Yes |  |
| `space` | `string` (at-uri) | No | Present when the record was read from a permissioned space. |
| `record` | `ref` → `community.lexicon.calendar.event#main` | No |  |
| `time_us` | `integer` | Yes |  |
| `collection` | `string` (nsid) | Yes |  |

### `rsvp.atmo.rsvp.listRecords#appBskyActorProfile`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `avatar` | `blob` | No | Small image to be displayed next to posts from account. AKA, 'profile picture' |
| `banner` | `blob` | No | Larger horizontal image to display behind profile view. |
| `labels` | `union` | No | Self-label values, specific to the Bluesky application, on the overall account. |
| `website` | `string` (uri) | No |  |
| `pronouns` | `string` | No | Free-form pronouns text. |
| `createdAt` | `string` (datetime) | No |  |
| `pinnedPost` | `ref` → `com.atproto.repo.strongRef` | No |  |
| `description` | `string` | No | Free-form profile description text. |
| `displayName` | `string` | No |  |
| `joinedViaStarterPack` | `ref` → `com.atproto.repo.strongRef` | No |  |

## Raw Schema

```json
{
  "id": "rsvp.atmo.rsvp.listRecords",
  "defs": {
    "main": {
      "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": {
          "sort": {
            "type": "string",
            "description": "Field to sort by (default: time_us)",
            "knownValues": [
              "status",
              "subjectUri"
            ]
          },
          "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"
          },
          "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)."
          },
          "subjectUri": {
            "type": "string",
            "description": "Filter by subject.uri"
          },
          "hydrateEvent": {
            "type": "boolean",
            "description": "Embed the referenced event record"
          }
        }
      },
      "description": "Query community.lexicon.calendar.rsvp records with filters"
    },
    "record": {
      "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"
        },
        "event": {
          "ref": "#refEventRecord",
          "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.rsvp#main",
          "type": "ref"
        },
        "time_us": {
          "type": "integer"
        },
        "collection": {
          "type": "string",
          "format": "nsid"
        }
      }
    },
    "profileEntry": {
      "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"
        }
      }
    },
    "refEventRecord": {
      "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.event#main",
          "type": "ref"
        },
        "time_us": {
          "type": "integer"
        },
        "collection": {
          "type": "string",
          "format": "nsid"
        }
      }
    },
    "appBskyActorProfile": {
      "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"
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```