Backfill in-progress. Some lexicons and records may be missing or incomplete.

com.atproto.repo.listRecords

atproto-lexicons.bsky.social

Documentation

main query

List a range of records in a repository, matching a specific collection. Does not require auth.

Parameters

collection string nsid Required

The NSID of the record type.

cursor string Optional

No description provided.

limit integer Optional

The number of records to return.

repo string at-identifier Required

The handle or DID of the repo.

reverse boolean Optional

Flag to reverse the order of the returned records.

Output

Encodingapplication/json
cursor string Optional

No description provided.

records array Required

No description provided.

Try It

Direct PDS XRPC methods (com.atproto.*) are disabled in Try It for security reasons.

These methods interact directly with Personal Data Servers and require careful handling. Use a dedicated client or CLI tool instead.
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "records"
      ],
      "properties": {
        "cursor": {
          "type": "string"
        },
        "records": {
          "type": "array",
          "items": {
            "ref": "#record",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "repo",
      "collection"
    ],
    "properties": {
      "repo": {
        "type": "string",
        "format": "at-identifier",
        "description": "The handle or DID of the repo."
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "The number of records to return."
      },
      "cursor": {
        "type": "string"
      },
      "reverse": {
        "type": "boolean",
        "description": "Flag to reverse the order of the returned records."
      },
      "collection": {
        "type": "string",
        "format": "nsid",
        "description": "The NSID of the record type."
      }
    }
  },
  "description": "List a range of records in a repository, matching a specific collection. Does not require auth."
}
record object

Properties

cid string cid Required

A content identifier (CID) referencing immutable data.

uri string at-uri Required

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

value unknown Required

No description provided.

View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "cid",
    "value"
  ],
  "properties": {
    "cid": {
      "type": "string",
      "format": "cid"
    },
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "value": {
      "type": "unknown"
    }
  }
}

Lexicon Garden

@