Vaquill

before
{"properties":{"actStatus":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Positively scope to raw publisher statuses: `repealed` for dead law only, `in_force` for sections affirmatively marked current. The inverse of `excludeRepealed`, and what a compliance diff asking what was LOST needs. Combining a dead status with `excludeRepealed: true` is rejected 422.","enum":["abolished","deleted","expired","in_force","inactive","non_precedential","not_funded","not_yet_effective","omitted","proposed","recodified","recompiled","rejected","relocated","removed","renumbered","repealed","rescinded","reserved","revoked","superseded","terminated","transferred","unconstitutional","vacant","vacated","vetoed","withdrawn"],"examples":["repealed"]},"agency":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Federal Register agency: slug (`environmental-protection-agency`), full name or acronym (`EPA`); a list matches any. An ambiguous acronym (`FS`) or an unknown agency is a 422, never a charge. Only `FEDERAL_REGISTER` and `EXECUTIVE_ACTION` carry an agency.","examples":["environmental-protection-agency"]},"article":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Article label(s) to scope to, exactly as `list_statute_divisions` returns them (`Amendment XIV`, `Article IV`, New York's `2-A`). Needs `corpusType` `CONSTITUTION`, `STATE_CONSTITUTION` (plus `state`), or `STATE` / `REGULATION` (plus `code`); otherwise 422 before any charge.","examples":["Amendment XIV"]},"changedSince":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only sections we OBSERVED changing on or after this date (`YYYY-MM-DD`). Observed, not effective: the date we saw it, an upper bound on when it took effect. Capture began long after the corpus did and events sweep at 24 months, so empty means no captured change, never that nothing was amended.","examples":["2026-08-01"],"format":"date"},"chapter":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more chapters within a title or code, e.g. `21` for USC Title 42 Chapter 21. Pass a hit's `parent.chapter` back to search its neighbors. Chapter numbers repeat across titles, so pair with `titleNumber` (USC) or `code` (state); an unpaired chapter is rejected.","examples":["21"]},"code":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s from list_statute_divisions. List allowed, across states. The only way to scope below a whole jurisdiction: `state=tx` alone searches all ~15 Texas codes.","examples":["tx_pe"]},"corpusType":{"anyOf":[{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},{"items":{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to one corpus, or several as a list. Federal: `USC`, `USC_ANNUAL` (published past editions), `CFR`, `CFR_ANNUAL` (same, superseded by construction), `CONSTITUTION`, `FEDERAL_RULES`, `FEDERAL_REGISTER`, `FEDERAL_REGISTER_NOTICE` (a curated slice, not the whole series), `EXECUTIVE_ACTION`, `AGENCY_GUIDANCE`, `SENTENCING_GUIDELINES`, `US_TAX_TREATY`, `SESSION_LAW` (Statutes at Large, as enacted), `STATUTE_COMPILATION` (an act as amended through a stated later law), `AGENCY_ADJUDICATION` (DOJ Office of Legal Counsel opinions and MSPB decisions). Pair with `state`: `STATE`, `REGULATION`, `STATE_RULES`, `STATE_CONSTITUTION`, `STATE_AGENCY_GUIDANCE`, `STATE_AG_OPINION`. Omit for all.","examples":["CFR"]},"documentType":{"anyOf":[{"enum":["final","proposed","presidential"],"type":"string"},{"type":"null"}],"description":"Federal Register document stage: `final` (a rule in force), `proposed` (an NPRM), or `presidential` (a Presidential Document, the `EXECUTIVE_ACTION` corpus). The same distinction appears in each row's `actId` prefix (`FR_RULE_` vs `FR_PRORULE_`).","examples":["final"]},"excerptChars":{"default":500,"description":"Characters of matching text to include in each result's `excerpt`. The excerpt is a ranking preview; use `/us/statutes/section/{actId}/body` for the full text. Default 500.","maximum":4000,"minimum":100,"type":"integer"},"excludeRepealed":{"default":false,"description":"Drop sections whose own status says they are not operative (repealed, renumbered, transferred, expired, superseded, omitted, and the rest). Removes what we KNOW is dead; it does not promise the remainder is good law. Read `goodLawStatus` per result to tell them apart: `good_law` is checked, `unknown` is unchecked.","examples":[true],"type":"boolean"},"fields":{"anyOf":[{"items":{"type":"string"},"type":"array","uniqueItems":true},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Return only these result fields, e.g. `[\"title\", \"excerpt\"]`. A result carries 40+ fields, most null on any given row. `actId` and `citation` are always included. Unknown names are rejected 422. Omit for the full object.","enum":["abstract","actId","actStatus","action","adoptedAfterCurrentThrough","adoptingCitations","agencies","agencySlugs","alternateCitations","amendmentHistory","amendmentNote","amendmentYears","amendmentsCount","articleName","articleNumber","audience","body","breadcrumb","caseName","chapter","chapterName","citation","citationShort","committeeNote","corpusType","court","crossReferencesCfr","crossReferencesUsc","currencyNote","currencyYear","currentThrough","datesText","displayLabel","displayPath","documentNumber","documentSubtype","documentTypeLabel","docxUrl","edition","effectiveDate","effectiveDateRaw","excerpt","expirationDate","expirationDateRaw","externalUrl","federalRegisterCitations","forum","frCommentsCloseOn","frCorrectionOf","frCorrections","frDocketIds","frEffectiveOn","frEndPage","frRegulationIdNumbers","frRegulationsDotGovUrl","frRelatedDocuments","frSignificant","frStartPage","frVolume","goodLawStatus","govInfoHtmlUrl","govInfoPdfUrl","granuleId","history","historyEffectiveDate","htmlUrl","implementingRegulations","issueDate","issueDateRaw","issuingAgency","languageCode","lastAmendedDate","lastAmendedDateRaw","lastAmendedYear","lawImplemented","licenseNote","originalEnactmentDate","originalEnactmentDateRaw","packageId","parent","part","partName","pdfUrl","pendingAdoptions","popularName","president","priorEffectiveDates","program","publicLawCites","publicLaws","publicationDate","publicationDateRaw","publisherKey","referencedShortTitles","relatedCitations","relatedDocuments","releaseDate","releaseDateRaw","relevanceScore","renumberedTo","renumberedToLabel","requesters","rescindedOn","rescindedOnRaw","reviewDate","reviewDateRaw","ruleSet","ruleSetCode","sectionNumber","sectionTitle","settlementAmount","signingDate","signingDateRaw","source","sourceCharEnd","sourceCharStart","sourceCredit","sourceNote","sourcePageEnd","sourcePageStart","sourceUrl","state","stateHtmlUrl","statutoryAuthority","subchapter","subchapterName","subject","subjectNumber","subpart","subpartName","subtitle","subtitleName","supersededBy","supersedes","supersessionActions","textUrl","title","titleName","titleNumber","topLevelTitle","topics","transferredTo","transferredToLabel","versionId","volume","wordCount","xmlUrl","year"],"examples":[["title","excerpt","state"]]},"includeBody":{"default":false,"description":"Return each hit's full text inline on `body`, instead of one `/section/{actId}/body` call per hit. Buys latency, not a discount: the 4-credit search PLUS 6 credits for every row that returns text, so ten rows is 64. ⚠️ It multiplies with `limit`; 50 rows is 304 credits in one call. Rows with no text are not charged, so read `creditsConsumed`. Prefer this over a bigger `excerptChars`: an excerpt is windowed around the match and can start mid-section, so it is not safe to quote.","examples":[true],"type":"boolean"},"limit":{"default":10,"description":"Number of results to return per page.","maximum":50,"minimum":1,"type":"integer"},"matchType":{"default":"any","description":"`any` (default) is hybrid semantic + keyword ranking, for natural-language questions. `all` requires every query term; `phrase` matches an exact phrase, for a defined term. To pull up one section from a citation, use resolve_statute_citation. A citation passed as the query ranks first only when it is inside your other filters.","enum":["any","all","phrase"],"examples":["phrase"],"type":"string"},"offset":{"default":0,"description":"How many results to skip, for paging. Every page of a query is cut from one ranking, so results never repeat or go missing between pages. The deepest reachable result is `offset` + `limit`; check `hasMore`.","maximum":70,"minimum":0,"type":"integer"},"part":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more parts within a title, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`: pass a hit's `parent.part` back. Pair with `titleNumber`; an unpaired part is rejected.","examples":["240"]},"publishedFrom":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or after this date (`YYYY-MM-DD`). This is the PUBLICATION date, which is not the same as `yearFrom`: that filters the version year of a section.","examples":["2024-01-01"],"format":"date"},"publishedTo":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or before this date.","examples":["2024-12-31"],"format":"date"},"query":{"description":"Search query in natural language.","examples":["insider trading penalties"],"maxLength":500,"minLength":2,"type":"string"},"source":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"The named body of law within a `corpusType` that folds several together: `FEDERAL_RULES` into `frcp`/`fre`/`sct`, `CFR` into `far`/`dfars`, `AGENCY_GUIDANCE` into ~34 agency sources, `AGENCY_ADJUDICATION` into `olc_opinion`/`mspb_precedential`/`mspb_nonprecedential`. Every result carries its own `source`, so a hit's value can be passed straight back.","enum":["administrative_guidance","ag_precedent","agency_guidance","bia_precedent","bis_advisory_opinion","cfpb_circular","cfpb_enforcement_action","cfpb_supervisory_guidance","cftc_staff_letter","cms_iom","copyright_circular","copyright_compendium","cpsc_advisory_opinion","cpsc_secg","ddtc_commodity_jurisdiction","ddtc_guidance","dfars","dfars_pgi","doe_appliance_guidance","doj_business_review","doj_justice_manual","doj_leniency","eeoc_guidance","far","fcc_declaratory_ruling","fdic_fil","ferc_policy_statement","fincen_amla_material","fincen_boi_compliance_guide","fincen_boi_faq","fincen_boi_rule_qa","fincen_guidance","fincen_ruling","frap","frb_sr_letter","frbp","frcp","frcrp","fre","ftc_administrative_decision","ftc_advisory_opinion","ftc_advocacy_filing","ftc_hsr_interpretation","ftc_policy_statement","hhs_ocr_hipaa_faq","hhs_ocr_hipaa_guidance","hhs_ocr_resolution_agreement","immigration_admin_precedent","irs_announcement","irs_irm","irs_notice","irs_rev_proc","irs_rev_rul","irs_written_determination","merger_guidelines","mpep","mspb_nonprecedential","mspb_precedential","nlrb_advice_memo","nlrb_board_decision","nlrb_gc_memo","occ_bulletin","occ_interpretive_letter","ofac_faq","olc_opinion","sct","sec_commission_opinion","senate_treaty","senate_treaty_document","senate_treaty_resolution","ssa_ruling","state_financial_bulletin","state_insurance_bulletin","tmep","us_tax_treaty","us_tax_treaty_technical_explanation","uscis_policy_manual","whd_foh","whd_opinion_letter"],"examples":["sct"]},"state":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Jurisdiction. A 2-letter code for one of the 52 supported US jurisdictions (50 states + DC + PR), or `federal` for USC / CFR / Constitution / federal rules. Pass a list to search several at once. Case-insensitive. Omit to search every jurisdiction. Leave it unset when the query is a citation that already names its jurisdiction (`42 U.S.C.`, `C.F.R.`, `Fed. R. Civ. P.`, `U.S. Const.`): a state filter excludes federal law. Never carry a state over from an earlier question.","enum":["federal","al","ak","az","ar","ca","co","ct","de","dc","fl","ga","hi","id","il","in","ia","ks","ky","la","me","md","ma","mi","mn","ms","mo","mt","ne","nv","nh","nj","nm","ny","nc","nd","oh","ok","or","pa","pr","ri","sc","sd","tn","tx","ut","vt","va","wa","wv","wi","wy"],"examples":["ca"]},"titleNumber":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"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).","examples":[17]},"yearFrom":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or after this year; pair with `yearTo` for a window. Tracks the publisher's own amendment credit, not when we rebuilt the corpus. About a fifth of sections carry no credit and are excluded once either bound is set.","examples":[2020]},"yearTo":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or before this year. This filters the LAST amendment, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed in 2024. A currency filter, not point-in-time retrieval.","examples":[2026]}},"required":["query"],"type":"object"}

after
{"properties":{"actStatus":{"anyOf":[{"enum":["abolished","deleted","expired","in_force","inactive","non_precedential","not_funded","not_yet_effective","omitted","proposed","recodified","recompiled","rejected","relocated","removed","renumbered","repealed","rescinded","reserved","revoked","superseded","terminated","transferred","unconstitutional","vacant","vacated","vetoed","withdrawn"],"type":"string"},{"items":{"enum":["abolished","deleted","expired","in_force","inactive","non_precedential","not_funded","not_yet_effective","omitted","proposed","recodified","recompiled","rejected","relocated","removed","renumbered","repealed","rescinded","reserved","revoked","superseded","terminated","transferred","unconstitutional","vacant","vacated","vetoed","withdrawn"],"type":"string"},"type":"array"},{"type":"null"}],"description":"Positively scope to raw publisher statuses: `repealed` for dead law only, `in_force` for sections affirmatively marked current. The inverse of `excludeRepealed`, and what a compliance diff asking what was LOST needs. Combining a dead status with `excludeRepealed: true` is rejected 422.","examples":["repealed"]},"agency":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Federal Register agency: slug (`environmental-protection-agency`), full name or acronym (`EPA`); a list matches any. An ambiguous acronym (`FS`) or an unknown agency is a 422, never a charge. Only `FEDERAL_REGISTER` and `EXECUTIVE_ACTION` carry an agency.","examples":["environmental-protection-agency"]},"article":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Article label(s) to scope to, exactly as `list_statute_divisions` returns them (`Amendment XIV`, `Article IV`, New York's `2-A`). Needs `corpusType` `CONSTITUTION`, `STATE_CONSTITUTION` (plus `state`), or `STATE` / `REGULATION` (plus `code`); otherwise 422 before any charge.","examples":["Amendment XIV"]},"changedSince":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only sections we OBSERVED changing on or after this date (`YYYY-MM-DD`). Observed, not effective: the date we saw it, an upper bound on when it took effect. Capture began long after the corpus did and events sweep at 24 months, so empty means no captured change, never that nothing was amended.","examples":["2026-08-01"],"format":"date"},"chapter":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more chapters within a title or code, e.g. `21` for USC Title 42 Chapter 21. Pass a hit's `parent.chapter` back to search its neighbors. Chapter numbers repeat across titles, so pair with `titleNumber` (USC) or `code` (state); an unpaired chapter is rejected.","examples":["21"]},"code":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s from list_statute_divisions. List allowed, across states. The only way to scope below a whole jurisdiction: `state=tx` alone searches all ~15 Texas codes.","examples":["tx_pe"]},"corpusType":{"anyOf":[{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","FEDERAL_LOCAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","STATE_REGISTER","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},{"items":{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","FEDERAL_LOCAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","STATE_REGISTER","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to one corpus, or several as a list. Federal: `USC`, `USC_ANNUAL` (published past editions), `CFR`, `CFR_ANNUAL` (same, superseded by construction), `CONSTITUTION`, `FEDERAL_RULES`, `FEDERAL_REGISTER`, `FEDERAL_REGISTER_NOTICE` (a curated slice, not the whole series), `EXECUTIVE_ACTION`, `AGENCY_GUIDANCE`, `SENTENCING_GUIDELINES`, `US_TAX_TREATY`, `SESSION_LAW` (Statutes at Large, as enacted), `STATUTE_COMPILATION` (an act as amended through a stated later law), `AGENCY_ADJUDICATION` (DOJ Office of Legal Counsel opinions and MSPB decisions). Pair with `state`: `STATE`, `REGULATION`, `STATE_RULES`, `STATE_CONSTITUTION`, `STATE_AGENCY_GUIDANCE`, `STATE_AG_OPINION`. Omit for all.","examples":["CFR"]},"documentType":{"anyOf":[{"enum":["final","proposed","presidential"],"type":"string"},{"type":"null"}],"description":"Federal Register document stage: `final` (a rule in force), `proposed` (an NPRM), or `presidential` (a Presidential Document, the `EXECUTIVE_ACTION` corpus). The same distinction appears in each row's `actId` prefix (`FR_RULE_` vs `FR_PRORULE_`).","examples":["final"]},"excerptChars":{"default":500,"description":"Characters of matching text to include in each result's `excerpt`. The excerpt is a ranking preview; use `/us/statutes/section/{actId}/body` for the full text. Default 500.","maximum":4000,"minimum":100,"type":"integer"},"excludeRepealed":{"default":false,"description":"Drop sections whose own status says they are not operative (repealed, renumbered, transferred, expired, superseded, omitted, and the rest). Removes what we KNOW is dead; it does not promise the remainder is good law. Read `goodLawStatus` per result to tell them apart: `good_law` is checked, `unknown` is unchecked.","examples":[true],"type":"boolean"},"fields":{"anyOf":[{"items":{"enum":["abstract","actId","actStatus","action","adoptedAfterCurrentThrough","adoptingCitations","agencies","agencySlugs","alternateCitations","amendmentHistory","amendmentNote","amendmentYears","amendmentsCount","articleName","articleNumber","audience","body","breadcrumb","caseName","chapter","chapterName","citation","citationShort","committeeNote","corpusType","court","crossReferencesCfr","crossReferencesUsc","currencyNote","currencyYear","currentThrough","datesText","displayLabel","displayPath","documentNumber","documentSubtype","documentTypeLabel","docxUrl","edition","effectiveDate","effectiveDateRaw","excerpt","expirationDate","expirationDateRaw","externalUrl","federalRegisterCitations","forum","frCommentsCloseOn","frCorrectionOf","frCorrections","frDocketIds","frEffectiveOn","frEndPage","frRegulationIdNumbers","frRegulationsDotGovUrl","frRelatedDocuments","frSignificant","frStartPage","frVolume","goodLawStatus","govInfoHtmlUrl","govInfoPdfUrl","granuleId","history","historyEffectiveDate","htmlUrl","implementingRegulations","issueDate","issueDateRaw","issuingAgency","languageCode","lastAmendedDate","lastAmendedDateRaw","lastAmendedYear","lawImplemented","licenseNote","originalEnactmentDate","originalEnactmentDateRaw","packageId","parent","part","partName","pdfUrl","pendingAdoptions","popularName","president","priorEffectiveDates","program","publicLawCites","publicLaws","publicationDate","publicationDateRaw","publisherKey","referencedShortTitles","relatedCitations","relatedDocuments","releaseDate","releaseDateRaw","relevanceScore","renumberedTo","renumberedToLabel","requesters","rescindedOn","rescindedOnRaw","reviewDate","reviewDateRaw","ruleSet","ruleSetCode","sectionNumber","sectionTitle","settlementAmount","signingDate","signingDateRaw","source","sourceCharEnd","sourceCharStart","sourceCredit","sourceNote","sourcePageEnd","sourcePageStart","sourceUrl","state","stateHtmlUrl","statutoryAuthority","subchapter","subchapterName","subject","subjectNumber","subpart","subpartName","subtitle","subtitleName","supersededBy","supersedes","supersessionActions","textUrl","title","titleName","titleNumber","topLevelTitle","topics","transferredTo","transferredToLabel","versionId","volume","wordCount","xmlUrl","year"],"type":"string"},"type":"array","uniqueItems":true},{"items":{"enum":["abstract","actId","actStatus","action","adoptedAfterCurrentThrough","adoptingCitations","agencies","agencySlugs","alternateCitations","amendmentHistory","amendmentNote","amendmentYears","amendmentsCount","articleName","articleNumber","audience","body","breadcrumb","caseName","chapter","chapterName","citation","citationShort","committeeNote","corpusType","court","crossReferencesCfr","crossReferencesUsc","currencyNote","currencyYear","currentThrough","datesText","displayLabel","displayPath","documentNumber","documentSubtype","documentTypeLabel","docxUrl","edition","effectiveDate","effectiveDateRaw","excerpt","expirationDate","expirationDateRaw","externalUrl","federalRegisterCitations","forum","frCommentsCloseOn","frCorrectionOf","frCorrections","frDocketIds","frEffectiveOn","frEndPage","frRegulationIdNumbers","frRegulationsDotGovUrl","frRelatedDocuments","frSignificant","frStartPage","frVolume","goodLawStatus","govInfoHtmlUrl","govInfoPdfUrl","granuleId","history","historyEffectiveDate","htmlUrl","implementingRegulations","issueDate","issueDateRaw","issuingAgency","languageCode","lastAmendedDate","lastAmendedDateRaw","lastAmendedYear","lawImplemented","licenseNote","originalEnactmentDate","originalEnactmentDateRaw","packageId","parent","part","partName","pdfUrl","pendingAdoptions","popularName","president","priorEffectiveDates","program","publicLawCites","publicLaws","publicationDate","publicationDateRaw","publisherKey","referencedShortTitles","relatedCitations","relatedDocuments","releaseDate","releaseDateRaw","relevanceScore","renumberedTo","renumberedToLabel","requesters","rescindedOn","rescindedOnRaw","reviewDate","reviewDateRaw","ruleSet","ruleSetCode","sectionNumber","sectionTitle","settlementAmount","signingDate","signingDateRaw","source","sourceCharEnd","sourceCharStart","sourceCredit","sourceNote","sourcePageEnd","sourcePageStart","sourceUrl","state","stateHtmlUrl","statutoryAuthority","subchapter","subchapterName","subject","subjectNumber","subpart","subpartName","subtitle","subtitleName","supersededBy","supersedes","supersessionActions","textUrl","title","titleName","titleNumber","topLevelTitle","topics","transferredTo","transferredToLabel","versionId","volume","wordCount","xmlUrl","year"],"type":"string"},"type":"array"},{"type":"null"}],"description":"Return only these result fields, e.g. `[\"title\", \"excerpt\"]`. A result carries 40+ fields, most null on any given row. `actId` and `citation` are always included. Unknown names are rejected 422. Omit for the full object.","examples":[["title","excerpt","state"]]},"includeBody":{"default":false,"description":"Return each hit's full text inline on `body`, instead of one `/section/{actId}/body` call per hit. Buys latency, not a discount: the 4-credit search PLUS 6 credits for every row that returns text, so ten rows is 64. ⚠️ It multiplies with `limit`; 50 rows is 304 credits in one call. Rows with no text are not charged, so read `creditsConsumed`. Prefer this over a bigger `excerptChars`: an excerpt is windowed around the match and can start mid-section, so it is not safe to quote.","examples":[true],"type":"boolean"},"limit":{"default":10,"description":"Number of results to return per page.","maximum":50,"minimum":1,"type":"integer"},"matchType":{"default":"any","description":"`any` (default) is hybrid semantic + keyword ranking, for natural-language questions. `all` requires every query term; `phrase` matches an exact phrase, for a defined term. To pull up one section from a citation, use resolve_statute_citation. A citation passed as the query ranks first only when it is inside your other filters.","enum":["any","all","phrase"],"examples":["phrase"],"type":"string"},"offset":{"default":0,"description":"How many results to skip, for paging. Every page of a query is cut from one ranking, so results never repeat or go missing between pages. The deepest reachable result is `offset` + `limit`; check `hasMore`.","maximum":70,"minimum":0,"type":"integer"},"part":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more parts within a title, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`: pass a hit's `parent.part` back. Pair with `titleNumber`; an unpaired part is rejected.","examples":["240"]},"publishedFrom":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or after this date (`YYYY-MM-DD`). This is the PUBLICATION date, which is not the same as `yearFrom`: that filters the version year of a section.","examples":["2024-01-01"],"format":"date"},"publishedTo":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or before this date.","examples":["2024-12-31"],"format":"date"},"query":{"description":"Search query in natural language.","examples":["insider trading penalties"],"maxLength":500,"minLength":2,"type":"string"},"source":{"anyOf":[{"enum":["administrative_guidance","ag_precedent","agency_guidance","bia_precedent","bis_advisory_opinion","cfpb_circular","cfpb_enforcement_action","cfpb_supervisory_guidance","cftc_staff_letter","cms_iom","copyright_circular","copyright_compendium","cpsc_advisory_opinion","cpsc_secg","ddtc_commodity_jurisdiction","ddtc_guidance","dfars","dfars_pgi","doe_appliance_guidance","doj_business_review","doj_justice_manual","doj_leniency","eeoc_guidance","far","fcc_declaratory_ruling","fdic_fil","ferc_policy_statement","fincen_amla_material","fincen_boi_compliance_guide","fincen_boi_faq","fincen_boi_rule_qa","fincen_guidance","fincen_ruling","frap","frb_sr_letter","frbp","frcp","frcrp","fre","ftc_administrative_decision","ftc_advisory_opinion","ftc_advocacy_filing","ftc_hsr_interpretation","ftc_policy_statement","hhs_ocr_hipaa_faq","hhs_ocr_hipaa_guidance","hhs_ocr_resolution_agreement","immigration_admin_precedent","irs_announcement","irs_irm","irs_notice","irs_rev_proc","irs_rev_rul","irs_written_determination","merger_guidelines","mpep","mspb_nonprecedential","mspb_precedential","nlrb_advice_memo","nlrb_board_decision","nlrb_gc_memo","occ_bulletin","occ_interpretive_letter","ofac_faq","olc_opinion","sct","sec_commission_opinion","senate_treaty","senate_treaty_document","senate_treaty_resolution","ssa_ruling","state_financial_bulletin","state_insurance_bulletin","tmep","us_tax_treaty","us_tax_treaty_technical_explanation","uscis_policy_manual","whd_foh","whd_opinion_letter"],"type":"string"},{"items":{"enum":["administrative_guidance","ag_precedent","agency_guidance","bia_precedent","bis_advisory_opinion","cfpb_circular","cfpb_enforcement_action","cfpb_supervisory_guidance","cftc_staff_letter","cms_iom","copyright_circular","copyright_compendium","cpsc_advisory_opinion","cpsc_secg","ddtc_commodity_jurisdiction","ddtc_guidance","dfars","dfars_pgi","doe_appliance_guidance","doj_business_review","doj_justice_manual","doj_leniency","eeoc_guidance","far","fcc_declaratory_ruling","fdic_fil","ferc_policy_statement","fincen_amla_material","fincen_boi_compliance_guide","fincen_boi_faq","fincen_boi_rule_qa","fincen_guidance","fincen_ruling","frap","frb_sr_letter","frbp","frcp","frcrp","fre","ftc_administrative_decision","ftc_advisory_opinion","ftc_advocacy_filing","ftc_hsr_interpretation","ftc_policy_statement","hhs_ocr_hipaa_faq","hhs_ocr_hipaa_guidance","hhs_ocr_resolution_agreement","immigration_admin_precedent","irs_announcement","irs_irm","irs_notice","irs_rev_proc","irs_rev_rul","irs_written_determination","merger_guidelines","mpep","mspb_nonprecedential","mspb_precedential","nlrb_advice_memo","nlrb_board_decision","nlrb_gc_memo","occ_bulletin","occ_interpretive_letter","ofac_faq","olc_opinion","sct","sec_commission_opinion","senate_treaty","senate_treaty_document","senate_treaty_resolution","ssa_ruling","state_financial_bulletin","state_insurance_bulletin","tmep","us_tax_treaty","us_tax_treaty_technical_explanation","uscis_policy_manual","whd_foh","whd_opinion_letter"],"type":"string"},"type":"array"},{"type":"null"}],"description":"The named body of law within a `corpusType` that folds several together: `FEDERAL_RULES` into `frcp`/`fre`/`sct`, `CFR` into `far`/`dfars`, `AGENCY_GUIDANCE` into ~34 agency sources, `AGENCY_ADJUDICATION` into `olc_opinion`/`mspb_precedential`/`mspb_nonprecedential`. Every result carries its own `source`, so a hit's value can be passed straight back.","examples":["sct"]},"state":{"anyOf":[{"enum":["federal","al","ak","as","az","ar","ca","co","ct","de","dc","fl","ga","gu","hi","id","il","in","ia","ks","ky","la","me","md","ma","mi","mn","ms","mo","mt","ne","nv","nh","nj","nm","ny","nc","nd","mp","oh","ok","or","pa","pr","ri","sc","sd","tn","tx","ut","vt","vi","va","wa","wv","wi","wy"],"type":"string"},{"items":{"enum":["federal","al","ak","as","az","ar","ca","co","ct","de","dc","fl","ga","gu","hi","id","il","in","ia","ks","ky","la","me","md","ma","mi","mn","ms","mo","mt","ne","nv","nh","nj","nm","ny","nc","nd","mp","oh","ok","or","pa","pr","ri","sc","sd","tn","tx","ut","vt","vi","va","wa","wv","wi","wy"],"type":"string"},"type":"array"},{"type":"null"}],"description":"Jurisdiction. A 2-letter code for one of the 52 supported US jurisdictions (50 states + DC + PR), or `federal` for USC / CFR / Constitution / federal rules. Pass a list to search several at once. Case-insensitive. Omit to search every jurisdiction. Leave it unset when the query is a citation that already names its jurisdiction (`42 U.S.C.`, `C.F.R.`, `Fed. R. Civ. P.`, `U.S. Const.`): a state filter excludes federal law. Never carry a state over from an earlier question.","examples":["ca"]},"titleNumber":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"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).","examples":[17]},"yearFrom":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or after this year; pair with `yearTo` for a window. Tracks the publisher's own amendment credit, not when we rebuilt the corpus. About a fifth of sections carry no credit and are excluded once either bound is set.","examples":[2020]},"yearTo":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or before this year. This filters the LAST amendment, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed in 2024. A currency filter, not point-in-time retrieval.","examples":[2026]}},"required":["query"],"type":"object"}

before
{"properties":{"actStatus":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Positively scope to raw publisher statuses: `repealed` for dead law only, `in_force` for sections affirmatively marked current. The inverse of `excludeRepealed`, and what a compliance diff asking what was LOST needs. Combining a dead status with `excludeRepealed: true` is rejected 422.","enum":["abolished","deleted","expired","in_force","inactive","non_precedential","not_funded","not_yet_effective","omitted","proposed","recodified","recompiled","rejected","relocated","removed","renumbered","repealed","rescinded","reserved","revoked","superseded","terminated","transferred","unconstitutional","vacant","vacated","vetoed","withdrawn"],"examples":["repealed"]},"agency":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Federal Register agency slug, e.g. `environmental-protection-agency`. The agency's full name (`Environmental Protection Agency`) or its Federal Register acronym (`EPA`, `e.p.a.`) resolves to the same slug; an acronym the Federal Register gives to more than one agency (`FS`) or a value naming no agency the corpus holds is a 422, never a charge. Pass a list to match any of several. Applies to `FEDERAL_REGISTER` and `EXECUTIVE_ACTION`; other corpora carry no agency, so combining this with them returns nothing.","examples":["environmental-protection-agency"]},"article":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Scope a search to one or more articles. On `CONSTITUTION` and `STATE_CONSTITUTION` this is the article label as `GET /us/statutes/divisions` lists it (`Amendment XIV`, `Article IV`, `Preamble`). On `STATE` / `REGULATION` it is the article of a code divided by article instead of chapter, such as New York (`2-A` in `ny_jud`). This is the search side of `parent.article`: pass a hit's `parent` straight back to search within its article.\n\nPass the `identifier` exactly as the listing returned it; a case slip such as `amendment xiv` also matches. Article labels repeat, so `article` needs a `corpusType` from one of those two families, `STATE_CONSTITUTION` also needs `state`, and `STATE` / `REGULATION` need the `code`. A request missing one is refused with 422 before anything is charged. String or list.","examples":["Amendment XIV"]},"changedSince":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only sections we OBSERVED changing on or after this date (`YYYY-MM-DD`). Observed, not effective: the date we saw it, an upper bound on when it took effect. Capture began long after the corpus did and events sweep at 24 months, so empty means no captured change, never that nothing was amended.","examples":["2026-08-01"],"format":"date"},"chapter":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more chapters within a title or code, e.g. `21` for USC Title 42 Chapter 21. Pass a hit's `parent.chapter` back to search its neighbors. Chapter numbers repeat across titles, so pair with `titleNumber` (USC) or `code` (state); an unpaired chapter is rejected.","examples":["21"]},"code":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s from list_statute_divisions. List allowed, across states. The only way to scope below a whole jurisdiction: `state=tx` alone searches all ~15 Texas codes.","examples":["tx_pe"]},"corpusType":{"anyOf":[{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},{"items":{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to one corpus, or several as a list. Federal: `USC`, `USC_ANNUAL` (published past editions), `CFR`, `CFR_ANNUAL` (same, superseded by construction), `CONSTITUTION`, `FEDERAL_RULES`, `FEDERAL_REGISTER`, `FEDERAL_REGISTER_NOTICE` (a curated slice, not the whole series), `EXECUTIVE_ACTION`, `AGENCY_GUIDANCE`, `SENTENCING_GUIDELINES`, `US_TAX_TREATY`, `SESSION_LAW` (Statutes at Large, as enacted), `STATUTE_COMPILATION` (an act as amended through a stated later law), `AGENCY_ADJUDICATION` (DOJ Office of Legal Counsel opinions and MSPB decisions). Pair with `state`: `STATE`, `REGULATION`, `STATE_RULES`, `STATE_CONSTITUTION`, `STATE_AGENCY_GUIDANCE`, `STATE_AG_OPINION`. Omit for all.","examples":["CFR"]},"documentType":{"anyOf":[{"enum":["final","proposed","presidential"],"type":"string"},{"type":"null"}],"description":"Federal Register document stage: `final` (a rule in force), `proposed` (an NPRM), or `presidential` (a Presidential Document, the `EXECUTIVE_ACTION` corpus). The same distinction appears in each row's `actId` prefix (`FR_RULE_` vs `FR_PRORULE_`).","examples":["final"]},"excerptChars":{"default":500,"description":"Characters of matching text to include in each result's `excerpt`. The excerpt is a ranking preview; use `/us/statutes/section/{actId}/body` for the full text. Default 500.","maximum":4000,"minimum":100,"type":"integer"},"excludeRepealed":{"default":false,"description":"Drop sections whose own status says they are not operative (repealed, renumbered, transferred, expired, superseded, omitted, and the rest). Removes what we KNOW is dead; it does not promise the remainder is good law. Read `goodLawStatus` per result to tell them apart: `good_law` is checked, `unknown` is unchecked.","examples":[true],"type":"boolean"},"fields":{"anyOf":[{"items":{"type":"string"},"type":"array","uniqueItems":true},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Return only these result fields, e.g. `[\"title\", \"excerpt\"]`. A result carries 40+ fields, most null on any given row. `actId` and `citation` are always included. Unknown names are rejected 422. Omit for the full object.","enum":["abstract","actId","actStatus","action","adoptedAfterCurrentThrough","adoptingCitations","agencies","agencySlugs","alternateCitations","amendmentHistory","amendmentNote","amendmentYears","amendmentsCount","articleName","articleNumber","audience","body","breadcrumb","caseName","chapter","chapterName","citation","citationShort","committeeNote","corpusType","court","crossReferencesCfr","crossReferencesUsc","currencyNote","currencyYear","currentThrough","datesText","displayLabel","displayPath","documentNumber","documentSubtype","documentTypeLabel","docxUrl","edition","effectiveDate","effectiveDateRaw","excerpt","expirationDate","expirationDateRaw","externalUrl","federalRegisterCitations","forum","frCommentsCloseOn","frCorrectionOf","frCorrections","frDocketIds","frEffectiveOn","frEndPage","frRegulationIdNumbers","frRegulationsDotGovUrl","frRelatedDocuments","frSignificant","frStartPage","frVolume","goodLawStatus","govInfoHtmlUrl","govInfoPdfUrl","granuleId","history","historyEffectiveDate","htmlUrl","implementingRegulations","issueDate","issueDateRaw","issuingAgency","languageCode","lastAmendedDate","lastAmendedDateRaw","lastAmendedYear","lawImplemented","licenseNote","originalEnactmentDate","originalEnactmentDateRaw","packageId","parent","part","partName","pdfUrl","pendingAdoptions","popularName","president","priorEffectiveDates","program","publicLawCites","publicLaws","publicationDate","publicationDateRaw","publisherKey","referencedShortTitles","relatedCitations","relatedDocuments","releaseDate","releaseDateRaw","relevanceScore","renumberedTo","renumberedToLabel","requesters","rescindedOn","rescindedOnRaw","reviewDate","reviewDateRaw","ruleSet","ruleSetCode","sectionNumber","sectionTitle","settlementAmount","signingDate","signingDateRaw","source","sourceCharEnd","sourceCharStart","sourceCredit","sourceNote","sourcePageEnd","sourcePageStart","sourceUrl","state","stateHtmlUrl","statutoryAuthority","subchapter","subchapterName","subject","subjectNumber","subpart","subpartName","subtitle","subtitleName","supersededBy","supersedes","supersessionActions","textUrl","title","titleName","titleNumber","topLevelTitle","topics","transferredTo","transferredToLabel","versionId","volume","wordCount","xmlUrl","year"],"examples":[["title","excerpt","state"]]},"includeBody":{"default":false,"description":"Return each hit's full text inline on `body`, instead of one `/section/{actId}/body` call per hit. Buys latency, not a discount: the 4-credit search PLUS 6 credits for every row that returns text, so ten rows is 64. ⚠️ It multiplies with `limit`; 50 rows is 304 credits in one call. Rows with no text are not charged, so read `creditsConsumed`. Prefer this over a bigger `excerptChars`: an excerpt is windowed around the match and can start mid-section, so it is not safe to quote.","examples":[true],"type":"boolean"},"limit":{"default":10,"description":"Number of results to return per page.","maximum":50,"minimum":1,"type":"integer"},"matchType":{"default":"any","description":"`any` (default) is hybrid semantic + keyword ranking, for natural-language questions. `all` requires every query term; `phrase` matches an exact phrase, for a defined term. To pull up one section, pass its citation as the query and it resolves to that section at rank 1.","enum":["any","all","phrase"],"examples":["phrase"],"type":"string"},"offset":{"default":0,"description":"How many results to skip, for paging. Every page of a query is cut from one ranking, so results never repeat or go missing between pages. The deepest reachable result is `offset` + `limit`; check `hasMore`.","maximum":70,"minimum":0,"type":"integer"},"part":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more parts within a title, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`: pass a hit's `parent.part` back. Pair with `titleNumber`; an unpaired part is rejected.","examples":["240"]},"publishedFrom":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or after this date (`YYYY-MM-DD`). This is the PUBLICATION date, which is not the same as `yearFrom`: that filters the version year of a section.","examples":["2024-01-01"],"format":"date"},"publishedTo":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or before this date.","examples":["2024-12-31"],"format":"date"},"query":{"description":"Search query in natural language.","examples":["insider trading penalties"],"maxLength":500,"minLength":2,"type":"string"},"source":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"The named body of law within a `corpusType` that folds several together: `FEDERAL_RULES` into `frcp`/`fre`/`sct`, `CFR` into `far`/`dfars`, `AGENCY_GUIDANCE` into ~34 agency sources, `AGENCY_ADJUDICATION` into `olc_opinion`/`mspb_precedential`/`mspb_nonprecedential`. Every result carries its own `source`, so a hit's value can be passed straight back.","enum":["administrative_guidance","ag_precedent","agency_guidance","bia_precedent","bis_advisory_opinion","cfpb_circular","cfpb_enforcement_action","cfpb_supervisory_guidance","cftc_staff_letter","cms_iom","copyright_circular","copyright_compendium","cpsc_advisory_opinion","cpsc_secg","ddtc_commodity_jurisdiction","ddtc_guidance","dfars","dfars_pgi","doe_appliance_guidance","doj_business_review","doj_justice_manual","doj_leniency","eeoc_guidance","far","fcc_declaratory_ruling","fdic_fil","ferc_policy_statement","fincen_amla_material","fincen_boi_compliance_guide","fincen_boi_faq","fincen_boi_rule_qa","fincen_guidance","fincen_ruling","frap","frb_sr_letter","frbp","frcp","frcrp","fre","ftc_administrative_decision","ftc_advisory_opinion","ftc_advocacy_filing","ftc_hsr_interpretation","ftc_policy_statement","hhs_ocr_hipaa_faq","hhs_ocr_hipaa_guidance","hhs_ocr_resolution_agreement","immigration_admin_precedent","irs_announcement","irs_irm","irs_notice","irs_rev_proc","irs_rev_rul","irs_written_determination","merger_guidelines","mpep","mspb_nonprecedential","mspb_precedential","nlrb_advice_memo","nlrb_board_decision","nlrb_gc_memo","occ_bulletin","occ_interpretive_letter","ofac_faq","olc_opinion","sct","sec_commission_opinion","senate_treaty","senate_treaty_document","senate_treaty_resolution","ssa_ruling","state_financial_bulletin","state_insurance_bulletin","tmep","us_tax_treaty","us_tax_treaty_technical_explanation","uscis_policy_manual","whd_foh","whd_opinion_letter"],"examples":["sct"]},"state":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Jurisdiction. A 2-letter code for one of the 52 supported US jurisdictions (50 states + DC + PR), or `federal` for USC / CFR / Constitution / federal rules. Pass a list to search several at once. Case-insensitive. Omit to search every jurisdiction.","enum":["federal","al","ak","az","ar","ca","co","ct","de","dc","fl","ga","hi","id","il","in","ia","ks","ky","la","me","md","ma","mi","mn","ms","mo","mt","ne","nv","nh","nj","nm","ny","nc","nd","oh","ok","or","pa","pr","ri","sc","sd","tn","tx","ut","vt","va","wa","wv","wi","wy"],"examples":["ca"]},"titleNumber":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"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).","examples":[17]},"yearFrom":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or after this year; pair with `yearTo` for a window. Tracks the publisher's own amendment credit, not when we rebuilt the corpus. About a fifth of sections carry no credit and are excluded once either bound is set.","examples":[2020]},"yearTo":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or before this year. This filters the LAST amendment, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed in 2024. A currency filter, not point-in-time retrieval.","examples":[2026]}},"required":["query"],"type":"object"}

before
{"properties":{"actStatus":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Positively scope to raw publisher statuses: `repealed` for dead law only, `in_force` for sections affirmatively marked current. The inverse of `excludeRepealed`, and what a compliance diff asking what was LOST needs. Combining a dead status with `excludeRepealed: true` is rejected 422.","enum":["abolished","deleted","expired","in_force","inactive","non_precedential","not_funded","not_yet_effective","omitted","proposed","recodified","recompiled","rejected","relocated","removed","renumbered","repealed","rescinded","reserved","revoked","superseded","terminated","transferred","unconstitutional","vacant","vacated","vetoed","withdrawn"],"examples":["repealed"]},"agency":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Federal Register agency slug, e.g. `environmental-protection-agency`. Pass a list to match any of several. Applies to `FEDERAL_REGISTER` and `EXECUTIVE_ACTION`; other corpora carry no agency, so combining this with them returns nothing.","examples":["environmental-protection-agency"]},"article":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Scope a search to one or more articles. On `CONSTITUTION` and `STATE_CONSTITUTION` this is the article label as `GET /us/statutes/divisions` lists it (`Amendment XIV`, `Article IV`, `Preamble`). On `STATE` / `REGULATION` it is the article of a code divided by article instead of chapter, such as New York (`2-A` in `ny_jud`). This is the search side of `parent.article`: pass a hit's `parent` straight back to search within its article.\n\nPass the `identifier` exactly as the listing returned it; a case slip such as `amendment xiv` also matches. Article labels repeat, so `article` needs a `corpusType` from one of those two families, `STATE_CONSTITUTION` also needs `state`, and `STATE` / `REGULATION` need the `code`. A request missing one is refused with 422 before anything is charged. String or list.","examples":["Amendment XIV"]},"changedSince":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only sections we OBSERVED changing on or after this date (`YYYY-MM-DD`). Observed, not effective: the date we saw it, an upper bound on when it took effect. Capture began long after the corpus did and events sweep at 24 months, so empty means no captured change, never that nothing was amended.","examples":["2026-08-01"],"format":"date"},"chapter":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more chapters within a title or code, e.g. `21` for USC Title 42 Chapter 21. Pass a hit's `parent.chapter` back to search its neighbors. Chapter numbers repeat across titles, so pair with `titleNumber` (USC) or `code` (state); an unpaired chapter is rejected.","examples":["21"]},"code":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s from list_statute_divisions. List allowed, across states. The only way to scope below a whole jurisdiction: `state=tx` alone searches all ~15 Texas codes.","examples":["tx_pe"]},"corpusType":{"anyOf":[{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},{"items":{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to one corpus, or several as a list. Federal: `USC`, `USC_ANNUAL` (published past editions), `CFR`, `CFR_ANNUAL` (same, superseded by construction), `CONSTITUTION`, `FEDERAL_RULES`, `FEDERAL_REGISTER`, `FEDERAL_REGISTER_NOTICE` (a curated slice, not the whole series), `EXECUTIVE_ACTION`, `AGENCY_GUIDANCE`, `SENTENCING_GUIDELINES`, `US_TAX_TREATY`, `SESSION_LAW` (Statutes at Large, as enacted), `STATUTE_COMPILATION` (an act as amended through a stated later law), `AGENCY_ADJUDICATION` (DOJ Office of Legal Counsel opinions and MSPB decisions). Pair with `state`: `STATE`, `REGULATION`, `STATE_RULES`, `STATE_CONSTITUTION`, `STATE_AGENCY_GUIDANCE`, `STATE_AG_OPINION`. Omit for all.","examples":["CFR"]},"documentType":{"anyOf":[{"enum":["final","proposed","presidential"],"type":"string"},{"type":"null"}],"description":"Federal Register document stage: `final` (a rule in force), `proposed` (an NPRM), or `presidential` (a Presidential Document, the `EXECUTIVE_ACTION` corpus). The same distinction appears in each row's `actId` prefix (`FR_RULE_` vs `FR_PRORULE_`).","examples":["final"]},"excerptChars":{"default":500,"description":"Characters of matching text to include in each result's `excerpt`. The excerpt is a ranking preview; use `/us/statutes/section/{actId}/body` for the full text. Default 500.","maximum":4000,"minimum":100,"type":"integer"},"excludeRepealed":{"default":false,"description":"Drop sections whose own status says they are not operative (repealed, renumbered, transferred, expired, superseded, omitted, and the rest). Removes what we KNOW is dead; it does not promise the remainder is good law. Read `goodLawStatus` per result to tell them apart: `good_law` is checked, `unknown` is unchecked.","examples":[true],"type":"boolean"},"fields":{"anyOf":[{"items":{"type":"string"},"type":"array","uniqueItems":true},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Return only these result fields, e.g. `[\"title\", \"excerpt\"]`. A result carries 40+ fields, most null on any given row. `actId` and `citation` are always included. Unknown names are rejected 422. Omit for the full object.","enum":["abstract","actId","actStatus","action","adoptingCitations","agencies","agencySlugs","alternateCitations","amendmentHistory","amendmentNote","amendmentYears","amendmentsCount","articleName","articleNumber","audience","body","breadcrumb","caseName","chapter","chapterName","citation","citationShort","committeeNote","corpusType","court","crossReferencesCfr","crossReferencesUsc","currencyNote","currencyYear","currentThrough","datesText","displayLabel","displayPath","documentNumber","documentSubtype","documentTypeLabel","docxUrl","edition","effectiveDate","effectiveDateRaw","excerpt","expirationDate","expirationDateRaw","externalUrl","federalRegisterCitations","forum","frCommentsCloseOn","frCorrectionOf","frCorrections","frDocketIds","frEffectiveOn","frEndPage","frRegulationIdNumbers","frRegulationsDotGovUrl","frRelatedDocuments","frSignificant","frStartPage","frVolume","goodLawStatus","govInfoHtmlUrl","govInfoPdfUrl","granuleId","history","historyEffectiveDate","htmlUrl","implementingRegulations","issueDate","issueDateRaw","issuingAgency","languageCode","lastAmendedDate","lastAmendedYear","lawImplemented","licenseNote","originalEnactmentDate","originalEnactmentDateRaw","packageId","parent","part","partName","pdfUrl","popularName","president","priorEffectiveDates","program","publicLawCites","publicLaws","publicationDate","publisherKey","referencedShortTitles","relatedCitations","relatedDocuments","releaseDate","relevanceScore","renumberedTo","renumberedToLabel","requesters","rescindedOn","rescindedOnRaw","reviewDate","ruleSet","ruleSetCode","sectionNumber","sectionTitle","settlementAmount","signingDate","signingDateRaw","source","sourceCharEnd","sourceCharStart","sourceCredit","sourceNote","sourcePageEnd","sourcePageStart","state","stateHtmlUrl","statutoryAuthority","subchapter","subchapterName","subject","subjectNumber","subpart","subpartName","subtitle","subtitleName","supersededBy","supersedes","supersessionActions","textUrl","title","titleName","titleNumber","topLevelTitle","topics","transferredTo","transferredToLabel","versionId","volume","wordCount","xmlUrl","year"],"examples":[["title","excerpt","state"]]},"includeBody":{"default":false,"description":"Return each hit's full text inline on `body`, instead of one `/section/{actId}/body` call per hit. Buys latency, not a discount: the 4-credit search PLUS 6 credits for every row that returns text, so ten rows is 64. ⚠️ It multiplies with `limit`; 50 rows is 304 credits in one call. Rows with no text are not charged, so read `creditsConsumed`. Prefer this over a bigger `excerptChars`: an excerpt is windowed around the match and can start mid-section, so it is not safe to quote.","examples":[true],"type":"boolean"},"limit":{"default":10,"description":"Number of results to return per page.","maximum":50,"minimum":1,"type":"integer"},"matchType":{"default":"any","description":"`any` (default) is hybrid semantic + keyword ranking, for natural-language questions. `all` requires every query term; `phrase` matches an exact phrase, for a defined term. To pull up one section, pass its citation as the query and it resolves to that section at rank 1.","enum":["any","all","phrase"],"examples":["phrase"],"type":"string"},"offset":{"default":0,"description":"How many results to skip, for paging. Every page of a query is cut from one ranking, so results never repeat or go missing between pages. The deepest reachable result is `offset` + `limit`; check `hasMore`.","maximum":70,"minimum":0,"type":"integer"},"part":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more parts within a title, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`: pass a hit's `parent.part` back. Pair with `titleNumber`; an unpaired part is rejected.","examples":["240"]},"publishedFrom":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or after this date (`YYYY-MM-DD`). This is the PUBLICATION date, which is not the same as `yearFrom`: that filters the version year of a section.","examples":["2024-01-01"],"format":"date"},"publishedTo":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or before this date.","examples":["2024-12-31"],"format":"date"},"query":{"description":"Search query in natural language.","examples":["insider trading penalties"],"maxLength":500,"minLength":2,"type":"string"},"source":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"The named body of law within a `corpusType` that folds several together: `FEDERAL_RULES` into `frcp`/`fre`/`sct`, `CFR` into `far`/`dfars`, `AGENCY_GUIDANCE` into ~34 agency sources, `AGENCY_ADJUDICATION` into `olc_opinion`/`mspb_precedential`/`mspb_nonprecedential`. Every result carries its own `source`, so a hit's value can be passed straight back.","enum":["administrative_guidance","ag_precedent","agency_guidance","bia_precedent","bis_advisory_opinion","cfpb_circular","cfpb_enforcement_action","cfpb_supervisory_guidance","cftc_staff_letter","cms_iom","copyright_circular","copyright_compendium","cpsc_advisory_opinion","cpsc_secg","ddtc_commodity_jurisdiction","ddtc_guidance","dfars","dfars_pgi","doe_appliance_guidance","doj_business_review","doj_justice_manual","doj_leniency","eeoc_guidance","far","fcc_declaratory_ruling","fdic_fil","ferc_policy_statement","fincen_amla_material","fincen_boi_compliance_guide","fincen_boi_faq","fincen_boi_rule_qa","fincen_guidance","fincen_ruling","frap","frb_sr_letter","frbp","frcp","frcrp","fre","ftc_administrative_decision","ftc_advisory_opinion","ftc_advocacy_filing","ftc_hsr_interpretation","ftc_policy_statement","hhs_ocr_hipaa_faq","hhs_ocr_hipaa_guidance","hhs_ocr_resolution_agreement","immigration_admin_precedent","irs_announcement","irs_irm","irs_notice","irs_rev_proc","irs_rev_rul","irs_written_determination","merger_guidelines","mpep","mspb_nonprecedential","mspb_precedential","nlrb_advice_memo","nlrb_board_decision","nlrb_gc_memo","occ_bulletin","occ_interpretive_letter","ofac_faq","olc_opinion","sct","sec_commission_opinion","senate_treaty","senate_treaty_document","senate_treaty_resolution","ssa_ruling","state_financial_bulletin","state_insurance_bulletin","tmep","us_tax_treaty","us_tax_treaty_technical_explanation","uscis_policy_manual","whd_foh","whd_opinion_letter"],"examples":["sct"]},"state":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Jurisdiction. A 2-letter code for one of the 52 supported US jurisdictions (50 states + DC + PR), or `federal` for USC / CFR / Constitution / federal rules. Pass a list to search several at once. Case-insensitive. Omit to search every jurisdiction.","enum":["federal","al","ak","az","ar","ca","co","ct","de","dc","fl","ga","hi","id","il","in","ia","ks","ky","la","me","md","ma","mi","mn","ms","mo","mt","ne","nv","nh","nj","nm","ny","nc","nd","oh","ok","or","pa","pr","ri","sc","sd","tn","tx","ut","vt","va","wa","wv","wi","wy"],"examples":["ca"]},"titleNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"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).","examples":[17]},"yearFrom":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or after this year; pair with `yearTo` for a window. Tracks the publisher's own amendment credit, not when we rebuilt the corpus. About a fifth of sections carry no credit and are excluded once either bound is set.","examples":[2020]},"yearTo":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or before this year. This filters the LAST amendment, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed in 2024. A currency filter, not point-in-time retrieval.","examples":[2026]}},"required":["query"],"type":"object"}

after
{"properties":{"actStatus":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Positively scope to raw publisher statuses: `repealed` for dead law only, `in_force` for sections affirmatively marked current. The inverse of `excludeRepealed`, and what a compliance diff asking what was LOST needs. Combining a dead status with `excludeRepealed: true` is rejected 422.","enum":["abolished","deleted","expired","in_force","inactive","non_precedential","not_funded","not_yet_effective","omitted","proposed","recodified","recompiled","rejected","relocated","removed","renumbered","repealed","rescinded","reserved","revoked","superseded","terminated","transferred","unconstitutional","vacant","vacated","vetoed","withdrawn"],"examples":["repealed"]},"agency":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Federal Register agency slug, e.g. `environmental-protection-agency`. The agency's full name (`Environmental Protection Agency`) or its Federal Register acronym (`EPA`, `e.p.a.`) resolves to the same slug; an acronym the Federal Register gives to more than one agency (`FS`) or a value naming no agency the corpus holds is a 422, never a charge. Pass a list to match any of several. Applies to `FEDERAL_REGISTER` and `EXECUTIVE_ACTION`; other corpora carry no agency, so combining this with them returns nothing.","examples":["environmental-protection-agency"]},"article":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Scope a search to one or more articles. On `CONSTITUTION` and `STATE_CONSTITUTION` this is the article label as `GET /us/statutes/divisions` lists it (`Amendment XIV`, `Article IV`, `Preamble`). On `STATE` / `REGULATION` it is the article of a code divided by article instead of chapter, such as New York (`2-A` in `ny_jud`). This is the search side of `parent.article`: pass a hit's `parent` straight back to search within its article.\n\nPass the `identifier` exactly as the listing returned it; a case slip such as `amendment xiv` also matches. Article labels repeat, so `article` needs a `corpusType` from one of those two families, `STATE_CONSTITUTION` also needs `state`, and `STATE` / `REGULATION` need the `code`. A request missing one is refused with 422 before anything is charged. String or list.","examples":["Amendment XIV"]},"changedSince":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only sections we OBSERVED changing on or after this date (`YYYY-MM-DD`). Observed, not effective: the date we saw it, an upper bound on when it took effect. Capture began long after the corpus did and events sweep at 24 months, so empty means no captured change, never that nothing was amended.","examples":["2026-08-01"],"format":"date"},"chapter":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more chapters within a title or code, e.g. `21` for USC Title 42 Chapter 21. Pass a hit's `parent.chapter` back to search its neighbors. Chapter numbers repeat across titles, so pair with `titleNumber` (USC) or `code` (state); an unpaired chapter is rejected.","examples":["21"]},"code":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s from list_statute_divisions. List allowed, across states. The only way to scope below a whole jurisdiction: `state=tx` alone searches all ~15 Texas codes.","examples":["tx_pe"]},"corpusType":{"anyOf":[{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},{"items":{"enum":["USC","CFR","STATE","CONSTITUTION","FEDERAL_RULES","STATE_CONSTITUTION","STATE_RULES","EXECUTIVE_ACTION","REGULATION","FEDERAL_REGISTER","FEDERAL_REGISTER_NOTICE","AGENCY_GUIDANCE","SENTENCING_GUIDELINES","US_TAX_TREATY","STATE_AGENCY_GUIDANCE","STATE_AG_OPINION","SESSION_LAW","STATUTE_COMPILATION","AGENCY_ADJUDICATION","CFR_ANNUAL","USC_ANNUAL"],"type":"string"},"type":"array"},{"type":"null"}],"description":"Restrict to one corpus, or several as a list. Federal: `USC`, `USC_ANNUAL` (published past editions), `CFR`, `CFR_ANNUAL` (same, superseded by construction), `CONSTITUTION`, `FEDERAL_RULES`, `FEDERAL_REGISTER`, `FEDERAL_REGISTER_NOTICE` (a curated slice, not the whole series), `EXECUTIVE_ACTION`, `AGENCY_GUIDANCE`, `SENTENCING_GUIDELINES`, `US_TAX_TREATY`, `SESSION_LAW` (Statutes at Large, as enacted), `STATUTE_COMPILATION` (an act as amended through a stated later law), `AGENCY_ADJUDICATION` (DOJ Office of Legal Counsel opinions and MSPB decisions). Pair with `state`: `STATE`, `REGULATION`, `STATE_RULES`, `STATE_CONSTITUTION`, `STATE_AGENCY_GUIDANCE`, `STATE_AG_OPINION`. Omit for all.","examples":["CFR"]},"documentType":{"anyOf":[{"enum":["final","proposed","presidential"],"type":"string"},{"type":"null"}],"description":"Federal Register document stage: `final` (a rule in force), `proposed` (an NPRM), or `presidential` (a Presidential Document, the `EXECUTIVE_ACTION` corpus). The same distinction appears in each row's `actId` prefix (`FR_RULE_` vs `FR_PRORULE_`).","examples":["final"]},"excerptChars":{"default":500,"description":"Characters of matching text to include in each result's `excerpt`. The excerpt is a ranking preview; use `/us/statutes/section/{actId}/body` for the full text. Default 500.","maximum":4000,"minimum":100,"type":"integer"},"excludeRepealed":{"default":false,"description":"Drop sections whose own status says they are not operative (repealed, renumbered, transferred, expired, superseded, omitted, and the rest). Removes what we KNOW is dead; it does not promise the remainder is good law. Read `goodLawStatus` per result to tell them apart: `good_law` is checked, `unknown` is unchecked.","examples":[true],"type":"boolean"},"fields":{"anyOf":[{"items":{"type":"string"},"type":"array","uniqueItems":true},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Return only these result fields, e.g. `[\"title\", \"excerpt\"]`. A result carries 40+ fields, most null on any given row. `actId` and `citation` are always included. Unknown names are rejected 422. Omit for the full object.","enum":["abstract","actId","actStatus","action","adoptedAfterCurrentThrough","adoptingCitations","agencies","agencySlugs","alternateCitations","amendmentHistory","amendmentNote","amendmentYears","amendmentsCount","articleName","articleNumber","audience","body","breadcrumb","caseName","chapter","chapterName","citation","citationShort","committeeNote","corpusType","court","crossReferencesCfr","crossReferencesUsc","currencyNote","currencyYear","currentThrough","datesText","displayLabel","displayPath","documentNumber","documentSubtype","documentTypeLabel","docxUrl","edition","effectiveDate","effectiveDateRaw","excerpt","expirationDate","expirationDateRaw","externalUrl","federalRegisterCitations","forum","frCommentsCloseOn","frCorrectionOf","frCorrections","frDocketIds","frEffectiveOn","frEndPage","frRegulationIdNumbers","frRegulationsDotGovUrl","frRelatedDocuments","frSignificant","frStartPage","frVolume","goodLawStatus","govInfoHtmlUrl","govInfoPdfUrl","granuleId","history","historyEffectiveDate","htmlUrl","implementingRegulations","issueDate","issueDateRaw","issuingAgency","languageCode","lastAmendedDate","lastAmendedDateRaw","lastAmendedYear","lawImplemented","licenseNote","originalEnactmentDate","originalEnactmentDateRaw","packageId","parent","part","partName","pdfUrl","pendingAdoptions","popularName","president","priorEffectiveDates","program","publicLawCites","publicLaws","publicationDate","publicationDateRaw","publisherKey","referencedShortTitles","relatedCitations","relatedDocuments","releaseDate","releaseDateRaw","relevanceScore","renumberedTo","renumberedToLabel","requesters","rescindedOn","rescindedOnRaw","reviewDate","reviewDateRaw","ruleSet","ruleSetCode","sectionNumber","sectionTitle","settlementAmount","signingDate","signingDateRaw","source","sourceCharEnd","sourceCharStart","sourceCredit","sourceNote","sourcePageEnd","sourcePageStart","sourceUrl","state","stateHtmlUrl","statutoryAuthority","subchapter","subchapterName","subject","subjectNumber","subpart","subpartName","subtitle","subtitleName","supersededBy","supersedes","supersessionActions","textUrl","title","titleName","titleNumber","topLevelTitle","topics","transferredTo","transferredToLabel","versionId","volume","wordCount","xmlUrl","year"],"examples":[["title","excerpt","state"]]},"includeBody":{"default":false,"description":"Return each hit's full text inline on `body`, instead of one `/section/{actId}/body` call per hit. Buys latency, not a discount: the 4-credit search PLUS 6 credits for every row that returns text, so ten rows is 64. ⚠️ It multiplies with `limit`; 50 rows is 304 credits in one call. Rows with no text are not charged, so read `creditsConsumed`. Prefer this over a bigger `excerptChars`: an excerpt is windowed around the match and can start mid-section, so it is not safe to quote.","examples":[true],"type":"boolean"},"limit":{"default":10,"description":"Number of results to return per page.","maximum":50,"minimum":1,"type":"integer"},"matchType":{"default":"any","description":"`any` (default) is hybrid semantic + keyword ranking, for natural-language questions. `all` requires every query term; `phrase` matches an exact phrase, for a defined term. To pull up one section, pass its citation as the query and it resolves to that section at rank 1.","enum":["any","all","phrase"],"examples":["phrase"],"type":"string"},"offset":{"default":0,"description":"How many results to skip, for paging. Every page of a query is cut from one ranking, so results never repeat or go missing between pages. The deepest reachable result is `offset` + `limit`; check `hasMore`.","maximum":70,"minimum":0,"type":"integer"},"part":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"One or more parts within a title, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`: pass a hit's `parent.part` back. Pair with `titleNumber`; an unpaired part is rejected.","examples":["240"]},"publishedFrom":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or after this date (`YYYY-MM-DD`). This is the PUBLICATION date, which is not the same as `yearFrom`: that filters the version year of a section.","examples":["2024-01-01"],"format":"date"},"publishedTo":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"Only return Federal Register documents published on or before this date.","examples":["2024-12-31"],"format":"date"},"query":{"description":"Search query in natural language.","examples":["insider trading penalties"],"maxLength":500,"minLength":2,"type":"string"},"source":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"The named body of law within a `corpusType` that folds several together: `FEDERAL_RULES` into `frcp`/`fre`/`sct`, `CFR` into `far`/`dfars`, `AGENCY_GUIDANCE` into ~34 agency sources, `AGENCY_ADJUDICATION` into `olc_opinion`/`mspb_precedential`/`mspb_nonprecedential`. Every result carries its own `source`, so a hit's value can be passed straight back.","enum":["administrative_guidance","ag_precedent","agency_guidance","bia_precedent","bis_advisory_opinion","cfpb_circular","cfpb_enforcement_action","cfpb_supervisory_guidance","cftc_staff_letter","cms_iom","copyright_circular","copyright_compendium","cpsc_advisory_opinion","cpsc_secg","ddtc_commodity_jurisdiction","ddtc_guidance","dfars","dfars_pgi","doe_appliance_guidance","doj_business_review","doj_justice_manual","doj_leniency","eeoc_guidance","far","fcc_declaratory_ruling","fdic_fil","ferc_policy_statement","fincen_amla_material","fincen_boi_compliance_guide","fincen_boi_faq","fincen_boi_rule_qa","fincen_guidance","fincen_ruling","frap","frb_sr_letter","frbp","frcp","frcrp","fre","ftc_administrative_decision","ftc_advisory_opinion","ftc_advocacy_filing","ftc_hsr_interpretation","ftc_policy_statement","hhs_ocr_hipaa_faq","hhs_ocr_hipaa_guidance","hhs_ocr_resolution_agreement","immigration_admin_precedent","irs_announcement","irs_irm","irs_notice","irs_rev_proc","irs_rev_rul","irs_written_determination","merger_guidelines","mpep","mspb_nonprecedential","mspb_precedential","nlrb_advice_memo","nlrb_board_decision","nlrb_gc_memo","occ_bulletin","occ_interpretive_letter","ofac_faq","olc_opinion","sct","sec_commission_opinion","senate_treaty","senate_treaty_document","senate_treaty_resolution","ssa_ruling","state_financial_bulletin","state_insurance_bulletin","tmep","us_tax_treaty","us_tax_treaty_technical_explanation","uscis_policy_manual","whd_foh","whd_opinion_letter"],"examples":["sct"]},"state":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Jurisdiction. A 2-letter code for one of the 52 supported US jurisdictions (50 states + DC + PR), or `federal` for USC / CFR / Constitution / federal rules. Pass a list to search several at once. Case-insensitive. Omit to search every jurisdiction.","enum":["federal","al","ak","az","ar","ca","co","ct","de","dc","fl","ga","hi","id","il","in","ia","ks","ky","la","me","md","ma","mi","mn","ms","mo","mt","ne","nv","nh","nj","nm","ny","nc","nd","oh","ok","or","pa","pr","ri","sc","sd","tn","tx","ut","vt","va","wa","wv","wi","wy"],"examples":["ca"]},"titleNumber":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"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).","examples":[17]},"yearFrom":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or after this year; pair with `yearTo` for a window. Tracks the publisher's own amendment credit, not when we rebuilt the corpus. About a fifth of sections carry no credit and are excluded once either bound is set.","examples":[2020]},"yearTo":{"anyOf":[{"maximum":2100,"minimum":1700,"type":"integer"},{"type":"null"}],"description":"Only sections last amended in or before this year. This filters the LAST amendment, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed in 2024. A currency filter, not point-in-time retrieval.","examples":[2026]}},"required":["query"],"type":"object"}

before
—

after
{"additionalProperties":true,"type":"object"}