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

# Count records

`GET /v0/records/count`

## 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/count`
- Auth: HTTP bearer

Count of one Corpus's authorized Records. Time-bounded counts are exact within a two-second query budget; larger windows return non-retryable 422 record_count_too_broad and require narrower bounds. Unbounded counts probe at most 10001 identities: up to 10000 are exact, larger Corpora return stored catalog totals with approximate=true. complete=false means initialization has not finished; incomplete zeros must not be presented as empty. observed_at names the independent read snapshot. Includes withdrawn Records, as the listing does. Records without a current Version are counted only when neither bound is supplied. Uses content:read and the same Corpus scope as listRecords. This is an independent read, not a snapshot shared with listing pages. Equal bounds count zero; reversed bounds, malformed dates, duplicate or unknown parameters return 422 invalid_query.

## Query parameters

- `corpus_id` string, required
- `accepted_after` string, date-time
- `accepted_before` string, date-time

## Response `200`

Successful response

- RecordCount
  - `count` integer, required
  - `observed_at` string, date-time
  - `approximate` boolean
  - `complete` boolean

## 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)