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>"
}
'

import requests

url = "https://api.vaquill.ai/api/v1/statutes/search"

payload = { "query": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: '<string>'})
};

fetch('https://api.vaquill.ai/api/v1/statutes/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vaquill.ai/api/v1/statutes/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "results": [
    {
      "actId": "CFR_T17_P240_S240_10b5_1",
      "citation": "17 C.F.R. § 240.10b5-1 (2026)",
      "citationShort": "17 C.F.R. § 240.10b5-1",
      "title": "Trading on the basis of material nonpublic information in insider trading cases",
      "corpusType": "CFR",
      "state": "federal",
      "year": 2026,
      "relevanceScore": 0.91,
      "excerpt": "The manipulative and deceptive devices prohibited by section 10(b)...",
      "titleNumber": 17,
      "sectionNumber": "240.10b5-1",
      "displayPath": "Title 17 CFR > Chapter II > Part 240 > Section 240.10b5-1",
      "htmlUrl": "https://statutes-us.vaquill.ai/ecfr/...",
      "externalUrl": "https://www.ecfr.gov/..."
    }
  ],
  "total": 1,
  "query": "insider trading material nonpublic information",
  "processingTimeMs": 412.3,
  "creditsConsumed": 4
}

{
  "detail": "Insufficient credits"
}

{
  "detail": "Validation error"
}

Search US statutes, constitutions, court rules, and executive actions

Search across federal and state law and get back the most relevant sections with citations and links to official source documents.

Corpora (corpusType):

USC: United States Code (54,855 sections)
CFR: Code of Federal Regulations (219,403 sections)
STATE: State statutory codes, 49 states plus DC and Puerto Rico. Call /statutes/states for live coverage and /statutes/codes for a state’s codes; see the Coverage page for the full breakdown.
CONSTITUTION: U.S. Constitution (Articles I-VII + 27 Amendments)
FEDERAL_RULES: FRCP, FRCrP, FRE, FRAP, FRBP (297 sections)
STATE_CONSTITUTION: state constitutions (41 jurisdictions)
STATE_RULES: state court rules (AZ, CA, IL, MD, MN, NV, PA)
EXECUTIVE_ACTION: Federal Register Presidential Documents (Executive Orders, Proclamations, Memos; 2015 to today, refreshed daily)
REGULATION: state administrative regulations (pair with state; call /statutes/states for coverage)
FEDERAL_REGISTER: Federal Register agency rules, final and proposed
AGENCY_GUIDANCE: agency guidance (SSA rulings, IRS notices, revenue rulings and procedures)

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

Cost: 4 credits per call (see /api-credits/pricing). Failed calls are not charged.

Pagination: use limit (page size, max 50) with offset (max 40); check hasMore in the response to page forward.

Returns relevant sections with full metadata: citation, title hierarchy, and direct links to official source documents where available.

Examples

# Search SEC regulations
requests.post(url, headers=h, json={
    "query": "insider trading material nonpublic information",
    "corpusType": "CFR",
    "titleNumber": 17,
    "limit": 5,
})

# Search California state statutes
requests.post(url, headers=h, json={
    "query": "shareholder derivative action standing",
    "corpusType": "STATE",
    "state": "ca",
})

# Search Executive Orders on a topic
requests.post(url, headers=h, json={
    "query": "AI safety federal agency adoption",
    "corpusType": "EXECUTIVE_ACTION",
})

# Search Federal Rules of Civil Procedure
requests.post(url, headers=h, json={
    "query": "personal jurisdiction long-arm statute",
    "corpusType": "FEDERAL_RULES",
})

# Cross-corpus search (no corpusType filter)
requests.post(url, headers=h, json={
    "query": "due process equal protection fourteenth amendment",
})

Parameters

query (required): natural-language or keyword query, 2 to 500 characters.
corpusType (optional): one of the 8 corpus tokens above. Omit to search every corpus at once.
state (optional, 2-letter lowercase, e.g. ca): restrict to one state. Applies only to STATE, STATE_CONSTITUTION, and STATE_RULES; ignored for federal corpora.
titleNumber (optional, integer): restrict to a USC/CFR title (e.g. 17 for SEC, 42 for civil rights). Applies only to USC/CFR. State titles are alphabetic codes (use /statutes/codes to find them), so this is ignored for state corpora.
limit (optional, default 10, max 50): number of results to return.

Tips

Provide corpusType whenever you know it. Unscoped queries can surface keyword matches from unrelated corpora; a corpus filter sharply improves precision.
Take a returned actId and call /statutes/section/{actId} for metadata or /statutes/section/{actId}/body for the full text.
relevanceScore ranks results within one response; do not compare it across different queries.

POST

api

statutes

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>"
}
'

import requests

url = "https://api.vaquill.ai/api/v1/statutes/search"

payload = { "query": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: '<string>'})
};

fetch('https://api.vaquill.ai/api/v1/statutes/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vaquill.ai/api/v1/statutes/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "results": [
    {
      "actId": "CFR_T17_P240_S240_10b5_1",
      "citation": "17 C.F.R. § 240.10b5-1 (2026)",
      "citationShort": "17 C.F.R. § 240.10b5-1",
      "title": "Trading on the basis of material nonpublic information in insider trading cases",
      "corpusType": "CFR",
      "state": "federal",
      "year": 2026,
      "relevanceScore": 0.91,
      "excerpt": "The manipulative and deceptive devices prohibited by section 10(b)...",
      "titleNumber": 17,
      "sectionNumber": "240.10b5-1",
      "displayPath": "Title 17 CFR > Chapter II > Part 240 > Section 240.10b5-1",
      "htmlUrl": "https://statutes-us.vaquill.ai/ecfr/...",
      "externalUrl": "https://www.ecfr.gov/..."
    }
  ],
  "total": 1,
  "query": "insider trading material nonpublic information",
  "processingTimeMs": 412.3,
  "creditsConsumed": 4
}

{
  "detail": "Insufficient credits"
}

{
  "detail": "Validation error"
}

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 statutory codes; call /statutes/states for the list of ingested jurisdictions), 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), REGULATION (state administrative regulations; pair with state), FEDERAL_REGISTER (Federal Register agency rules, final and proposed), AGENCY_GUIDANCE (agency guidance: SSA rulings, IRS notices, revenue rulings and procedures). Omit to search across all corpora.

Available options:

USC,

CFR,

STATE,

CONSTITUTION,

FEDERAL_RULES,

STATE_CONSTITUTION,

STATE_RULES,

EXECUTIVE_ACTION,

REGULATION,

FEDERAL_REGISTER,

AGENCY_GUIDANCE

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 per page.

Required range: 1 <= x <= 50

offset

integer

default:0

Number of results to skip for pagination. Combined with limit, the deepest reachable result is offset + limit. Deep paging is bounded by the reranking window, so offset is capped at 40. Use hasMore in the response to decide whether to request the next page.

Required range: 0 <= x <= 40

Response

Ranked sections for the query.

results

StatuteResult · object[]

Show child attributes

total

integer

default:0

Number of results returned in this response (the size of results). This is the current page count, not the corpus-wide match total. Use hasMore to detect further pages.

offset

integer

default:0

The offset applied to this page.

hasMore

boolean

default:false

Whether more results exist beyond this page.

query

string

default:""

The search query used.

processingTimeMs

number

default:0

creditsConsumed

number

default:0

Get statute section metadata

US Statutes

Pricing

Search US statutes, constitutions, court rules, and executive actions

Examples

Parameters

Tips

Authorizations

Body

Response