curl --request POST \
--url https://api.vaquill.ai/api/v1/us/statutes/sections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"actIds": [
"USC_T42_C21_S1983",
"USC_T42_C21_S1981a"
]
}
'import requests
url = "https://api.vaquill.ai/api/v1/us/statutes/sections"
payload = { "actIds": ["USC_T42_C21_S1983", "USC_T42_C21_S1981a"] }
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({actIds: ['USC_T42_C21_S1983', 'USC_T42_C21_S1981a']})
};
fetch('https://api.vaquill.ai/api/v1/us/statutes/sections', 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/us/statutes/sections"
payload := strings.NewReader("{\n \"actIds\": [\n \"USC_T42_C21_S1983\",\n \"USC_T42_C21_S1981a\"\n ]\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))
}{
"sections": [
{
"actId": "USC_T42_C21_S1983",
"citation": "42 U.S.C. § 1983 (2026)",
"citationShort": "42 U.S.C. § 1983",
"title": "Civil action for deprivation of rights",
"corpusType": "USC",
"state": "federal",
"year": 2026,
"relevanceScore": 0,
"excerpt": "officer's judicial capacity, injunctive relief shall not be granted unless a declaratory decree was violated or declaratory relief was unavailable\".\n\n1979—Pub. L. 96–170 inserted \"or the District of Columbia\" after \"Territory\", and provisions relating to Acts of Congress applicable solely to the District of Columbia.\n\nStatutory Notes and Related Subsidiaries\n\nEffective Date of 1979 Amendment\n\nAmendment by Pub. L. 96–170 applicable with respect to any deprivation of rights, privileges, or...",
"titleNumber": "42",
"titleName": "THE PUBLIC HEALTH AND WELFARE",
"chapter": "21",
"chapterName": "CIVIL RIGHTS",
"sectionNumber": "1983",
"sectionTitle": "Civil action for deprivation of rights",
"displayPath": "Title 42: THE PUBLIC HEALTH AND WELFARE / Chapter 21: CIVIL RIGHTS / Subchapter I: GENERALLY / Section 1983: Civil action for deprivation of rights",
"breadcrumb": [
{
"type": "title",
"num": "42",
"label": "Title 42",
"name": "THE PUBLIC HEALTH AND WELFARE"
},
{
"type": "chapter",
"num": "21",
"label": "Chapter 21",
"name": "CIVIL RIGHTS"
},
{
"type": "subchapter",
"num": "I",
"label": "Subchapter I",
"name": "GENERALLY"
},
{
"type": "section",
"num": "1983",
"label": "Section 1983",
"name": "Civil action for deprivation of rights"
}
],
"parent": {
"corpusType": "USC",
"titleNumber": 42,
"chapter": "21"
},
"subchapter": "I",
"subchapterName": "GENERALLY",
"popularName": "Public Health and Welfare",
"actStatus": "in_force",
"goodLawStatus": "good_law",
"renumberedTo": "",
"transferredTo": "",
"sourceCredit": "R.S. §1979; Pub. L. 96–170, §1, Dec. 29, 1979, 93 Stat. 1284; Pub. L. 104–317, title III, §309(c), Oct. 19, 1996, 110 Stat. 3853.",
"amendmentYears": [
1996,
1979
],
"lastAmendedYear": 1996,
"amendmentsCount": 2,
"publicLaws": [
"Pub. L. 104-317",
"Pub. L. 96-170"
],
"textUrl": "https://statutes-us.vaquill.ai/usc/olrc/119-103/sections/USC_T42_C21_S1983.txt",
"externalUrl": "https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title42-section1983&num=0&edition=prelim"
},
{
"actId": "USC_T42_C21_S1981a",
"citation": "42 U.S.C. § 1981a (2026)",
"citationShort": "42 U.S.C. § 1981a",
"title": "Damages in cases of intentional discrimination in employment",
"corpusType": "USC",
"state": "federal",
"year": 2026,
"relevanceScore": 0,
"excerpt": "practice or discriminatory practices with malice or with reckless indifference to the federally protected rights of an aggrieved individual.\n\n(2) Exclusions from compensatory damages\n\nCompensatory damages awarded under this section shall not include backpay, interest on backpay, or any other type of relief authorized under section 706(g) of the Civil Rights Act of 1964 [42 U.S.C. 2000e–5(g)].\n\n(3) Limitations\n\nThe sum of the amount of compensatory damages awarded under this section for future...",
"titleNumber": "42",
"titleName": "THE PUBLIC HEALTH AND WELFARE",
"chapter": "21",
"chapterName": "CIVIL RIGHTS",
"sectionNumber": "1981a",
"sectionTitle": "Damages in cases of intentional discrimination in employment",
"displayPath": "Title 42: THE PUBLIC HEALTH AND WELFARE / Chapter 21: CIVIL RIGHTS / Subchapter I: GENERALLY / Section 1981a: Damages in cases of intentional discrimination in employment",
"breadcrumb": [
{
"type": "title",
"num": "42",
"label": "Title 42",
"name": "THE PUBLIC HEALTH AND WELFARE"
},
{
"type": "chapter",
"num": "21",
"label": "Chapter 21",
"name": "CIVIL RIGHTS"
},
{
"type": "subchapter",
"num": "I",
"label": "Subchapter I",
"name": "GENERALLY"
},
{
"type": "section",
"num": "1981a",
"label": "Section 1981a",
"name": "Damages in cases of intentional discrimination in employment"
}
],
"parent": {
"corpusType": "USC",
"titleNumber": 42,
"chapter": "21"
},
"subchapter": "I",
"subchapterName": "GENERALLY",
"popularName": "Public Health and Welfare",
"actStatus": "in_force",
"goodLawStatus": "good_law",
"renumberedTo": "",
"transferredTo": "",
"sourceCredit": "R.S. §1977A, as added Pub. L. 102–166, title I, §102, Nov. 21, 1991, 105 Stat. 1072.",
"amendmentsCount": 0,
"publicLaws": [
"Pub. L. 101-336",
"Pub. L. 102-166",
"Pub. L. 88-352"
],
"textUrl": "https://statutes-us.vaquill.ai/usc/olrc/119-103/sections/USC_T42_C21_S1983.txt",
"externalUrl": "https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title42-section1981a&num=0&edition=prelim"
}
],
"notFound": [
"STATE_CO_S38-12-103"
],
"notFoundDetail": [
{
"actId": "STATE_CO_S38-12-103",
"reason": "assembled_id",
"didYouMean": [
"STATE_CO_T38_A12_P1_S38-12-103"
]
}
],
"count": 2,
"processingTimeMs": 11,
"creditsConsumed": 12
}{
"detail": "Insufficient API credits."
}{
"detail": "Insufficient API credits."
}{
"detail": "Insufficient API credits."
}{
"detail": "Insufficient API credits."
}Get metadata for many statute sections
Metadata for up to 50 sections in one call.
Cost: 2 credits per section returned. Identifiers with no match are refunded, so a batch of 50 ids that resolves 47 costs 94 credits, not 100. Batching is a round-trip and latency win, not a discount.
The response preserves the order of actIds and reports misses separately in
notFound, so results can be zipped back onto the ids that produced them.
Take ids from a /us/statutes/search response, do not build them from a
citation. An act_id looks derivable and is not: Tex. Property Code § 93.005
is STATE_TX_Cpr_C93_S93.005, and the Cpr code segment exists only in the
data. Assembling ids works for a few jurisdictions whose hierarchy happens to
sit in the citation, which makes the failures look like missing coverage rather
than like wrong ids.
So every miss also comes back in notFoundDetail saying which it was:
assembled_id with the real ids in didYouMean, or not_in_corpus when
nothing matching exists (check /us/statutes/coverage for the jurisdiction
before concluding a section is absent). The diagnosis is free and never
charged. To go from a citation rather than a guess, use
/us/statutes/resolve.
Use /us/statutes/section/{actId}/body for full text; this endpoint returns
metadata and source links only.
curl --request POST \
--url https://api.vaquill.ai/api/v1/us/statutes/sections \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"actIds": [
"USC_T42_C21_S1983",
"USC_T42_C21_S1981a"
]
}
'import requests
url = "https://api.vaquill.ai/api/v1/us/statutes/sections"
payload = { "actIds": ["USC_T42_C21_S1983", "USC_T42_C21_S1981a"] }
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({actIds: ['USC_T42_C21_S1983', 'USC_T42_C21_S1981a']})
};
fetch('https://api.vaquill.ai/api/v1/us/statutes/sections', 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/us/statutes/sections"
payload := strings.NewReader("{\n \"actIds\": [\n \"USC_T42_C21_S1983\",\n \"USC_T42_C21_S1981a\"\n ]\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))
}{
"sections": [
{
"actId": "USC_T42_C21_S1983",
"citation": "42 U.S.C. § 1983 (2026)",
"citationShort": "42 U.S.C. § 1983",
"title": "Civil action for deprivation of rights",
"corpusType": "USC",
"state": "federal",
"year": 2026,
"relevanceScore": 0,
"excerpt": "officer's judicial capacity, injunctive relief shall not be granted unless a declaratory decree was violated or declaratory relief was unavailable\".\n\n1979—Pub. L. 96–170 inserted \"or the District of Columbia\" after \"Territory\", and provisions relating to Acts of Congress applicable solely to the District of Columbia.\n\nStatutory Notes and Related Subsidiaries\n\nEffective Date of 1979 Amendment\n\nAmendment by Pub. L. 96–170 applicable with respect to any deprivation of rights, privileges, or...",
"titleNumber": "42",
"titleName": "THE PUBLIC HEALTH AND WELFARE",
"chapter": "21",
"chapterName": "CIVIL RIGHTS",
"sectionNumber": "1983",
"sectionTitle": "Civil action for deprivation of rights",
"displayPath": "Title 42: THE PUBLIC HEALTH AND WELFARE / Chapter 21: CIVIL RIGHTS / Subchapter I: GENERALLY / Section 1983: Civil action for deprivation of rights",
"breadcrumb": [
{
"type": "title",
"num": "42",
"label": "Title 42",
"name": "THE PUBLIC HEALTH AND WELFARE"
},
{
"type": "chapter",
"num": "21",
"label": "Chapter 21",
"name": "CIVIL RIGHTS"
},
{
"type": "subchapter",
"num": "I",
"label": "Subchapter I",
"name": "GENERALLY"
},
{
"type": "section",
"num": "1983",
"label": "Section 1983",
"name": "Civil action for deprivation of rights"
}
],
"parent": {
"corpusType": "USC",
"titleNumber": 42,
"chapter": "21"
},
"subchapter": "I",
"subchapterName": "GENERALLY",
"popularName": "Public Health and Welfare",
"actStatus": "in_force",
"goodLawStatus": "good_law",
"renumberedTo": "",
"transferredTo": "",
"sourceCredit": "R.S. §1979; Pub. L. 96–170, §1, Dec. 29, 1979, 93 Stat. 1284; Pub. L. 104–317, title III, §309(c), Oct. 19, 1996, 110 Stat. 3853.",
"amendmentYears": [
1996,
1979
],
"lastAmendedYear": 1996,
"amendmentsCount": 2,
"publicLaws": [
"Pub. L. 104-317",
"Pub. L. 96-170"
],
"textUrl": "https://statutes-us.vaquill.ai/usc/olrc/119-103/sections/USC_T42_C21_S1983.txt",
"externalUrl": "https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title42-section1983&num=0&edition=prelim"
},
{
"actId": "USC_T42_C21_S1981a",
"citation": "42 U.S.C. § 1981a (2026)",
"citationShort": "42 U.S.C. § 1981a",
"title": "Damages in cases of intentional discrimination in employment",
"corpusType": "USC",
"state": "federal",
"year": 2026,
"relevanceScore": 0,
"excerpt": "practice or discriminatory practices with malice or with reckless indifference to the federally protected rights of an aggrieved individual.\n\n(2) Exclusions from compensatory damages\n\nCompensatory damages awarded under this section shall not include backpay, interest on backpay, or any other type of relief authorized under section 706(g) of the Civil Rights Act of 1964 [42 U.S.C. 2000e–5(g)].\n\n(3) Limitations\n\nThe sum of the amount of compensatory damages awarded under this section for future...",
"titleNumber": "42",
"titleName": "THE PUBLIC HEALTH AND WELFARE",
"chapter": "21",
"chapterName": "CIVIL RIGHTS",
"sectionNumber": "1981a",
"sectionTitle": "Damages in cases of intentional discrimination in employment",
"displayPath": "Title 42: THE PUBLIC HEALTH AND WELFARE / Chapter 21: CIVIL RIGHTS / Subchapter I: GENERALLY / Section 1981a: Damages in cases of intentional discrimination in employment",
"breadcrumb": [
{
"type": "title",
"num": "42",
"label": "Title 42",
"name": "THE PUBLIC HEALTH AND WELFARE"
},
{
"type": "chapter",
"num": "21",
"label": "Chapter 21",
"name": "CIVIL RIGHTS"
},
{
"type": "subchapter",
"num": "I",
"label": "Subchapter I",
"name": "GENERALLY"
},
{
"type": "section",
"num": "1981a",
"label": "Section 1981a",
"name": "Damages in cases of intentional discrimination in employment"
}
],
"parent": {
"corpusType": "USC",
"titleNumber": 42,
"chapter": "21"
},
"subchapter": "I",
"subchapterName": "GENERALLY",
"popularName": "Public Health and Welfare",
"actStatus": "in_force",
"goodLawStatus": "good_law",
"renumberedTo": "",
"transferredTo": "",
"sourceCredit": "R.S. §1977A, as added Pub. L. 102–166, title I, §102, Nov. 21, 1991, 105 Stat. 1072.",
"amendmentsCount": 0,
"publicLaws": [
"Pub. L. 101-336",
"Pub. L. 102-166",
"Pub. L. 88-352"
],
"textUrl": "https://statutes-us.vaquill.ai/usc/olrc/119-103/sections/USC_T42_C21_S1983.txt",
"externalUrl": "https://uscode.house.gov/view.xhtml?req=granuleid:USC-prelim-title42-section1981a&num=0&edition=prelim"
}
],
"notFound": [
"STATE_CO_S38-12-103"
],
"notFoundDetail": [
{
"actId": "STATE_CO_S38-12-103",
"reason": "assembled_id",
"didYouMean": [
"STATE_CO_T38_A12_P1_S38-12-103"
]
}
],
"count": 2,
"processingTimeMs": 11,
"creditsConsumed": 12
}{
"detail": "Insufficient API credits."
}{
"detail": "Insufficient API credits."
}{
"detail": "Insufficient API credits."
}{
"detail": "Insufficient API credits."
}Authorizations
API key issued from the developer dashboard. Pass as Authorization: Bearer vq_key_...
Body
Batch metadata lookup. See POST /us/statutes/sections.
Section identifiers from a prior /us/statutes/search response. Up to 50 per call. Duplicates are collapsed, and order is preserved in the response. Each id encodes the citation's hierarchy: USC_T42_C21_S1983 is Title 42, Chapter 21, Section 1983. DO NOT BUILD THESE FROM A CITATION: the chapter/article/part segments exist only in the data, so Tex. Property Code § 93.005 is STATE_TX_Cpr_C93_S93.005, not STATE_TX_C93_S93.005. Assembled ids miss, and notFoundDetail will say so and suggest the real ones. To start from a citation, use /us/statutes/resolve.
1 - 50 elements[ "USC_T42_C21_S1983", "CFR_T17_P240_S240_10b5_1" ]
Return each section's full text inline on body, instead of metadata only. Adds the ordinary body price per row that returns text, so 20 ids resolving 20 bodies is 40 + 120 = 160 credits. Rows whose text cannot be resolved come back with body: null and are not charged for it, so read creditsConsumed rather than computing the total. Without this, use /us/statutes/section/{actId}/body one id at a time.
true
Response
Sections found, plus any ids that did not resolve.
Response for POST /us/statutes/sections.
Found sections, in the order the ids were supplied.
Show child attributes
Show child attributes
Identifiers with no match. These are NOT charged, so a batch with misses costs less than len(actIds) times the per-section rate.
One entry per id in notFound, saying whether the id was assembled rather than taken from a search result, and suggesting the real ids where they could be recovered. Diagnostic only and never charged; it can come back empty if the lookup is unavailable, so treat it as a hint rather than a contract.
Show child attributes
Show child attributes
Number of sections returned.
Server-side time for this request in milliseconds, excluding network transit. Useful for spotting a slow query; not billed on.
240.5
Credits actually charged for this call. Read it rather than assuming the list price: failed and refunded work bills 0, and batch endpoints charge per item returned, so a partial result costs less than a full one.
4
Was this page helpful?