Resolve a citation to its canonical case (US + India)

Resolve a legal citation to the canonical case record. Pass countryCode=US for US citations (any Bluebook reporter), or omit / pass countryCode=IN for Indian citations.

Returns found: false (not 404) when no canonical case matches.

Cost

Jurisdiction	Cost
US (countryCode=US)	2 credits ($0.02)
India	1 credit ($0.01)

US-supported formats

Any standard Bluebook citation:

• 410 U.S. 113 — official U.S. Reports
• 603 U.S. 369 — recent SCOTUS slip cites
• 93 S. Ct. 705 — Supreme Court Reporter
• 35 L. Ed. 2d 147 — Lawyers’ Edition
• Federal reporter (F., F.2d, F.3d, F. Supp., F. Supp. 2d, F. Supp. 3d)
• State reporters (N.E.3d, S.E.2d, P.3d, Cal. Rptr., etc.)

Returns the clusterId you can pass to /citations/cases/lookup and /citations/cases/network.

India-supported formats (best to worst match rate)

• [2019] 11 SCR 706 — SCR format (direct match)
• 2023 INSC 922 — INSC neutral citation (direct match)
• (2019) 11 SCC 706 — SCC format (alias lookup, limited coverage)
• AIR 1976 SC 1207 — AIR format (alias lookup, limited coverage)

AIR and SCC citations may not resolve correctly because the underlying data uses SCR page numbers.

For more details, see the API Reference.

GET /api/v1/citations/resolve

Resolve a citation to its canonical case (US + India)

cURL

curl --request GET \
  --url https://api.vaquill.ai/api/v1/citations/resolve \
  --header 'Authorization: Bearer <token>'

200

us

{ "data": { "citation": "410 U.S. 113", "clusterId": 108713, "caseName": "Roe v. Wade", "dateFiled": "1973-01-22", "absoluteUrl": "https://app.vaquill.ai/research/cases/108713" }, "meta": { "processingTimeMs": 1487.6, "creditsConsumed": 2, "creditsRemaining": 4998 } }

Authorizations

Authorization · string · header · required

API key issued from the Vaquill developer dashboard. Pass as Authorization: Bearer vq_key_...

Query Parameters

citation · string · required

Citation to resolve

Required string length: 3 - 200

countryCode · string | null

ISO 3166-1 alpha-2 country code (e.g. IN for India). Reserved for future multi-jurisdiction support. Currently the dataset covers India only, so requests for other country codes will return empty results naturally from the database.

Response

200

application/json

Citation resolved (or found=false). The response shape differs between US and India.

Top-level response for GET /citations/resolve.

data · ResolveData · object · required

Data payload for the resolve endpoint.

Show child attributes

meta · CitationApiMeta · object · required

Metadata returned with every citation API response.

Show child attributes