Look up full case details (US + India)

Full case detail by citation, or (US only) directly by clusterId.

Returns case name, court, panel of judges, disposition, all parallel citations, and (US only) up to 50K characters of the lead opinion’s plain text. India responses additionally include treatment statistics (followed, distinguished, overruled counts).

Cost

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

Pick your lookup key

• clusterId — US only. Fastest. Skip the resolve step. Get clusterId values from /citations/resolve or /research/search results.
• citation — works for both jurisdictions. We resolve it internally before lookup.

Returns 404 if neither key resolves to a case.

For more details, see the API Reference.

GET /api/v1/citations/cases/lookup

Look up full case details (US + India)

cURL

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

200

us

{ "data": { "clusterId": 108713, "caseName": "Roe v. Wade", "caseNameFull": "Roe et al. v. Wade, District Attorney of Dallas County", "citations": [ "410 U.S. 113", "93 S. Ct. 705", "35 L. Ed. 2d 147", "1973 U.S. LEXIS 159" ], "dateFiled": "1973-01-22", "disposition": "", "judges": [ "Blackmun", "Burger", "Douglas", "Brennan", "Stewart", "Marshall", "Powell", "White", "Rehnquist" ], "citeCount": 5579, "opinionText": "Mr. Justice Blackmun delivered the opinion of the Court. This Texas federal appeal and its Georgia companion...", "absoluteUrl": "https://app.vaquill.ai/research/cases/108713" }, "meta": { "processingTimeMs": 2836.8, "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 | null

Citation to look up. For India: SCR / INSC / SCC / AIR. For US: any Bluebook citation, or use clusterId instead.

Required string length: 3 - 200

clusterId · integer | null

US only. Vaquill case cluster ID. Alternative to citation.

Required range: x >= 1

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

Full case detail. Response shape differs between US and India.

Top-level response for GET /citations/cases/lookup.

data · PublicCaseDetail · object · required

Extended case with aliases and treatment stats (for lookup endpoint).

Show child attributes

meta · CitationApiMeta · object · required

Metadata returned with every citation API response.

Show child attributes