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_...

Query Parameters

corpusType
enum<string>
required

Corpus to browse: USC, CFR, STATE, or REGULATION.

Available options:
USC,
CFR,
STATE,
REGULATION
Example:

"USC"

state
enum<string>

2-letter jurisdiction code, required for STATE and REGULATION. Case-insensitive.

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

"tx"

titleNumber
integer | null

USC/CFR title number to drill into.

Required range: x >= 1
Example:

42

code
string | null

State code identifier, e.g. tx_pe (browse /us/statutes/divisions with corpusType=STATE&state=<code> to list them).

Example:

"tx_pe"

chapter
string | null

Chapter identifier to drill into (USC and state codes).

Example:

"21"

part
string | null

Part identifier to drill into (CFR).

Example:

"240"

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
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.

cursor
string | null

Resume token from a previous response's nextCursor. Only meaningful at the level that lists sections. Omit it to start at the beginning of the container.

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, parts, codes, or sections.

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. Present only when 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.

One ordering caveat. divisions is sorted into statutory order WITHIN each response, and pages are walked in storage order, so concatenating pages does not give you one globally sorted list. The union of every page is the complete container; 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

Last modified on September 18, 2026