Quick search for bots (US + India)

Compact bot-friendly variant of /research/search. Returns the top topK (default 3, max 5) results in a flat shape with title, summary, citation, and a PDF / page URL.

Designed for messaging bots (WhatsApp, Telegram, Slack) where you need the answer in three short cards instead of a 20-row paginated list.

Set filters.countryCode to choose the jurisdiction:

• "US" — 8M+ US federal and state opinions. 2 credits ($0.02).
• "IN" — Indian SC / HC corpus. 1 credit ($0.01).

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

POST /api/v1/research/quick

Quick search for bots (US + India)

cURL

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

200

us

{ "results": [ { "title": "State v. Gamez", "citation": "824 S.E.2d 904", "court": "Court of Appeals of North Carolina", "year": 2019, "summary": "DAVIS, Judge. *468 In this case, we reexamine the circumstances under which Miranda warnings are required when a member of the armed forces is questioned by his superior...", "pdfUrl": "https://app.vaquill.ai/research/cases/4601023" } ], "meta": { "total": 3, "query": "Miranda warning custody interrogation", "creditsConsumed": 2, "creditsRemaining": 4998, "processingTimeMs": 2707.2 } }

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 bot-friendly quick search (WhatsApp, Telegram, etc.).

query · string · required

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

Required string length: 1 - 10000

Example:

"Section 302 IPC murder conviction"

topK · integer · default: 3

Number of results to return (1-5). Default 3.

Required range: 1 <= x <= 5

Example:

3

filters · SearchFilters · object

Optional filters to narrow results.

Show child attributes

Response

200

application/json

Top matching results, ordered by relevance.

Bot-friendly quick search response. Flat structure optimized for messaging bots.

results · BotSearchResult · object[] · required

Top matching legal document passages.

Show child attributes

meta · BotSearchMeta · object · required

Metadata for bot-friendly quick search response.

Show child attributes