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

# Get match stats

`GET /v0/admin/stats/matches`

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

Matches the Subscriptions of the key's Organization committed over the window, per evaluator plugin, in the buckets of getPluginCallStats. A Match that corrects an earlier one on a new Version of the same Record counts too. Requires observability:read on a key that grants every Corpus.

## Query parameters

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

## Response `200`

Successful response

- MatchStatsList
  - `window` '1h' | '24h' | '7d', required
  - `resolution_seconds` integer, required
  - `from` string, date-time, required
  - `to` string, date-time, required
  - `total` integer, required: Matches of every evaluator.
  - `items` MatchStats[], required: Most Matches first.
    - `evaluator` string, required: Plugin id of the evaluator of the Subscriptions that matched.
    - `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, 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)