Skip to main content
GET
Get the sections around this one

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"

Path Parameters

act_id
string
required

Section identifier, e.g. USC_T42_C21_S1983 (42 U.S.C. § 1983). Take it from a /us/statutes/search, /resolve or /divisions result; do not assemble one. A citation such as 42 USC 1983 also works and adds the /resolve price (see GET /us/statutes/section/{actId}). State session laws (SSL_ ids) are read at /us/session-laws/{sessionLawId}.

Required string length: 3 - 200
Example:

"USC_T42_C21_S1983"

Query Parameters

limit
integer
default:3

How many sections to return on EACH side.

Required range: 1 <= x <= 10
Example:

3

Response

The section plus its neighbours.

Response for GET /us/statutes/section/{act_id}/related.

section
StatuteResult · object
required

The section you asked about.

previous
StatuteResult · object[]

Sections immediately BEFORE this one in the same container, nearest last.

next
StatuteResult · object[]

Sections immediately AFTER this one, nearest first.

container
string | null

Human label for the grouping the neighbours were drawn from, e.g. the chapter name. Neighbours never cross this boundary.

truncated
boolean
default:false

True when previous or next may be incomplete: the container was larger than the scan bound, the section was not found in its own container, or a neighbouring section could not be loaded. note says which. When false, an empty next really is the last section of the container and an empty previous the first (the container, not necessarily the code; see note).

note
string | null

Set when truncated is true, and also when the section is the first or last of its container (an empty side then means the container ended, not the code: adjacent chapters, parts and titles are not traversed). Never read an empty previous or next as the edge of the code while this is set.

resolvedFrom
SectionIdentifierResolution · object | null

Null when the section is exactly the act_id you sent. Otherwise how your input was matched: a citation, or an act_id with transport damage (whitespace, quotes, a trailing period) removed. When your citation named a supported container (a regulation series, constitution article, Indiana chapter or Illinois article) or several sections, the section served is the FIRST of them and matchLevel says so, as on GET /us/statutes/resolve.

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, after any refund. Failed work bills 0 and batch endpoints charge per item returned.

Example:

4