---
title: "Get received stats"
method: GET
path: "/v0/admin/stats/received"
tags: ["Admin"]
---

# Get received stats

`GET /v0/admin/stats/received`

## 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/admin/stats/received`
- Auth: HTTP bearer

Documents received by the key's Organization over the window per source namespace, in the buckets of getPluginCallStats. A document is counted when a command reserves a new revision of a Record; a replayed command or a revision the Record already had is not. Lists the limit namespaces with most documents, largest first; total and sources cover every namespace. Requires observability:read on a key that grants every Corpus.

## Query parameters

- `window` '1h' | '24h' | '7d'
- `limit` integer

## Response `200`

Successful response

- ReceivedStatsList
  - `window` '1h' | '24h' | '7d', required
  - `resolution_seconds` integer, required
  - `from` string, date-time, required
  - `to` string, date-time, required
  - `total` integer, required: Documents received from every source namespace, listed or not.
  - `sources` integer, required: Source namespaces that received at least one document, listed or not.
  - `items` ReceivedStats[], required: Most documents first.
    - `source_namespace` string, required
    - `count` integer, required
    - `points` CountPoint[], required: Non-empty buckets, oldest first.
      - `start` string, date-time, required
      - `count` integer, required

## Other responses

- `default`: Structured error; 401 unauthenticated, 403 without observability:read on every Corpus, 422 invalid_window or invalid_limit, 503 storage unavailable.

---

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