---
title: "List records"
method: GET
path: "/v0/records"
tags: ["Records"]
---

# List records

`GET /v0/records`

## Request

- Base URL: `https://docs.quivr.thevibecompany.co` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.quivr.thevibecompany.co/v0/records`
- Auth: HTTP bearer

List authorized canonical Records from one or several Corpora. Without metadata predicates the catalog includes withdrawn Records. Metadata predicates require the current Version to be projected in the routed generation; withdrawn Records can disappear from filtered pages after projection purge or rebuild. Use the unfiltered catalog and change feed for complete resynchronization. Metadata equality and datetime-range pages use scoped indexes and bounded reads. A filter that exceeds the bounded read budget returns 422 filter_too_broad with retryable false; narrow the metadata or acceptance-time range before sending another request. No partial page is returned. The default record_id order is ascending byte-wise ID order for resynchronization. accepted_at_desc orders by the current Version's acceptance time, newest first, then by Record ID descending for ties. A correction moves the Record when its replacement Version becomes current. Records without a current Version have no acceptance time; they appear last in unbounded date listings and are excluded by either time bound. Bounds also work with the default ID order. Equal bounds select an empty range; reversed bounds, malformed dates, duplicate or unknown parameters and unknown orders return 422 invalid_query. The opaque page cursor binds Corpus selection, authorization scope, order, time bounds and metadata predicates with their routed generations; changing any returns 409 cursor_scope_changed with resync_url. Repeat the same parameters for subsequent pages. Newer arrivals between pages do not shift the keyset or duplicate previously listed Records. Each page is an independent read, not a historical snapshot: concurrent corrections, withdrawals and readiness changes are reconciled through the change feed. Capture a start-now Change Cursor before scanning and consume changes as invalidations by rereading current resources. This route, relative to the API base, is the resync_url of catalog cursor errors.

## Query parameters

- `corpus_id` string
- `corpus_ids` string[]
- `metadata` string
- `order` 'record_id' | 'accepted_at_desc'
- `accepted_after` string, date-time
- `accepted_before` string, date-time
- `page_cursor` string
- `limit` integer

## Response `200`

Successful response

- RecordPage
  - `excluded_corpora` CorpusExclusion[]
    - `corpus_id` string, required
    - `fields` string[], required
  - `items` Record[], required
    - `record_id` string, required
    - `source` SourceIdentity, required
      - `corpus_id` string, required
      - `namespace` string, required
      - `record_key` string, required
    - `withdrawn` boolean, required
    - `current_version_id` string
  - `next_page_cursor` string

## Other responses

- `default`: Structured error; see contract HTTP mapping.

---

[API](https://skmtc.dev/thevibecompany/apis/quivr-http-api.md) - [All operations](https://skmtc.dev/thevibecompany/apis/quivr-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thevibecompany/apis/quivr-http-api/revisions/4f4e30ba8f4e?raw)