Skip to main content
POST
Resolve up to 50 citations

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 is ideal). A retry with the same key and the same request replays the original 2xx response for 24 hours without charging again. The same key with a different request is rejected. Scope is the API key, method, path and body.

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

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

Body

application/json

Up to 50 citations, priced per citation.

citations
string[]
required

Citation strings, as a lawyer would type them.

Minimum array length: 1
Example:
state
enum<string> | null

Narrow to one jurisdiction. Required for a State-universal title.

Available options:
andaman-and-nicobar-islands,
andaman-nicobar,
andhra-pradesh,
arunachal-pradesh,
assam,
bihar,
central,
chandigarh,
chhattisgarh,
dadra-and-nagar-haveli-and-daman-and-diu,
dadra-nagar-haveli,
delhi,
goa,
gujarat,
haryana,
himachal-pradesh,
jammu-and-kashmir,
jammu-kashmir,
jharkhand,
karnataka,
kerala,
ladakh,
lakshadweep,
madhya-pradesh,
maharashtra,
manipur,
meghalaya,
mizoram,
nagaland,
odisha,
puducherry,
punjab,
rajasthan,
sikkim,
tamil-nadu,
telangana,
tripura,
uttar-pradesh,
uttarakhand,
west-bengal
Example:

"maharashtra"

asAtDate
string<date>

The date the conduct or document belongs to, as YYYY-MM-DD. This is how a caller says which side of the 2023 recodification they mean: without it, a criminal section number resolves to BOTH the old code and its replacement, because both are live law.

Example:

"2019-05-01"

Response

Successful Response

results
ResolveItem · object[]
required
count
integer
required
resolvedCount
integer
required
meta
Meta · object
required