Authentication

API key authentication for the Vaquill API

The Vaquill API gives you programmatic access to case law search, citation resolution, and the citation network. Use it to power legal research in your own product or internal tools.

API Keys

All requests require an API key in the Authorization header:

Authorization: Bearer vq_key_your_api_key_here

Keys use the vq_key_ prefix and are tied to your account.

Get Your API Key

1. Sign in

   Go to app.vaquill.ai/settings.

2. Create a key

   Under API Keys, click Create API Key. Copy the key immediately. It won’t be shown again.

Postman Collection

Import the public collection to start testing endpoints immediately:

Example Requests

cURL

curl -X POST https://api.vaquill.ai/api/v1/research/search \
  -H "Authorization: Bearer vq_key_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"query": "right to privacy fundamental rights"}'

Error Codes

Code	Meaning
401	Invalid or missing API key
402	Insufficient credits
429	Rate limit exceeded

Never expose your API key in client-side code or public repositories. If compromised, revoke it from your dashboard and generate a new one immediately.

Rotate keys on a schedule. Generate a new key, deploy it to your application, then revoke the old one. Vaquill supports multiple live keys per workspace so you can rotate without downtime.

Related

Credits and pricing

Per-endpoint costs, credit packs, and bulk pricing.

Errors

HTTP status codes and how to recover from each.

API Reference

Every endpoint with parameters, examples, and an interactive playground.

Vaquill MCP

Skip the API and call Vaquill from Claude, Cursor, or any MCP client.