Search the legal corpus (US + India)

Boolean keyword search across the legal corpus.

Set filters.countryCode to choose the jurisdiction:

• "US" (recommended) — 8M+ US federal and state opinions (SCOTUS, all 13 federal circuits, district courts, state supreme + appellate courts, federal administrative courts).
• "IN" — Indian Supreme Court and High Court judgments.
• Omit to default to India for backward compatibility.

Authentication: API key via Authorization: Bearer vq_key_...

Cost is tiered by pageSize:

Jurisdiction	pageSize 1-20	pageSize 21-50	pageSize 51-100
US (countryCode=US)	2 credits ($0.02)	4 credits ($0.04)	6 credits ($0.06)
India	1 credit ($0.01)	2 credits ($0.02)	3 credits ($0.03)

Boolean operators

• AND: qualified immunity AND excessive force
• OR: Section 1983 OR Bivens
• NOT: Miranda NOT custody
• Phrases: "reasonable expectation of privacy"
• Grouping: (murder OR homicide) AND (intent OR malice)

US-specific filters

When countryCode=US, the following filters keys narrow the search within the US corpus:

• court — e.g. "scotus", "ca9", "nysd", "cal" (comma-separated allowed)
• jurisdiction — "federal" or "state" (overridden by court when both set)
• dateFiledAfter / dateFiledBefore — YYYY-MM-DD
• citedGt — minimum forward-citation count (surface authoritative cases)

For more details, see the API Reference.

POST /api/v1/research/search

Search the legal corpus (US + India)

cURL

curl --request POST \
  --url https://api.vaquill.ai/api/v1/research/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>"
}
'

200

us

{ "data": { "results": [ { "id": "4687948", "content": "[Cite as Leonhardt v. Akron, 2019-Ohio-5223.]\\n\\nSTATE OF OHIO ... APPEAL FROM JUDGMENT ENTERED IN THE COURT OF COMMON PLEAS COUNTY OF SUMMIT...", "title": "Leonhardt v. Akron", "court": "Ohio Court of Appeals", "year": 2019, "citation": "2019 Ohio 5223", "score": 88.05, "snippet": "[Cite as Leonhardt v. Akron, 2019-Ohio-5223.] STATE OF OHIO ... NINTH JUDICIAL DISTRICT...", "metadata": { "pdfUrl": "https://app.vaquill.ai/research/cases/4687948", "decisionDate": "2019-12-18" } } ] }, "meta": { "total": 21571, "page": 1, "pageSize": 3, "totalPages": 7191, "processingTimeMs": 1568.5, "query": "qualified immunity AND excessive force", "creditsConsumed": 2, "creditsRemaining": 88339 } }

Authorizations

Authorization · string · header · required

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

Body

application/json

Request body for external research search.

query · string · required

Boolean search query. Supports AND, OR, NOT operators and quoted phrases.

Required string length: 1 - 10000

Example:

"murder AND conviction"

filters · SearchFilters · object

Optional filters to narrow results.

Show child attributes

page · integer · default: 1

Page number for pagination (max 50).

Required range: 1 <= x <= 50

Example:

1

pageSize · integer · default: 20

Results per page (1-100).

Required range: 1 <= x <= 100

Example:

20

Response

200

application/json

Search results. Field shape is the same for US and India; metadata fields populated depend on jurisdiction.

Top-level response for external search.

data · SearchData · object · required

Wrapper for search results.

Show child attributes

meta · SearchMeta · object · required

Metadata for search response.

Show child attributes