List records
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.
Request
- Base URLhttps://docs.quivr.thevibecompany.co (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Query parameters
Comma-separated selection of up to 16 distinct Corpora. Supply exactly one of corpus_id or corpus_ids.
JSON array of MetadataFilter predicates, at most 16. Applied before ordering and pagination to current Versions projected in the routed generation. Withdrawn Records can be omitted after projection purge or rebuild; use the unfiltered catalog for full resynchronization. Repeat on later pages. Filters require a metadata-capable generation; rebuild older Corpora first.
Inclusive lower bound on the current Version's acceptance time. RFC 3339 with an offset and at most 9 fractional-second digits; clients convert local days into bounds. Quivr applies no time-zone rules.
Exclusive upper bound on the current Version's acceptance time. RFC 3339 with an offset and at most 9 fractional-second digits.
The most items to return. An empty, non-integer or out-of-range value is 422 invalid_limit.
Response
Successful response
Changes
No recorded changes to this operation across all 1 revision of this API.