Skip to main content
POST
Resolve many citations at once

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Batch citation resolution. See POST /us/statutes/resolve.

/resolve took 1,159 calls in the 16 days to 2026-08-31, second only to search, and every one of them carried a single citation. The caller shape it is actually serving is an agent handed a brief, a memo or a model's output with thirty citations in it, doing thirty round trips to check them.

​
citations
string[]
required

Bluebook citation strings to resolve. Duplicates are collapsed FIRST and order is preserved, so the response's results array lines up with the de-duplicated input.

The cap is 50 UNIQUE citations, applied after that collapse, so a brief quoting one section sixty times is one citation and is accepted. 500 is the raw list ceiling, which exists so an unbounded list of duplicates cannot make us walk it.

Priced PER CITATION at the single-resolve rate, exactly like POST /us/statutes/sections: batching is a round-trip and latency win, not a discount. Thirty citations cost the same 60 credits either way and take one request instead of thirty.

Required array length: 1 - 500 elements
Example:
​
state
enum<string> | null

Optional jurisdiction to resolve every citation WITHIN: a two-letter state code, or federal for the U.S. Code, the C.F.R., federal rules and the U.S. Constitution. Applies to the whole batch: a batch spanning jurisdictions should omit it and let each citation name its own. Same semantics as the single-citation route -- a constraint, not a hint.

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
Required string length: 2 - 7
Example:

"ca"

​
corpusType
enum<string> | null

Optional corpus to resolve every citation WITHIN: STATE (statutory text, federal or state), REGULATION (administrative codes), STATE_RULES (court rules), CONSTITUTION (constitutional text), STATE_CONSTITUTION (constitutional text; a synonym of CONSTITUTION here, since state is what separates the two). Same semantics as the single-citation route.

Available options:
CONSTITUTION,
REGULATION,
STATE,
STATE_CONSTITUTION,
STATE_RULES
Example:

"REGULATION"

Response

One verdict per submitted citation, in order.

Response for POST /us/statutes/resolve.

​
results
StatuteResolveBatchItem · object[]

One entry per de-duplicated input citation, in the order supplied. An unresolved citation is an entry with resolved: false, never an omission: a caller checking thirty citations needs to know which of them failed, and a shorter array cannot say.

​
resolvedCount
integer
default:0

How many of the submitted citations resolved to a code section. A citation answered only by a sessionLaw block is not counted.

Example:

2

​
count
integer
default:0

Total entries in results, after de-duplication.

Example:

3

​
processingTimeMs
number
default:0

Server-side time for this request in milliseconds.

Example:

610.2

​
creditsConsumed
number
default:0

Credits actually charged. Read it rather than multiplying the list price by your input length: a backend failure on some citations refunds those, so this can be lower than 2 x count.

Example:

6