---
title: "Get Coverage"
method: GET
path: "/api/v1/classification/coverage"
tags: ["classification"]
---

# Get Coverage

`GET /api/v1/classification/coverage`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/classification/coverage`
- Auth: API key in header `X-API-Key`

Coverage summary for the classification brain.

Returns total / classified / unclassified counts, confidence-tier
distribution, and a top-K sample of unclassified entity names. The
agent tokenizes the sample natively (no server-side tokenization).

## Query parameters

- `state` string, nullable: Two-letter state code (CO, FL, VA, NY); omit for cross-state
- `sector` string, nullable: industry_sector to scope; omit for all sectors
- `top_tokens` integer: How many top unclassified entity names to return for token-mining

## Response `200`

Successful Response

- CoverageResponse
  - `state` string, nullable, required
  - `sector` string, nullable, required
  - `total` integer, required
  - `classified` integer, required
  - `unclassified` integer, required
  - `classified_pct` number, required
  - `by_confidence_tier` object, required
  - `sample_unclassified` object[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)