Skip to main content
GET
Coverage matrix by jurisdiction and corpusType

Authorizations

Authorization
string
header
required

API key issued from the developer dashboard. Pass as Authorization: Bearer vq_key_... (preferred).

Query Parameters

state
enum<string> | null

Return only this jurisdiction: a 2-letter US state code (one of the 52 supported) or federal. Case-insensitive. Omit for every jurisdiction. The unfiltered matrix runs to about a megabyte, so pass this when you are asking about one place. totalSections and stateCountWithData stay corpus-wide.

Available options:
federal,
al,
ak,
as,
az,
ar,
ca,
co,
ct,
de,
dc,
fl,
ga,
gu,
hi,
id,
il,
in,
ia,
ks,
ky,
la,
me,
md,
ma,
mi,
mn,
ms,
mo,
mt,
ne,
nv,
nh,
nj,
nm,
ny,
nc,
nd,
mp,
oh,
ok,
or,
pa,
pr,
ri,
sc,
sd,
tn,
tx,
ut,
vt,
vi,
va,
wa,
wv,
wi,
wy
Example:

"ca"

Response

Coverage legend plus per-jurisdiction corpusType counts.

What GET /us/statutes/coverage returns: the matrix under data.

Declared because the route used to return a hand-built dict with no response_model, so its published schema was {}. Every field was discoverable only if the example happened to show it, and the MCP tool and generated clients built from the document got no types at all for the one endpoint that exists to be read before anything else.

data
UsStatutesCoverageResponse · object
required

Response for GET /us/statutes/coverage.

A self-describing matrix: a legend of every corpusType token plus, for each jurisdiction, the per-corpusType ingested-document counts. Use it to learn exactly what is queryable where before calling /us/statutes/search.

meta
UsFreeCallMeta · object
required

meta on a free discovery endpoint.