Lexicon Garden

com.atproto.repo.listRecords

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

Repository @atproto-lexicons.bsky.social did:plc:6msi3pj7krzih5qxqtryxlzw namespace authority
Details · query
Kindquery
Authorityrepo.atproto.com
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

collection

requiredstring · nsid

The NSID of the record type.

cursor

string

limit

integer

The number of records to return.

  • minimum: 1
  • maximum: 100
  • default: 50

repo

requiredstring · at-identifier

The handle or DID of the repo.

reverse

boolean

Flag to reverse the order of the returned records.

Output

application/json

cursor

string

records

requiredarray
itemsref
Reference

#record

object

Properties

cid

requiredstring · cid

uri

requiredstring · at-uri

value

requiredunknown

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • at.protocube.listRecords

    query

    List protocube records by tag (feed/tag pages, newest-indexed first) or by repository (author pages, descending record key).

  • com.atproto.sync.listReposByCollection

    query

    Enumerates all the DIDs which have records with the given collection NSID.

  • zone.stratos.sync.listRecordPaths

    query

    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 observes records within its enrolled boundaries. Intended as the fallback when the oplog (listRepoOps) returns OplogTruncated: the caller enumerates paths, diffs locally, and fetches misses. Callers must authenticate with a signed service JWT via the Authorization: Bearer header.

  • blue.moji.collection.listCollection

    query not from the namespace authority

    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.

  • rsvp.atmo.space.listRecords

    query

    List records of a given collection within a space. Access is governed by the space's collection policy.