Get metadata for many statute sections
curl --request POST \
--url https://api.vaquill.ai/api/v1/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/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/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/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 (2024)",
"citationShort": "42 U.S.C. § 1983",
"title": "Civil action for deprivation of rights",
"corpusType": "USC",
"state": "federal",
"year": 2024,
"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"
],
"granuleId": "USCODE-2024-title42-chap21-subchapI-sec1983",
"packageId": "USCODE-2024-title42",
"htmlUrl": "https://statutes-us.vaquill.ai/usc/html/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1983.htm",
"pdfUrl": "https://statutes-us.vaquill.ai/usc/pdf/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1983.pdf",
"govInfoHtmlUrl": "https://www.govinfo.gov/content/pkg/USCODE-2024-title42/html/USCODE-2024-title42-chap21-subchapI-sec1983.htm",
"govInfoPdfUrl": "https://www.govinfo.gov/content/pkg/USCODE-2024-title42/pdf/USCODE-2024-title42-chap21-subchapI-sec1983.pdf",
"externalUrl": "https://www.govinfo.gov/app/details/USCODE-2024-title42/USCODE-2024-title42-chap21-subchapI-sec1983"
},
{
"actId": "USC_T42_C21_S1981a",
"citation": "42 U.S.C. § 1981a (2024)",
"citationShort": "42 U.S.C. § 1981a",
"title": "Damages in cases of intentional discrimination in employment",
"corpusType": "USC",
"state": "federal",
"year": 2024,
"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"
],
"granuleId": "USCODE-2024-title42-chap21-subchapI-sec1981a",
"packageId": "USCODE-2024-title42",
"htmlUrl": "https://statutes-us.vaquill.ai/usc/html/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1981a.htm",
"pdfUrl": "https://statutes-us.vaquill.ai/usc/pdf/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1981a.pdf",
"govInfoHtmlUrl": "https://www.govinfo.gov/content/pkg/USCODE-2024-title42/html/USCODE-2024-title42-chap21-subchapI-sec1981a.htm",
"govInfoPdfUrl": "https://www.govinfo.gov/content/pkg/USCODE-2024-title42/pdf/USCODE-2024-title42-chap21-subchapI-sec1981a.pdf",
"externalUrl": "https://www.govinfo.gov/app/details/USCODE-2024-title42/USCODE-2024-title42-chap21-subchapI-sec1981a"
}
],
"notFound": [],
"count": 2,
"processingTimeMs": 11,
"creditsConsumed": 12
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}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.
Exists because enriching a search page previously meant one HTTP call per
result: a 50-result page was 50 round trips. 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.
Use /statutes/section/{actId}/body for full text; this endpoint returns
metadata and source links only.
POST
/
api
/
v1
/
statutes
/
sections
Get metadata for many statute sections
curl --request POST \
--url https://api.vaquill.ai/api/v1/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/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/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/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 (2024)",
"citationShort": "42 U.S.C. § 1983",
"title": "Civil action for deprivation of rights",
"corpusType": "USC",
"state": "federal",
"year": 2024,
"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"
],
"granuleId": "USCODE-2024-title42-chap21-subchapI-sec1983",
"packageId": "USCODE-2024-title42",
"htmlUrl": "https://statutes-us.vaquill.ai/usc/html/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1983.htm",
"pdfUrl": "https://statutes-us.vaquill.ai/usc/pdf/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1983.pdf",
"govInfoHtmlUrl": "https://www.govinfo.gov/content/pkg/USCODE-2024-title42/html/USCODE-2024-title42-chap21-subchapI-sec1983.htm",
"govInfoPdfUrl": "https://www.govinfo.gov/content/pkg/USCODE-2024-title42/pdf/USCODE-2024-title42-chap21-subchapI-sec1983.pdf",
"externalUrl": "https://www.govinfo.gov/app/details/USCODE-2024-title42/USCODE-2024-title42-chap21-subchapI-sec1983"
},
{
"actId": "USC_T42_C21_S1981a",
"citation": "42 U.S.C. § 1981a (2024)",
"citationShort": "42 U.S.C. § 1981a",
"title": "Damages in cases of intentional discrimination in employment",
"corpusType": "USC",
"state": "federal",
"year": 2024,
"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"
],
"granuleId": "USCODE-2024-title42-chap21-subchapI-sec1981a",
"packageId": "USCODE-2024-title42",
"htmlUrl": "https://statutes-us.vaquill.ai/usc/html/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1981a.htm",
"pdfUrl": "https://statutes-us.vaquill.ai/usc/pdf/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1981a.pdf",
"govInfoHtmlUrl": "https://www.govinfo.gov/content/pkg/USCODE-2024-title42/html/USCODE-2024-title42-chap21-subchapI-sec1981a.htm",
"govInfoPdfUrl": "https://www.govinfo.gov/content/pkg/USCODE-2024-title42/pdf/USCODE-2024-title42-chap21-subchapI-sec1981a.pdf",
"externalUrl": "https://www.govinfo.gov/app/details/USCODE-2024-title42/USCODE-2024-title42-chap21-subchapI-sec1981a"
}
],
"notFound": [],
"count": 2,
"processingTimeMs": 11,
"creditsConsumed": 12
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Authorizations
API key issued from the Vaquill developer dashboard. Pass as Authorization: Bearer vq_key_...
Body
application/json
Batch metadata lookup. See POST /statutes/sections.
Section identifiers from a prior /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. The chapter is not derivable from a citation, so take ids from search results rather than assembling them.
Required array length:
1 - 50 elementsExample:
[ "USC_T42_C21_S1983", "CFR_T17_P240_S240_10b5_1" ]
Response
Sections found, plus any ids that did not resolve.
Response for POST /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.
Number of sections returned.
Server-side time for this request in milliseconds, excluding network transit. Useful for spotting a slow query; not billed on.
Example:
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.
Example:
4
Last modified on August 6, 2026
Was this page helpful?
⌘I