---
title: "List a range of records in a repository, matching a specific collection. Does not require auth."
method: GET
path: "/xrpc/com.atproto.repo.listRecords"
tags: ["com.atproto.repo"]
---

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

`GET /xrpc/com.atproto.repo.listRecords`

## Query parameters

- `repo` string, at-identifier, required — The handle or DID of the repo.
- `limit` integer — The number of records to return.
- `cursor` string
- `reverse` boolean — Flag to reverse the order of the returned records.
- `collection` string, nsid, required — The NSID of the record type.

## Response `200`

Success

- object
  - `cursor` string
  - `records` ComAtprotoRepoListRecordsRecord[], required
    - `cid` string, cid, required
    - `uri` string, uri, required
    - `value` unknown, required

## Changes

- **2026-07-12** `0b39d9ed30de` — 1 info
  - endpoint added
- **2026-07-12** `cd8902e185b6` — 1 breaking
  - api path removed without deprecation
- **2026-04-20** `3353f5f6354a` — 1 info
  - endpoint added
- **2026-04-20** `f6e6f5a5a3cb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema/changes/xrpc/com.atproto.repo.listRecords/get.md)

---

[API](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema.md) · [All operations](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streamplace/generated-lexicon-api-schema/revisions/8e2ce7f5d85b/schema)