---
title: "Get match"
method: GET
path: "/v0/matches/{match_id}"
tags: ["Matches"]
---

# Get match

`GET /v0/matches/{match_id}`

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

Authorized historical positive result, explanation and provenance. Recheck current access to Subscription and content; disabled state alone does not erase history. Historical content retention remains separate from search eligibility. After history_retention.alert_detail reclaims evidence, this read returns 410 evidence_expired, retryable=false. Retained identity facts still prevent duplicate alerts and link corrections. Successful reads return the original immutable evidence with the existing response shape.

## Path parameters

- `match_id` string, required

## Response `200`

Successful response

- Match: Immutable positive historical determination, not a claim of current eligibility. Unique subscription-version/record-version. Correction/withdrawal notifications reference history; no Match is fabricated for negative decisions. owner is the Subscription's owner, absent when global.
  - `match_id` string, required
  - `subscription_id` string, required
  - `subscription_version_id` string, required
  - `saved_query_id` string, required
  - `saved_query_version_id` string, required
  - `record_id` string, required
  - `record_version_id` string, required
  - `previous_match_id` string
  - `owner` string: Subscription Owner, an opaque end-user reference defined by the client application (for example user-123). Quivr stores, filters and echoes it without interpreting it. At most 128 characters without control characters; none is reserved for the listing filter. A refused owner is 422 invalid_owner, in a creation body as in the listing filter.
  - `evidence` MatchEvidence, required: Immutable evidence for a positive result, including evaluator version/configuration. History retention may expire the entire evidence payload; historical reads then return 410 evidence_expired rather than a successful response with modified evidence. Details are plugin-defined, bounded to 16 KiB and schema-validated by its adapter; core checks referenced Parts. Access is rechecked on reads.
    - `evaluator` EvaluatorConfig, required: Pins an installed evaluator by plugin id and version, and its configuration. Evaluators are the subscription Contributions of the plugins pinned at startup (Plugin Protocol v0). The configuration must satisfy the evaluator's declared configuration schema.
      - `plugin_id` string, required
      - `version` string, required
      - `configuration` object, required
    - `explanation` string, required
    - `part_keys` string[]
    - `details` object

## Other responses

- `default`: Structured error. Existing /v0 authentication, scope, pagination and idempotency semantics apply.

---

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