---
title: "Real-time inventory of the indexed corpus"
method: GET
path: "/api/v1/corpus/coverage"
tags: ["Discovery"]
---

# Real-time inventory of the indexed corpus

`GET /api/v1/corpus/coverage`

## Request

- Base URL: `https://legal.nexusquantum.legal`
- URL: `https://legal.nexusquantum.legal/api/v1/corpus/coverage`
- Auth: HTTP bearer

Returns the current state of the case-law corpus: number of tables, total documents, jurisdiction inferred per table, date range and top sources with counts. AUTO-DISCOVERABLE: when a new `jurisprudencia_<iso>` table with embeddings is added to Supabase, it shows up here with no code changes. Useful for clients (dashboards, MCP, agents) to build coverage UIs without hardcoding anything. Cache: 5 min server-side + `Cache-Control` 5 min on the response. Requires an API key with any valid scope (does not consume credits).

## Response `200`

Corpus inventory.

- object
  - `generatedAt` string, date-time, required
  - `cacheTtlSeconds` integer, required
  - `totalDocs` integer, required: Sum of docs across ALL tables.
  - `totalTables` integer, required
  - `tables` object[], required
    - `table` string
    - `inferredJurisdiction` string, nullable
    - `totalDocs` integer
    - `oldestDoc` string, date, nullable
    - `newestDoc` string, date, nullable
    - `topSources` object[]
      - `source` string
      - `count` integer
    - `sourceColumn` string, nullable: Column used to group topSources.

## Other responses

- `401`: Invalid API key.

---

[API](https://skmtc.dev/nexusquantum/apis/nexus-legal-api.md) · [All operations](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nexusquantum/apis/nexus-legal-api/revisions/4084d8d4eb0b?raw)