com.atproto.repo.list Records

GET {{baseUrl}}/xrpc/com.atproto.repo.listRecords?repo=<at-identifier>&collection=<nsid>&limit=50&cursor=<string>&reverse=<boolean>

This endpoint is part of the atproto PDS repository management APIs. Requests usually require authentication (unlike the `com.atproto.sync.` endpoints), and are made directly to the user's own PDS instance.*

To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.

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

Request Params

KeyDatatypeRequiredDescription
repostring(Required) The handle or DID of the repo.
collectionstring(Required) The NSID of the record type.
limitnumberThe number of records to return.
cursorstring
reversestringFlag to reverse the order of the returned records.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;records&quot;:[{&quot;uri&quot;:&quot;\u003cat-uri\u003e&quot;,&quot;cid&quot;:&quot;\u003ccid\u003e&quot;,&quot;value&quot;:{}},{&quot;uri&quot;:&quot;\u003cat-uri\u003e&quot;,&quot;cid&quot;:&quot;\u003ccid\u003e&quot;,&quot;value&quot;:{}}],&quot;cursor&quot;:&quot;\u003cstring\u003e&quot;}