com.atproto.repo.listRecords Documentation (EN)

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 available.

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 available.

records array Required

No description available.

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

No description available.

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 available.

View raw schema

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