Skip to main content
POST
/
api
/
v1
/
statutes
/
search
Search US statutes, constitutions, court rules, and executive actions
curl --request POST \
  --url https://api.vaquill.ai/api/v1/statutes/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>"
}
'
{
  "results": [
    {
      "actId": "<string>",
      "citation": "<string>",
      "citationShort": "<string>",
      "title": "<string>",
      "corpusType": "<string>",
      "state": "<string>",
      "year": 123,
      "relevanceScore": 0,
      "excerpt": "",
      "titleNumber": 123,
      "titleName": "<string>",
      "chapter": "<string>",
      "chapterName": "<string>",
      "sectionNumber": "<string>",
      "displayPath": "<string>",
      "breadcrumb": [
        {}
      ],
      "htmlUrl": "<string>",
      "pdfUrl": "<string>",
      "xmlUrl": "<string>",
      "textUrl": "<string>",
      "docxUrl": "<string>",
      "stateHtmlUrl": "<string>",
      "govInfoHtmlUrl": "<string>",
      "govInfoPdfUrl": "<string>",
      "externalUrl": "<string>"
    }
  ],
  "total": 0,
  "query": "",
  "processingTimeMs": 0,
  "creditsConsumed": 0
}

Documentation Index

Fetch the complete documentation index at: https://vaquill.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Body

application/json
query
string
required

Search query in natural language.

Required string length: 2 - 500
Example:

"insider trading penalties"

corpusType
enum<string> | null

Restrict to one corpus. One of: USC (United States Code), CFR (Code of Federal Regulations), STATE (state statutes — 41 states currently ingested), CONSTITUTION (U.S. Constitution), FEDERAL_RULES (FRCP / FRCrP / FRE / FRAP / FRBP), STATE_CONSTITUTION (state constitutions, currently CA/VA/NC/WI), STATE_RULES (state court rules, currently CA), EXECUTIVE_ACTION (Federal Register Presidential Documents). Omit to search across all corpora.

Available options:
USC,
CFR,
STATE,
CONSTITUTION,
FEDERAL_RULES,
STATE_CONSTITUTION,
STATE_RULES,
EXECUTIVE_ACTION
Example:

"CFR"

state
string | null

2-letter state code (lowercase, e.g. ca, tx, ny) used to filter state corpora. Ignored when corpusType is USC, CFR, CONSTITUTION, FEDERAL_RULES, or EXECUTIVE_ACTION.

Required string length: 2
Example:

"ca"

titleNumber
integer | null

Filter by USC/CFR title number (e.g., 17 for SEC, 42 for civil rights). Only meaningful for USC/CFR; ignored for state corpora whose titles are alphabetic (e.g. Texas pe = Penal Code).

Example:

17

limit
integer
default:10

Number of results to return.

Required range: 1 <= x <= 50

Response

Successful Response

results
StatuteResult · object[]
total
integer
default:0

Total results found.

query
string
default:""

The search query used.

processingTimeMs
number
default:0
creditsConsumed
number
default:0