com.atproto.repo.listRecords
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "List a range of records in a repository, matching a specific collection. Does not require auth.",
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"cursor": {
"type": "string"
},
"records": {
"items": {
"ref": "#record",
"type": "ref"
},
"type": "array"
}
},
"required": [
"records"
],
"type": "object"
}
},
"parameters": {
"properties": {
"collection": {
"description": "The NSID of the record type.",
"format": "nsid",
"type": "string"
},
"cursor": {
"type": "string"
},
"limit": {
"default": 50,
"description": "The number of records to return.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"repo": {
"description": "The handle or DID of the repo.",
"format": "at-identifier",
"type": "string"
},
"reverse": {
"description": "Flag to reverse the order of the returned records.",
"type": "boolean"
}
},
"required": [
"repo",
"collection"
],
"type": "params"
},
"type": "query"
},
"record": {
"properties": {
"cid": {
"format": "cid",
"type": "string"
},
"uri": {
"format": "at-uri",
"type": "string"
},
"value": {
"type": "unknown"
}
},
"required": [
"uri",
"cid",
"value"
],
"type": "object"
}
},
"id": "com.atproto.repo.listRecords",
"lexicon": 1
}
Metadata
- DID
-
did:plc:6msi3pj7krzih5qxqtryxlzw - CID
-
bafyreihv666jp6lxncj6amcgsu5qrvwq4rwmtc7xbxzndxqdwxamlsatee - Indexed At
- 2026-02-18 18:57 UTC
- AT-URI
-
at://did:plc:6msi3pj7krzih5qxqtryxlzw/com.atproto.lexicon.schema/com.atproto.repo.listRecords
Similar Lexicons
Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Enumerates all the DIDs which have records with the given collection NSID.
-
Full-state recovery: enumerate a repo's record paths and their current CIDs, mirroring listRecords semantics. Record values are inlined by default; excludeValues returns metadata only. Boundary-gated: the caller only ob…
-
List a range of Bluemoji in a repository. Public read: pass 'repo' to browse any repo's collection. If 'repo' is omitted, the caller must be authenticated and their own collection is listed.
-
List records of a given collection within a space. Access is governed by the space's collection policy.
-
Get a single record from a repository. Does not require auth.