Skip to main content
GET
Browse the statutory hierarchy

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string | null

Optional. 16 to 255 visible ASCII characters (a UUIDv4 works). Repeating the same request with the same key replays the original 2xx response for 24 hours without charging again. The same key on a different request is rejected. With the account's cacheQueryDerivedData retention setting off, no body is stored and a retry answers 409 idempotency_replay_unavailable, still without a second charge.

Required string length: 16 - 255
Pattern: ^[\x21-\x7e]+$
Example:

"3f9c2a1e-7b44-4d0a-9c1e-5a6b7c8d9e0f"

Query Parameters

corpusType
enum<string>
required

Corpus to browse. Case-insensitive. The browsable subset of the corpusType tokens on /us/statutes/coverage.

Available options:
USC,
CFR,
STATE,
REGULATION,
STATE_RULES,
CONSTITUTION,
STATE_CONSTITUTION,
FEDERAL_RULES
Example:

"USC"

state
enum<string> | null

2-letter jurisdiction code, required for the state-scoped corpora (STATE, REGULATION, STATE_RULES, STATE_CONSTITUTION). Case-insensitive.

Available options:
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:

"tx"

titleNumber

USC/CFR title number to drill into. On the U.S. Code, 5a and 18a name the Appendix to Title 5 and Title 18 (a title list returns them as their own rows).

Required range: x >= 1
Example:

42

code
string | null

Code to drill into: a state code such as tx_pe (list them with corpusType=STATE&state=<state>), a federal rule set such as frcp (list them with corpusType=FEDERAL_RULES), or a state court rule set such as HARRIS (list them with corpusType=STATE_RULES&state=<state>).

Example:

"tx_pe"

chapter
string | null

Chapter identifier to drill into (USC, CFR and state codes), or the first level inside a court rule set (a node with kind: chapter; needs code). On CFR it lists the chapter's parts (needs titleNumber); accepted alongside part, where it is not needed: part numbers are unique within a title.

Example:

"21"

part
string | null

Part to drill into: a CFR part, a U.S. Code part (Title 18 Part I, or Parts I to IX of 8 U.S.C. ch. 12 subch. II; needs titleNumber), or a part of a state code or court rule set wherever a listing returned one with kind: part (NYCRR, Mississippi and Colorado regulations and statutes, Pennsylvania court rules). On a state code or rule set it needs code.

Example:

"240"

article
string | null

Article to drill into: a constitution's article or amendment (Article III, Amendment XIV), or an article of a state code wherever a listing returned one with kind: article (New York's codes, or the UCC articles outside any chapter in Delaware Title 6), or of a court rule set (kind: article, Pennsylvania's Rules of Evidence). On a state code it can be combined with chapter to narrow to one article within that chapter. Pass the identifier exactly as the listing returned it.

Example:

"Article III"

excludeRepealed
boolean
default:false

Leave out sections whose status is affirmatively dead (repealed, superseded, renumbered and similar). A section carrying no recorded status is KEPT: a missing status is not evidence of repeal. Same vocabulary as the filter of this name on POST /us/statutes/search.

actStatus
enum<string> | null

List only sections carrying this status, e.g. repealed. The inverse of excludeRepealed, and useful for auditing what a container holds that is no longer operative.

Available options:
abolished,
deleted,
expired,
in_force,
inactive,
non_precedential,
not_funded,
not_yet_effective,
omitted,
proposed,
recodified,
recompiled,
rejected,
relocated,
removed,
renumbered,
repealed,
rescinded,
reserved,
revoked,
superseded,
terminated,
transferred,
unconstitutional,
vacant,
vacated,
vetoed,
withdrawn
subchapter
string | null

The subchapter to list, as a listing returned it (kind: subchapter): a U.S. Code subchapter (needs titleNumber and chapter), a CFR subchapter a listing returned directly under a subtitle (45 CFR Subtitle A; needs titleNumber), or a state or court-rule subchapter (needs code). Case-insensitive.

Example:

"II"

act
string | null

The act to list, as a listing returned it (kind: act): an Illinois act inside an ILCS chapter or a Pennsylvania unconsolidated act (needs code), or an Act inside a U.S. Code title's Appendix, such as Pub. L. 96-456 (needs titleNumber 5a or 18a).

Example:

"410"

title
string | null

State codes and regulations only: the title inside a code to list, as a listing returned it (kind: title), such as Title 5 of the Texas Penal Code. Needs code. A U.S. Code or CFR title is titleNumber.

Example:

"5"

subtitle
string | null

The subtitle to list, as a listing returned it (kind: subtitle): a U.S. Code or CFR subtitle such as Subtitle A of Title 26 or Subtitle B of Title 29 CFR (needs titleNumber), or a subtitle of a state code such as Subtitle B of Title 5 of the Texas Government Code (needs code and the title it sits in).

Example:

"A"

division
string | null

The division to list (kind: division): a U.S. Code division, as in Title 54 or 42 U.S.C. ch. 157 (needs titleNumber), or a division of a state code or regulation code, as in California's codes (needs code, and the levels above it that the listing returned).

Example:

"A"

subdivision
string | null

U.S. Code only: the subdivision to list (kind: subdivision, Title 54). Needs the division it belongs to.

Example:

"1"

subpart
string | null

The subpart to list (kind: subpart): a U.S. Code subpart (needs the part it belongs to and titleNumber), a CFR subpart (needs titleNumber and part), or a subpart of a state regulation code such as Louisiana's or Mississippi's (needs code, and the part it sits in). Case-insensitive.

Example:

"A"

umbrella
string | null

State regulations only: the umbrella to list (kind: umbrella), as a listing returned it. Maine groups its agencies under a department umbrella (10 is the Department of Health and Human Services). Needs code.

Example:

"10"

agency
string | null

State regulations only: the agency to list (kind: agency), as a listing returned it, such as Maine agency 144 or a Virginia agency inside a title. A chapter number repeats under different agencies, so name the agency to open the right chapter. Needs code.

Example:

"144"

program
string | null

State regulations only: the program to list (kind: program), as a listing returned it. Wyoming prints a program between an agency and its chapters, and chapter 1 repeats under every program. Needs code.

Example:

"0001"

subjectGroup
string | null

CFR only: the subject group to list (kind: subjectGroup), passed back as the heading the listing returned, or as its eCFR id (ECFR and 15 hex digits, the node's subjectGroupId), which lists the same sections and needs no subpart. Needs titleNumber and part, and the subpart when a heading names a group inside one. Case-insensitive.

Example:

"Rules of General Application"

cursor
string | null

Resume token from a previous response's nextCursor, passed back with the same filters. Omit it to start at the beginning of the listing.

Response

The child divisions at the requested level.

Response for GET /us/statutes/divisions.

corpusType
string
required

The corpus being walked, echoed back from the request.

Example:

"USC"

level
string
required

Kind of children returned: titles, chapters, subchapters, parts, subparts, subtitles, divisions, subdivisions, subjectGroups, codes, articles, acts, or sections. A listing can mix kinds; this names the main one, and kind on each node is authoritative.

state
string | null

The jurisdiction, for state-scoped corpora.

parentLabel
string | null

Human label for the container these divisions sit under.

divisions
UsDivisionNode · object[]

The child divisions, in statutory (natural) order.

count
integer
default:0

Number of divisions returned.

nextCursor
string | null

Opaque token to resume this listing. Always present: null unless truncated is true. Pass it back as cursor to get the next batch of sections in the same container, and keep going until it comes back null. Treat it as opaque: it encodes a storage position, and building one by hand will not work.

Ordering. A cursor starting o~ continues one listing in a single statutory order, so concatenating its pages gives the sorted whole. A cursor starting s~ walks a container too large to sort in one pass: each page is in statutory order, pages follow storage order, and the union of every page is the complete container, so sort it yourself once you hold it all.

Example:

"s~a3f1c2e0-55b1-4a7d-9d02-1f3b6c8e9a44"

truncated
boolean
default:false

True when this container held more sections than one call can walk, so divisions is a PREFIX of its contents rather than all of them. Check it before treating a listing as complete: the level that returns sections is bounded, and a container past that bound previously returned a short list that looked whole. When it is true, narrow the scope (drill into a chapter or part rather than a whole code), or page through it with nextCursor.

Example:

false

note
string | null

Why the result is empty, when it is. Absent on a normal result. An empty divisions with a note is an answer; without one it would be ambiguous between a bad identifier and a level this corpus does not store.

Example:

"New York statutes are organized by article, which this corpus does not index."

processingTimeMs
number
default:0

Server-side time for this request in milliseconds, excluding network transit. Useful for spotting a slow query; not billed on.

Example:

240.5

creditsConsumed
number
default:0

Credits actually charged for this call. Read it rather than assuming the list price: failed and refunded work bills 0, and batch endpoints charge per item returned, so a partial result costs less than a full one.

Example:

1