curl --request GET \
--url https://api.vaquill.ai/api/v1/us/statutes/coverage \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.vaquill.ai/api/v1/us/statutes/coverage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vaquill.ai/api/v1/us/statutes/coverage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vaquill.ai/api/v1/us/statutes/coverage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"corpusTypes": [
{
"token": "USC",
"description": "United States Code (federal statutes)",
"scope": "federal"
},
{
"token": "REGULATION",
"description": "State administrative regulations",
"scope": "state"
},
{
"token": "AGENCY_GUIDANCE",
"description": "Sub-regulatory agency guidance across named sources",
"scope": "federal",
"sourceScopeNotes": {
"cms_iom": "Held: the 204 chapter, appendix and exhibit documents CMS publishes across its Medicare Internet-Only Manuals ... Not held, and these are the publisher's own gaps rather than ours: Pub. 100-12 (State Medicaid Manual), Pub. 100-13 (Medicaid CHIP) and Pub. 100-23 (Payment Error Rate Measurement) publish no chapters at all ..."
}
}
],
"jurisdictions": [
{
"code": "federal",
"name": "Federal (USC + CFR)",
"kind": "federal",
"sectionCount": 812553,
"hasData": true,
"corpora": {
"CFR": 491612,
"USC": 212042,
"FEDERAL_REGISTER": 102861,
"EXECUTIVE_ACTION": 3599,
"AGENCY_GUIDANCE": 2510,
"FEDERAL_RULES": 526,
"CONSTITUTION": 74
}
},
{
"code": "wa",
"name": "Washington",
"kind": "state",
"sectionCount": 140326,
"hasData": true,
"corpora": {
"STATE": 89005,
"REGULATION": 51142,
"STATE_CONSTITUTION": 179
}
}
],
"totalSections": 2937552,
"stateCountWithData": 49,
"freshness": [
{
"jurisdiction": "ok",
"corpusType": "STATE",
"status": "paused",
"reason": "Oklahoma statutes are complete and officially sourced, and hold acts through the 2025 session, but updates are paused: the publisher's robots.txt prohibits automated access to the source documents. Amendments enacted after the 2025 session are not reflected."
},
{
"jurisdiction": "ga",
"corpusType": "STATE",
"status": "retired",
"reason": "Georgia statutes are not offered: the O.C.G.A. is published only through a commercial platform, which our government-source-only rule excludes. Georgia regulations and court rules are unaffected."
}
],
"retrieval": [
{
"jurisdiction": "federal",
"corpusType": "CFR",
"status": "current",
"lastRetrievedAt": "2026-08-18T03:10:15.960853+00:00",
"cadence": "daily"
},
{
"jurisdiction": "ok",
"corpusType": "STATE",
"status": "paused",
"lastRetrievedAt": "2026-07-22T04:00:00.471781+00:00",
"cadence": "monthly",
"reason": "Oklahoma statutes are complete and officially sourced, and hold acts through the 2025 session, but updates are paused: the publisher's robots.txt prohibits automated access to the source documents. Amendments enacted after the 2025 session are not reflected."
},
{
"jurisdiction": "wa",
"corpusType": "STATE",
"status": "current",
"lastRetrievedAt": "2026-08-16T19:35:23.038075+00:00",
"cadence": "monthly"
}
]
},
"meta": {
"processingTimeMs": 5401.2,
"creditsConsumed": 0
}
}{
"detail": "Invalid or missing API key."
}{
"detail": "Insufficient API credits."
}{
"detail": "Insufficient API credits."
}Coverage matrix by jurisdiction and corpusType
Self-describing coverage matrix. Returns a legend of every corpusType token (what it contains and whether it is federal or state-scoped) plus, for each jurisdiction, the per-corpusType ingested DOCUMENT counts in corpora (one per section or document, not per retrieval passage; totalPassages in the same response IS the passage count). Use it to learn exactly what is queryable where before calling /us/statutes/search: read a jurisdiction’s corpora keys, then pass one as corpusType (paired with state for state-scoped corpora).
freshness names STATUTE corpora that are no longer being refreshed, so a count can be read as maintained or frozen rather than just large. Each notice names a (jurisdiction, corpusType) pair, never a whole jurisdiction: a state can be frozen in one corpus and current in another. paused means the data is complete and queryable but no longer refreshed; retired means that corpusType is not offered there and its count is 0.
It covers statutes only, and an absent notice is not a freshness guarantee. Regulations, court rules, constitutions and agency guidance each refresh on their own schedule and are not represented here. For those, and for the age of any source, read GET /boards — it is the only complete answer to what is and is not being polled.
For per-source retrieval health, call GET /boards: it is free, needs no credits, and carries lastRetrievedAt, cadence and retrievalStatus (current, stale, failing, never_retrieved) for every tracked source. Read it alongside the counts here so a section count carries an age. Note it records when we last CHECKED, not when the law last changed, and it is not a claim that the law is current as of that date; where a publisher states its own currency, that rides on the section itself and is summarized in currency below.
Free. Requires an API key and is rate-limited, but costs no credits.
curl --request GET \
--url https://api.vaquill.ai/api/v1/us/statutes/coverage \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.vaquill.ai/api/v1/us/statutes/coverage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vaquill.ai/api/v1/us/statutes/coverage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vaquill.ai/api/v1/us/statutes/coverage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"corpusTypes": [
{
"token": "USC",
"description": "United States Code (federal statutes)",
"scope": "federal"
},
{
"token": "REGULATION",
"description": "State administrative regulations",
"scope": "state"
},
{
"token": "AGENCY_GUIDANCE",
"description": "Sub-regulatory agency guidance across named sources",
"scope": "federal",
"sourceScopeNotes": {
"cms_iom": "Held: the 204 chapter, appendix and exhibit documents CMS publishes across its Medicare Internet-Only Manuals ... Not held, and these are the publisher's own gaps rather than ours: Pub. 100-12 (State Medicaid Manual), Pub. 100-13 (Medicaid CHIP) and Pub. 100-23 (Payment Error Rate Measurement) publish no chapters at all ..."
}
}
],
"jurisdictions": [
{
"code": "federal",
"name": "Federal (USC + CFR)",
"kind": "federal",
"sectionCount": 812553,
"hasData": true,
"corpora": {
"CFR": 491612,
"USC": 212042,
"FEDERAL_REGISTER": 102861,
"EXECUTIVE_ACTION": 3599,
"AGENCY_GUIDANCE": 2510,
"FEDERAL_RULES": 526,
"CONSTITUTION": 74
}
},
{
"code": "wa",
"name": "Washington",
"kind": "state",
"sectionCount": 140326,
"hasData": true,
"corpora": {
"STATE": 89005,
"REGULATION": 51142,
"STATE_CONSTITUTION": 179
}
}
],
"totalSections": 2937552,
"stateCountWithData": 49,
"freshness": [
{
"jurisdiction": "ok",
"corpusType": "STATE",
"status": "paused",
"reason": "Oklahoma statutes are complete and officially sourced, and hold acts through the 2025 session, but updates are paused: the publisher's robots.txt prohibits automated access to the source documents. Amendments enacted after the 2025 session are not reflected."
},
{
"jurisdiction": "ga",
"corpusType": "STATE",
"status": "retired",
"reason": "Georgia statutes are not offered: the O.C.G.A. is published only through a commercial platform, which our government-source-only rule excludes. Georgia regulations and court rules are unaffected."
}
],
"retrieval": [
{
"jurisdiction": "federal",
"corpusType": "CFR",
"status": "current",
"lastRetrievedAt": "2026-08-18T03:10:15.960853+00:00",
"cadence": "daily"
},
{
"jurisdiction": "ok",
"corpusType": "STATE",
"status": "paused",
"lastRetrievedAt": "2026-07-22T04:00:00.471781+00:00",
"cadence": "monthly",
"reason": "Oklahoma statutes are complete and officially sourced, and hold acts through the 2025 session, but updates are paused: the publisher's robots.txt prohibits automated access to the source documents. Amendments enacted after the 2025 session are not reflected."
},
{
"jurisdiction": "wa",
"corpusType": "STATE",
"status": "current",
"lastRetrievedAt": "2026-08-16T19:35:23.038075+00:00",
"cadence": "monthly"
}
]
},
"meta": {
"processingTimeMs": 5401.2,
"creditsConsumed": 0
}
}{
"detail": "Invalid or missing API key."
}{
"detail": "Insufficient API credits."
}{
"detail": "Insufficient API credits."
}Authorizations
API key issued from the developer dashboard. Pass as Authorization: Bearer vq_key_...
Response
Coverage legend plus per-jurisdiction corpusType counts.
Was this page helpful?

