> ## Documentation Index > Fetch the complete documentation index at: https://vaquill.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Find the sections that cite this one > The USC and CFR sections whose text cross-references a given section. **Cost**: 2 credits. Not-found, failed lookups, and sections in a corpus with no cross-reference index are not charged. A section lookup already tells you what a section cites. This is the other direction, and it is the one you cannot get by reading the section: which provisions elsewhere in the code depend on this one. That is the question behind "if this section changes, what else is affected". Results are one row per citing section, in statutory order, never one row per matching chunk. **Scope**: USC and CFR. State codes and Federal Register rules carry no section-level cross-reference index, so a section from either returns an empty list with a `note` explaining why, and is refunded. When `note` is null, an empty `citers` is a real answer: plenty of sections are cited by nothing. **Completeness**: this reads references as the publisher wrote them, including the title-relative form a section uses for its own neighbours. A citation that the source never recorded in machine-readable form cannot appear here, so treat a result as evidence of a citation rather than proof there are no others. ## OpenAPI ````yaml https://api.vaquill.ai/external/openapi.json get /api/v1/us/statutes/section/{act_id}/cited-by openapi: 3.1.0 info: title: Vaquill Developer API description: >- Public API for legal statutes and legislation. **Authentication**: Pass your API key via the `Authorization: Bearer vq_key_...` header. **Credits**: Each call costs API credits. See `GET /api/v1/api-credits/pricing` for the full pricing matrix. ## Jurisdictions | Jurisdiction | Coverage | `countryCode` | |---|---|---| | **United States** | USC, CFR, nearly all 50 state statutory codes (plus DC and Puerto Rico), state constitutions, and court rules. | `US` | See the full [Coverage page](https://www.vaquill.ai/docs/coverage) for the jurisdiction-by-jurisdiction breakdown, or call `/us/statutes/coverage` for live counts. ## Endpoints - **US Statutes**: Search and retrieve USC, CFR, state statutes, constitutions, court rules, executive orders, and regulations with full text - **Board Watches**: Subscribe to a corpus source and get a webhook or email when it refreshes with real changes (free, API key required) - **Pricing**: Credit costs per endpoint (no auth required) ## Rate limits Limits are enforced per API key and scale with your plan. A `429` response includes a `Retry-After` header. | Plan | Per minute | Per hour | Per day | |---|---|---|---| | Vaquill API Pro | 30 | 500 | 1,000 | | Vaquill API Business | 150 | 2,500 | 10,000 | For full documentation, visit the [API Reference](https://www.vaquill.ai/docs/api-reference/). version: 1.0.0 contact: name: Vaquill API Support url: https://www.vaquill.ai email: support@vaquill.ai license: name: Proprietary url: https://www.vaquill.ai/terms termsOfService: https://www.vaquill.ai/terms servers: - url: https://api.vaquill.ai description: Production security: - ApiKeyAuth: [] tags: - name: US Statutes description: >- Search and retrieve US statutes. Covers the United States Code (USC), Code of Federal Regulations (CFR), all 50 state statutes, constitutions, court rules, executive orders, Federal Register agency rules, agency guidance, and state regulations. Scope a search with the `corpusType` filter. - **Search**: Search across all USC, CFR, state, and regulatory sections - **Section**: Get metadata, citation, hierarchy, and source links for a specific section - **Body**: Get the full text of a section - name: Board Watches description: >- Law-change alerts. Subscribe to a **board** (a tracked corpus source, identified by `corpusType` plus an optional `state`) and get a webhook or email whenever it refreshes with real changes, naming the exact sections that changed. Fetch old-vs-new text for any amended section via the change diff. Boards refresh on their own existing cadence; watching one does not change how often it refreshes. Every endpoint here is **free**: authenticated by API key and rate-limited, but not credit-metered. See the [Law Change Alerts guide](https://www.vaquill.ai/docs/api-guide/alerts) for the full walkthrough. - name: Pricing description: >- Credit pricing and conversion rates. No authentication required. 1 credit = $0.01 USD. externalDocs: description: Full API Reference url: https://www.vaquill.ai/docs/api-reference/ paths: /api/v1/us/statutes/section/{act_id}/cited-by: get: tags: - US Statutes summary: Find the sections that cite this one description: >- The USC and CFR sections whose text cross-references a given section. **Cost**: 2 credits. Not-found, failed lookups, and sections in a corpus with no cross-reference index are not charged. A section lookup already tells you what a section cites. This is the other direction, and it is the one you cannot get by reading the section: which provisions elsewhere in the code depend on this one. That is the question behind "if this section changes, what else is affected". Results are one row per citing section, in statutory order, never one row per matching chunk. **Scope**: USC and CFR. State codes and Federal Register rules carry no section-level cross-reference index, so a section from either returns an empty list with a `note` explaining why, and is refunded. When `note` is null, an empty `citers` is a real answer: plenty of sections are cited by nothing. **Completeness**: this reads references as the publisher wrote them, including the title-relative form a section uses for its own neighbours. A citation that the source never recorded in machine-readable form cannot appear here, so treat a result as evidence of a citation rather than proof there are no others. operationId: get_section_cited_by_api_v1_us_statutes_section__act_id__cited_by_get parameters: - name: act_id in: path required: true schema: type: string minLength: 3 maxLength: 200 description: >- Section identifier. Encodes the citation's hierarchy: `USC_T42_C21_S1983` is Title 42, Chapter 21, Section 1983, the section a lawyer writes as 42 U.S.C. § 1983. Take it from a `/us/statutes/search` result rather than assembling it: the title and section are derivable from a citation, but the CHAPTER is not, so hand-built ids usually 404. examples: - USC_T42_C21_S1983 title: Act Id description: >- Section identifier. Encodes the citation's hierarchy: `USC_T42_C21_S1983` is Title 42, Chapter 21, Section 1983, the section a lawyer writes as 42 U.S.C. § 1983. Take it from a `/us/statutes/search` result rather than assembling it: the title and section are derivable from a citation, but the CHAPTER is not, so hand-built ids usually 404. - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Maximum citing sections to return. examples: - 25 default: 25 title: Limit description: Maximum citing sections to return. responses: '200': description: The section plus the sections citing it. content: application/json: schema: $ref: '#/components/schemas/StatuteCitedByResponse' '401': description: Invalid or missing API key. content: application/json: schema: $ref: '#/components/schemas/ApiDetailError' '402': description: Insufficient credits. content: application/json: schema: $ref: '#/components/schemas/ApiDetailError' '404': description: Section not found. content: application/json: schema: $ref: '#/components/schemas/ApiDetailError' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/ApiDetailError' components: schemas: StatuteCitedByResponse: properties: section: $ref: '#/components/schemas/StatuteResult' description: The section you asked about. citers: items: $ref: '#/components/schemas/StatuteResult' type: array title: Citers description: >- Sections whose text cross-references this one, in statutory order. Empty is a real answer: plenty of sections are cited by nothing. total: type: integer title: Total description: >- How many citing sections were returned. This is the size of `citers`, not a corpus-wide count: it is capped by `limit`. default: 0 examples: - 17 truncated: type: boolean title: Truncated description: >- True when more citing sections exist than `limit` allowed. Raise `limit` to see the rest. default: false note: anyOf: - type: string - type: 'null' title: Note description: >- Set only when the answer is not a real zero. Reverse citation is built on the cross-reference index, which exists for USC and CFR; for any other corpus this explains that the section is out of scope and the call is refunded. When it is null, an empty `citers` means nothing cites this section. processingTimeMs: type: number title: Processingtimems description: >- Server-side time for this request in milliseconds, excluding network transit. Useful for spotting a slow query; not billed on. default: 0 examples: - 74.2 creditsConsumed: type: number title: Creditsconsumed description: >- Credits actually charged for this call. Read it rather than assuming the list price: failed and refunded work bills 0. default: 0 examples: - 2 type: object required: - section title: StatuteCitedByResponse description: Response for `GET /us/statutes/section/{act_id}/cited-by`. ApiDetailError: properties: detail: type: string title: Detail description: >- Human-readable reason, safe to surface to an end user. Branch on the HTTP status rather than on this string: the wording is not part of the contract and may be reworded, but 401 (bad key), 402 (out of credits), 403 (missing scope), 404 (no such resource) and 429 (rate limited) are stable. examples: - Insufficient API credits. type: object required: - detail title: ApiDetailError description: |- Error envelope the API actually returns. All errors (401/402/403/404/422/429/5xx) come back as a single `detail` string (FastAPI default), e.g. `{"detail": "Insufficient API credits."}`. Documenting the real shape so client code can rely on it. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError StatuteResult: properties: actId: type: string title: Actid description: >- Unique section identifier (e.g., 'USC_T42_C21_S1983', 'CFR_T17_P240_S240_10b5_1'). citation: anyOf: - type: string - type: 'null' title: Citation description: >- Full citation (e.g., '42 U.S.C. § 1983 (2024)', '17 C.F.R. § 240.10b5-1 (2026)'). citationShort: anyOf: - type: string - type: 'null' title: Citationshort description: Short citation (e.g., '42 U.S.C. § 1983', '17 C.F.R. § 240.10b5-1'). title: anyOf: - type: string - type: 'null' title: Title description: Section title. corpusType: anyOf: - type: string - type: 'null' title: Corpustype description: >- One of `USC`, `CFR`, `STATE`, `CONSTITUTION`, `FEDERAL_RULES`, `STATE_CONSTITUTION`, `STATE_RULES`, or `EXECUTIVE_ACTION`. state: anyOf: - type: string - type: 'null' title: State description: >- 2-letter lowercase state code (e.g. `ca`, `tx`) when the row belongs to a state corpus. `federal` for federal rows. source: anyOf: - type: string - type: 'null' title: Source description: >- The named source within `corpusType`, for corpora that fold several independently filterable bodies of law into one token. `FEDERAL_RULES` sources: `frcp` (Federal Rules of Civil Procedure), `frcrp` (Federal Rules of Criminal Procedure), `fre` (Federal Rules of Evidence), `frap` (Federal Rules of Appellate Procedure), `frbp` (Federal Rules of Bankruptcy Procedure), `sct` (Rules of the Supreme Court of the United States). `CFR` sources: `far` (Federal Acquisition Regulation (48 C.F.R. ch. 1)), `dfars` (Defense Federal Acquisition Regulation Supplement (48 C.F.R. ch. 2)) (both are already part of `CFR`; this only splits the existing Title 48 data by chapter, it does not add new sections). `AGENCY_GUIDANCE` sources: `agency_guidance` (General agency guidance), `administrative_guidance` (Synthesized administrative guidance (e.g. SALT cap, CTC, 401(k) limits)), `ssa_ruling` (Social Security Administration Rulings), `irs_rev_proc` (IRS Revenue Procedures), `irs_notice` (IRS Notices), `irs_rev_rul` (IRS Revenue Rulings), `irs_announcement` (IRS Announcements), `merger_guidelines` (DOJ & FTC Merger Guidelines (2023)), `doj_leniency` (DOJ Antitrust Division Leniency Policy), `copyright_circular` (US Copyright Office Circulars), `doj_justice_manual` (DOJ Justice Manual), `uscis_policy_manual` (USCIS Policy Manual), `mpep` (USPTO Manual of Patent Examining Procedure (MPEP)), `tmep` (USPTO Trademark Manual of Examining Procedure (TMEP)), `cftc_staff_letter` (CFTC Staff Letters (no-action, exemptive, interpretative; 2008-present)), `fincen_ruling` (FinCEN Administrative Rulings), `fincen_guidance` (FinCEN Guidance (alerts, advisories, notices, bulletins, fact sheets)), `frb_sr_letter` (Federal Reserve Supervision and Regulation (SR) / Consumer Affairs (CA) Letters), `occ_bulletin` (OCC Bulletins), `occ_interpretive_letter` (OCC Interpretive Letters), `fdic_fil` (FDIC Financial Institution Letters (FILs)), `dfars_pgi` (DFARS PGI (Procedures, Guidance, and Information)), `nlrb_gc_memo` (NLRB General Counsel Memoranda), `nlrb_advice_memo` (NLRB Division of Advice Memoranda (rolling 10-year window, not the full archive)), `cpsc_advisory_opinion` (CPSC Office of General Counsel Advisory Opinions (historical, 1970s-2012)), `cpsc_secg` (CPSC Small Entity Compliance Guides), `bis_advisory_opinion` (BIS (Bureau of Industry and Security) Advisory Opinions), `ddtc_commodity_jurisdiction` (DDTC (Directorate of Defense Trade Controls) Commodity Jurisdiction Determinations), `ddtc_guidance` (DDTC (Directorate of Defense Trade Controls) Policy Guidance Documents), `hhs_ocr_hipaa_faq` (HHS Office for Civil Rights HIPAA FAQs), `hhs_ocr_hipaa_guidance` (HHS Office for Civil Rights HIPAA Guidance Materials), `hhs_ocr_resolution_agreement` (HHS Office for Civil Rights HIPAA Resolution Agreements and Civil Money Penalties), `fcc_declaratory_ruling` (FCC (Federal Communications Commission) Declaratory Rulings), `ferc_policy_statement` (FERC (Federal Energy Regulatory Commission) Policy Statements), `doe_appliance_guidance` (DOE Appliance Standards Guidance and FAQs). Pass it back as the `source` search filter to scope to just this one source. Null for corpora with only one source. examples: - sct year: anyOf: - type: integer - type: 'null' title: Year description: Year of the statute version. relevanceScore: type: number title: Relevancescore description: >- Relevance score, normalized to roughly 0-1. Higher means a better match for ranking within one response. It is a relative ranking signal, not a calibrated confidence or probability, so do not compare scores across different queries or treat a fixed value as a quality threshold. Exception: a query that resolves to an exact citation (e.g. '42 U.S.C. § 1983', 'Cal. Civ. Code § 1950.5', 'Fed. R. Civ. P. 12') always scores that section 1.0, since it is a certain match rather than a ranked one -- a natural-language or keyword query never returns 1.0 by comparison. default: 0 excerpt: type: string title: Excerpt description: Text excerpt (up to 500 characters). default: '' titleNumber: anyOf: - type: string - type: 'null' title: Titlenumber description: USC/CFR/state title number (e.g. '26', '13A'). titleName: anyOf: - type: string - type: 'null' title: Titlename description: Title name (e.g., 'The Public Health and Welfare'). chapter: anyOf: - type: string - type: 'null' title: Chapter description: Chapter number or identifier. chapterName: anyOf: - type: string - type: 'null' title: Chaptername description: Chapter name. sectionNumber: anyOf: - type: string - type: 'null' title: Sectionnumber description: Section number (e.g., '1983', '240.10b5-1'). sectionTitle: anyOf: - type: string - type: 'null' title: Sectiontitle description: >- The section's own heading (e.g., 'Rule G. Forfeiture Actions In Rem'). Distinct from `title`, which is the hierarchical display path. displayPath: anyOf: - type: string - type: 'null' title: Displaypath description: Full hierarchical path (Title > Chapter > Section). breadcrumb: anyOf: - items: additionalProperties: type: string type: object type: array - type: 'null' title: Breadcrumb description: Structured breadcrumb trail for navigation. parent: anyOf: - additionalProperties: true type: object - type: 'null' title: Parent description: >- Query for `GET /us/statutes/divisions` that lists this section's siblings (its containing chapter, part, or code). Pass it straight back to walk up the hierarchy. Null when the container cannot be determined. subchapter: anyOf: - type: string - type: 'null' title: Subchapter description: Subchapter number or identifier. subchapterName: anyOf: - type: string - type: 'null' title: Subchaptername description: Subchapter name. part: anyOf: - type: string - type: 'null' title: Part description: Part number or identifier (CFR/state). partName: anyOf: - type: string - type: 'null' title: Partname description: Part name. subpart: anyOf: - type: string - type: 'null' title: Subpart description: Subpart number or identifier (CFR). subpartName: anyOf: - type: string - type: 'null' title: Subpartname description: Subpart name. popularName: anyOf: - type: string - type: 'null' title: Popularname description: >- Popular/common name of the act (e.g. 'Truth in Lending Act'), when known. actStatus: anyOf: - type: string - type: 'null' title: Actstatus description: >- Raw section status: `in_force`, `repealed`, `renumbered`, `transferred`, `omitted`, `reserved`, `vacant`, or `unconstitutional`. goodLawStatus: anyOf: - type: string - type: 'null' title: Goodlawstatus description: >- Derived currency verdict: `good_law`, `not_good_law`, `not_operative`, or `unknown`. Conservative: states without a reliable repeal signal report `unknown` rather than over-claiming. `null` when currency checking is disabled. currencyNote: anyOf: - type: string - type: 'null' title: Currencynote description: Source's 'current through ...' note, when published. renumberedTo: anyOf: - type: string - type: 'null' title: Renumberedto description: Pointer to the new location when `actStatus` is `renumbered`. transferredTo: anyOf: - type: string - type: 'null' title: Transferredto description: Pointer to the new location when `actStatus` is `transferred`. issueDate: anyOf: - type: string - type: 'null' title: Issuedate description: Issue/publication date of this version (ISO 8601), when known. crossReferencesCfr: anyOf: - items: type: string type: array - type: 'null' title: Crossreferencescfr description: CFR cross-references parsed from the text, e.g. `['1.6011-4']`. crossReferencesUsc: anyOf: - items: type: string type: array - type: 'null' title: Crossreferencesusc description: >- USC cross-references parsed from the text, e.g. `['42:1983']`. `'self:
'` denotes a reference to another section of the same title. statutoryAuthority: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Statutoryauthority description: >- For a CFR/eCFR section: the USC (or other) citations in its 'Authority' note that authorize the rule, e.g. `[{'type': 'usc', 'title': 15, 'section': '78o', 'display': '15 U.S.C. 78o'}]`. Null for non-regulation corpora. implementingRegulations: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Implementingregulations description: >- For a USC section: the CFR parts that implement it, derived from the reverse of every CFR section's own `statutoryAuthority`, e.g. `[{'cfr_title': 17, 'part': '240', 'part_name': '...', 'display': '17 CFR Part 240'}]`. Null for non-USC corpora. frRegulationIdNumbers: anyOf: - items: type: string type: array - type: 'null' title: Frregulationidnumbers description: Regulation Identifier Number(s) (RIN) assigned to this rule. frDocketIds: anyOf: - items: type: string type: array - type: 'null' title: Frdocketids description: Rulemaking docket ID(s) this document was filed under. frEffectiveOn: anyOf: - type: string - type: 'null' title: Freffectiveon description: The rule's effective date (ISO 8601 date), when set. frCommentsCloseOn: anyOf: - type: string - type: 'null' title: Frcommentscloseon description: Public-comment deadline (ISO 8601 date). Proposed rules only. frSignificant: anyOf: - type: boolean - type: 'null' title: Frsignificant description: >- Whether the Federal Register marked this rule 'economically significant' (EO 12866). frCorrectionOf: anyOf: - type: string - type: 'null' title: Frcorrectionof description: >- Federal Register document number this document corrects, when this is a correction. frCorrections: anyOf: - items: type: string type: array - type: 'null' title: Frcorrections description: >- Federal Register document number(s) that later corrected this document. frRegulationsDotGovUrl: anyOf: - type: string - type: 'null' title: Frregulationsdotgovurl description: Link to this document's public comment docket on regulations.gov. frRelatedDocuments: anyOf: - items: $ref: '#/components/schemas/FrRelatedDocument' type: array - type: 'null' title: Frrelateddocuments description: >- Other Federal Register documents sharing this document's RIN(s) (its proposed rule, its final rule, and any corrections), most recent first. Only populated on `GET /us/statutes/section/{actId}` for a row that carries `frRegulationIdNumbers`; always null on `/us/statutes/search` results, since computing it needs a follow-up lookup that is too expensive to run per search result. subject: anyOf: - type: string - type: 'null' title: Subject description: >- The publisher's own subject or document-type label, where it prints one (for example a state insurance bulletin's `RE:` line, or its listing category such as `Rescission`). rescindedOn: anyOf: - type: string - type: 'null' title: Rescindedon description: >- ISO date the document was rescinded or withdrawn, when the source states one. sourceCredit: anyOf: - type: string - type: 'null' title: Sourcecredit description: >- The Office of the Law Revision Counsel's credit line for a **USC** section: the acts that enacted and amended it, in order, e.g. `June 25, 1948, ch. 646, 62 Stat. 869; Pub. L. 85-508, Sec. 12, July 7, 1958, 72 Stat. 348`. Parentheses stripped, whitespace normalized. USC only, and null on a USC section that prints no credit (a transferred, repealed or reclassified stub). CFR sections carry the same fact as a list in `federalRegisterCitations` instead, which is why the shape differs; no other corpus publishes one. amendmentYears: anyOf: - items: type: integer type: array - type: 'null' title: Amendmentyears description: Years the section was amended, parsed from the text. lastAmendedYear: anyOf: - type: integer - type: 'null' title: Lastamendedyear description: Most recent amendment year, when known. amendmentsCount: anyOf: - type: integer - type: 'null' title: Amendmentscount description: Number of amendments detected for the section. currentThrough: anyOf: - type: string - type: 'null' title: Currentthrough description: >- The date the publisher states this text is current through, e.g. `2025-01-06`. Set on every USC section. `currencyNote` carries the same fact as prose where a publisher writes it that way. amendmentHistory: anyOf: - items: type: string type: array - type: 'null' title: Amendmenthistory description: >- Structured amendment entries where the publisher records them separately from the credit line in `history`. sourceNote: anyOf: - type: string - type: 'null' title: Sourcenote description: The publisher's source note for the section, verbatim. effectiveDate: anyOf: - type: string - type: 'null' title: Effectivedate description: >- When THIS version took effect, as the publisher prints it. On a section with `actStatus=superseded` this is the start of that version's window. priorEffectiveDates: anyOf: - items: type: string type: array - type: 'null' title: Prioreffectivedates description: Earlier effective dates recorded for the section. history: anyOf: - type: string - type: 'null' title: History description: >- The publisher's own amendment/history credit line, verbatim, e.g. `Effective 5/4/2005; Superseded 8/1/2016`. `amendmentYears` is parsed from this; keep both when you need the exact wording. supersededBy: anyOf: - type: string - type: 'null' title: Supersededby description: >- `actId` of the section that replaced this one. Present on a superseded version so you can fetch the current text in one hop via `GET /statutes/section/{actId}`. supersedes: anyOf: - type: string - type: 'null' title: Supersedes description: '`actId` of the earlier version this section replaced, when known.' ruleSet: anyOf: - type: string - type: 'null' title: Ruleset description: >- For court rules, the rule family this belongs to, e.g. `North Dakota Rules of Civil Procedure`. Rule numbers repeat across families (a Civil Rule 12 and a Criminal Rule 12 both exist), so this is what disambiguates them. publicLaws: anyOf: - items: type: string type: array - type: 'null' title: Publiclaws description: Public Laws referenced by the section, e.g. `['Pub. L. 96-170']`. federalRegisterCitations: anyOf: - items: type: string type: array - type: 'null' title: Federalregistercitations description: >- Federal Register citations associated with the section, e.g. `['48 FR 3956', '49 FR 15073']`. This is the CFR's form of the credit line `sourceCredit` carries for the USC: the rulemakings that established and amended the section. Populated on 37.4% of CFR sections, empty where eCFR prints no source note. granuleId: anyOf: - type: string - type: 'null' title: Granuleid description: govinfo granule identifier (USC/CFR provenance). packageId: anyOf: - type: string - type: 'null' title: Packageid description: govinfo package identifier (USC/CFR provenance). htmlUrl: anyOf: - type: string - type: 'null' title: Htmlurl description: HTML version of the statute section. pdfUrl: anyOf: - type: string - type: 'null' title: Pdfurl description: PDF version of the statute section. xmlUrl: anyOf: - type: string - type: 'null' title: Xmlurl description: XML version of the statute section. textUrl: anyOf: - type: string - type: 'null' title: Texturl description: >- Plain-text version. Populated for state corpora (MS, NJ, NY, NV, etc.). docxUrl: anyOf: - type: string - type: 'null' title: Docxurl description: Microsoft Word (DOCX) version, when available. stateHtmlUrl: anyOf: - type: string - type: 'null' title: Statehtmlurl description: >- Official HTML hosted by the state legislature (publisher's URL). Populated for state corpora only. govInfoHtmlUrl: anyOf: - type: string - type: 'null' title: Govinfohtmlurl description: Official govinfo.gov HTML version. govInfoPdfUrl: anyOf: - type: string - type: 'null' title: Govinfopdfurl description: Official govinfo.gov PDF version. abstract: anyOf: - type: string - type: 'null' title: Abstract description: >- The issuing agency's own summary of the document, as published in the Federal Register. Populated on 99.9% of rules and proposed rules, which makes 5.49M documents triageable without fetching the full text. examples: - This regulation extends time-limited tolerances for pesticides. agencies: anyOf: - items: type: string type: array - type: 'null' title: Agencies description: >- Issuing agencies, by name. Populated on 99.9% of Federal Register documents. Pair with `agencySlugs` when you need the token the `agency` search filter takes. examples: - - Environmental Protection Agency agencySlugs: anyOf: - items: type: string type: array - type: 'null' title: Agencyslugs description: >- The issuing agencies as slugs. These are exactly the values the `agency` filter on `/us/statutes/search` accepts, so an agency facet can be round-tripped straight back into a query. examples: - - environmental-protection-agency topics: anyOf: - items: type: string type: array - type: 'null' title: Topics description: >- The Federal Register's own CFR-index subject terms. Populated on ~71% of rules and ~68% of proposed rules, with one hard boundary: documents published before 2000 carry none, because the Federal Register did not index them this way. examples: - - Environmental protection - Pesticides and pests documentTypeLabel: anyOf: - type: string - type: 'null' title: Documenttypelabel description: >- The instrument type as the publisher names it: `Rule`, `Proposed Rule`, `Presidential Document`, `Declaratory Ruling`, `Resolution Agreement`. Deliberately NOT `corpusType`, which says which body of law a document belongs to: two documents in one corpus can be very different instruments. examples: - Rule documentSubtype: anyOf: - type: string - type: 'null' title: Documentsubtype description: >- Finer instrument class where the publisher gives one. On presidential documents this separates an executive order from a proclamation, a memorandum or a notice (~90% populated there). examples: - Proclamation action: anyOf: - type: string - type: 'null' title: Action description: >- The Federal Register's own ACTION line, ~100% populated. Carries distinctions no other field makes: interim final rule, direct final rule, withdrawal, reopening of the comment period. examples: - Final rule. president: anyOf: - type: string - type: 'null' title: President description: >- The president in office for this document, on Federal Register and presidential-document corpora spanning 1994 to present. examples: - George W. Bush signingDate: anyOf: - type: string - type: 'null' title: Signingdate description: >- When a presidential document was signed, which is routinely earlier than `publicationDate` and is the legally operative date. examples: - '2026-04-02' datesText: anyOf: - type: string - type: 'null' title: Datestext description: >- The verbatim DATES block from the Federal Register, ~98% populated. Worth reading alongside `frEffectiveOn`: a rule with staged or conditional effective dates has them here, and the single date flattens that away. examples: - This regulation is effective December 14, 2001. frVolume: anyOf: - type: integer - type: 'null' title: Frvolume description: Federal Register volume, the `66` in `66 FR 64768`. examples: - 66 frStartPage: anyOf: - type: integer - type: 'null' title: Frstartpage description: First Federal Register page, the `64768` in `66 FR 64768`. examples: - 64768 frEndPage: anyOf: - type: integer - type: 'null' title: Frendpage description: >- Last Federal Register page. With `frStartPage` this gives the page RANGE, which `citation` cannot express because it carries only the first page. examples: - 64775 wordCount: anyOf: - type: integer - type: 'null' title: Wordcount description: >- Words in the full document, so a caller can size a fetch before paying for the body. examples: - 6271 issuingAgency: anyOf: - type: string - type: 'null' title: Issuingagency description: >- The body that promulgated or issued this document: the state agency behind a regulation, the division behind an agency letter. Populated at 83.6-100% across the state-regulation corpora that carry it, and previously unreachable under any name, so 'which agency made this rule' had no answer. examples: - Pollution Control Board adoptingCitations: anyOf: - items: type: string type: array - type: 'null' title: Adoptingcitations description: >- Citations to the instrument that ADOPTED this rule: the state register notice, the Washington filing number, the adopting order. The rulemaking audit trail. Unified across four different payload spellings, so this is comparable across states in a way the underlying data is not. examples: - - 37 Ill. Reg. 16539 lawImplemented: anyOf: - type: string - type: 'null' title: Lawimplemented description: >- The statute this rule IMPLEMENTS, as distinct from `statutoryAuthority`, which is the statute granting the rulemaking power. Florida populates both and they differ. examples: - Section 4656.1, Public Resources Code lastAmendedDate: anyOf: - type: string - type: 'null' title: Lastamendeddate description: >- Full date of the most recent amendment, where the publisher gives one. Illinois and Colorado regulations carry their amendment provenance only here and in `amendmentNote`: neither state has a `history`, and Colorado has no `effectiveDate` either, so for Colorado this is the only date that exists. examples: - October 4, 2013 amendmentNote: anyOf: - type: string - type: 'null' title: Amendmentnote description: >- The publisher's amendment credit line where it is stored separately from `history`. Illinois and Colorado regulations, ~72% populated. examples: - Amended at 37 Ill. Reg. 16539, effective October 4, 2013 currencyYear: anyOf: - type: integer - type: 'null' title: Currencyyear description: >- Machine-readable counterpart to `currencyNote`, which is prose. 100% populated on the nine state-regulation corpora that carry a currency statement. examples: - 2025 reviewDate: anyOf: - type: string - type: 'null' title: Reviewdate description: >- The date a rule must be re-adopted or it expires, where the state runs a sunset review. Ohio regulations, ~80% populated. Not an amendment date: it is in the future. examples: - 11/1/2028 originalEnactmentDate: anyOf: - type: string - type: 'null' title: Originalenactmentdate description: >- When the section was FIRST enacted, ~72% populated on the US Code. Deliberately separate from `effectiveDate`: merging them would report an amended section as effective from its original year. On 35.7% of US Code points this is the only enactment date we hold. examples: - June 27, 1934 releaseDate: anyOf: - type: string - type: 'null' title: Releasedate description: >- When the document was released publicly, where that differs from when it was issued. NLRB advice memoranda are written years before release; measured, the two dates are never equal. examples: - '2018-06-14' documentNumber: anyOf: - type: string - type: 'null' title: Documentnumber description: >- The issuer's own document or case number, for exact lookup: an FCC DA number, an NLRB case-handling docket, a ruling number. On NLRB advice memoranda and FCC/HHS OCR documents this is NOT recoverable from `sectionNumber`. examples: - 21-CA-211066 caseName: anyOf: - type: string - type: 'null' title: Casename description: >- The charged party or covered entity a document concerns. Only 27% equal to `sectionTitle` on HHS OCR, so it is not recoverable from the served text. examples: - Dunn-Edwards Corp. settlementAmount: anyOf: - type: string - type: 'null' title: Settlementamount description: >- The monetary penalty or settlement, as the agency prints it. 95.2% populated on HHS OCR resolution agreements, where it is the single most-asked fact of the corpus. examples: - $16,500 requesters: anyOf: - items: type: string type: array - type: 'null' title: Requesters description: >- Who asked for the determination or relief. On export-control commodity-jurisdiction determinations this is the applicant (100% populated); on no-action letters it determines who may rely on the relief. examples: - - Preece, Inc. program: anyOf: - type: string - type: 'null' title: Program description: >- The benefit or regulatory program a document governs, e.g. Old-Age and Survivors Insurance. 100% populated on Social Security rulings, where it is the primary axis a practitioner filters on. examples: - Old-Age and Survivors Insurance languageCode: anyOf: - type: string - type: 'null' title: Languagecode description: >- ISO code of the language the document is written in, present where a corpus is not wholly English. 86% of Puerto Rico insurance bulletins are Spanish (`es`) and nothing previously said so. examples: - es volume: anyOf: - type: integer - type: 'null' title: Volume description: >- Volume number for corpora organised in volumes, e.g. the USCIS Policy Manual, whose Volume is the top hierarchy level and had no served representation at all. examples: - 1 articleNumber: anyOf: - type: string - type: 'null' title: Articlenumber description: >- Article number. Article is the PRIMARY hierarchy level in state constitutions, where `chapter` and `part` are 0-6% populated, so without this those corpora served almost no structure. examples: - '1' articleName: anyOf: - type: string - type: 'null' title: Articlename description: Article title, the companion to `articleNumber`. examples: - Declaration of Rights ruleSetCode: anyOf: - type: string - type: 'null' title: Rulesetcode description: >- Stable machine key for the rule family, where `ruleSet` gives only the prose name. 100% populated on the court-rules states that have a rule set. examples: - NDSUPCTADMINR edition: anyOf: - type: string - type: 'null' title: Edition description: The publisher's edition or year for this text. examples: - '2025' relatedCitations: anyOf: - items: type: string type: array - type: 'null' title: Relatedcitations description: >- Citations OUT of this document that are neither USC nor CFR: the state statutes a regulation implements, the Internal Revenue Code sections a ruling construes, other guidance it points at. `crossReferencesUsc` and `crossReferencesCfr` are 0% on several of these corpora, so this is the only outbound citation set they have. examples: - - RCW 28A.150.290 supersessionActions: anyOf: - additionalProperties: true type: object - type: 'null' title: Supersessionactions description: >- What this document does to EARLIER documents, keyed by the issuer's own verb: `modifies`, `obsoletes`, `amplifies`, `clarifies`, `rescinds`, each mapping to the documents affected. `supersedes` and `supersededBy` cover only the strongest verb. Without these a caller cannot tell a modified revenue procedure from an untouched one, nor see which memorandum rescinded which. examples: - modifies: - Rev. Proc. 2011-47 licenseNote: anyOf: - type: string - type: 'null' title: Licensenote description: >- Licence and upstream dataset for text derived from a third-party snapshot rather than fetched from the publisher. Present on the state-regulation corpora built from an external dataset; absent means we hold the text under no third-party licence. examples: - MIT (reglab/statecodes) subtitle: anyOf: - type: string - type: 'null' title: Subtitle description: >- Subtitle, where a jurisdiction puts a level between title and chapter. Maryland's regulations are organised Title > Subtitle > Chapter and are 100% populated; no other served field expressed that level. Deliberately NOT the same as `subchapter`, which sits BELOW chapter. examples: - '11' subtitleName: anyOf: - type: string - type: 'null' title: Subtitlename description: Subtitle title, the companion to `subtitle`. examples: - AIR QUALITY publisherKey: anyOf: - type: string - type: 'null' title: Publisherkey description: >- The publisher's own stable identifier for this document, where it issues one. On the US Code this is the OLRC's `usckey` (100% populated), which joins directly to the uscode.house.gov bulk XML; on Colorado regulations it is the state's rule id. Use it to reconcile our records against the publisher's without matching on citation strings. examples: - '430000000310400000000000000000000' versionId: anyOf: - type: string - type: 'null' title: Versionid description: >- The publisher's identifier for THIS VERSION of the document, where it versions them separately from the document itself. 100% populated on Colorado regulations, where it is the only version pointer that exists. examples: - '11948' referencedShortTitles: anyOf: - items: type: string type: array - type: 'null' title: Referencedshorttitles description: >- Popular names of acts this section REFERENCES, ~10% of the US Code. Distinct from `popularName`, which is the section's own. examples: - - Driftnet Modernization and Bycatch Reduction Act subjectNumber: anyOf: - type: string - type: 'null' title: Subjectnumber description: >- The publisher's numbered subject index entry, the companion to the term in `topics`. 100% populated on Social Security rulings. examples: - '47' audience: anyOf: - type: string - type: 'null' title: Audience description: >- Who the document is addressed to or binds, where the issuer states it. 100% populated on the Montana insurance bulletins. examples: - All Persons Engaged in Marketing sourceCharStart: anyOf: - type: integer - type: 'null' title: Sourcecharstart description: >- Character offset where this text begins in the source document, for callers reconciling our extraction against the original PDF. Pairs with `sourcePageStart`. examples: - 263194 sourceCharEnd: anyOf: - type: integer - type: 'null' title: Sourcecharend description: Character offset where this text ends in the source document. examples: - 264198 alternateCitations: anyOf: - items: type: string type: array - type: 'null' title: Alternatecitations description: >- Other official citation forms for THIS document, where a publisher prints more than one. Puerto Rico gives an L.P.R.A. cite, Arizona a long form, the IRS an Internal Revenue Bulletin cite, the Federal Reserve a paired Consumer Affairs number. Distinct from `relatedCitations`, which is what this document points AT. Use these when you need to match a citation a user typed in the form their jurisdiction actually publishes. examples: - - 4 L.P.R.A. § 2077 expirationDate: anyOf: - type: string - type: 'null' title: Expirationdate description: >- When this rule lapses unless re-adopted. Distinct from `reviewDate` (the review deadline) and from any amendment date: it is in the future and it ENDS the rule. examples: - 03-01-2029 committeeNote: anyOf: - type: string - type: 'null' title: Committeenote description: >- Advisory-committee note on a procedural rule: the standard interpretive gloss courts read alongside the rule text. Deliberately separate from `amendmentNote`, which records when the rule changed rather than what it means. sourcePageStart: anyOf: - type: integer - type: 'null' title: Sourcepagestart description: >- First page in the official PDF this text was extracted from, for a pinpoint print citation. 100% populated on the Federal Rules. examples: - 114 sourcePageEnd: anyOf: - type: integer - type: 'null' title: Sourcepageend description: Last page in the official PDF; companion to `sourcePageStart`. examples: - 114 displayLabel: anyOf: - type: string - type: 'null' title: Displaylabel description: >- The publisher's own short label for this section, e.g. `Cal. BPC § 655.2` or `MPEP § 2165.03`. Populated on essentially every document we hold. Usually equal to `citationShort`, but NOT always: on the Federal Communications Commission, NLRB, HHS OCR and BIS corpora the two differ on every document, and there `displayLabel` is the form the publisher itself prints. examples: - MPEP § 2165.03 publicationDate: anyOf: - type: string - type: 'null' title: Publicationdate description: >- The date this document was published by its source. For Federal Register documents this is the FR publication date, the primary citation and sort key, populated on 100% of the 5.49M rules and proposed rules. Distinct from `effectiveDate` (when it takes legal effect) and from `issueDate` (when the issuing body dated it). A rule is routinely published before it is effective. examples: - '2001-12-14' publicLawCites: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Publiclawcites description: >- Structured Statutes at Large citations parsed out of the source credit, populated on ~72% of the US Code. Each entry carries `statVolume`, `statPage`, `type` and a `display` string. `publicLaws` gives the bare `Pub. L.` list and `sourceCredit` the raw prose; this is the same information already parsed, so a caller can link to the Statutes at Large without re-parsing the credit line. topLevelTitle: anyOf: - type: string - type: 'null' title: Topleveltitle description: >- The outermost division this document sits under, where the corpus has one that `titleNumber`/`chapter`/`part` do not already express. Examples: `Title 9: Criminal` for the DOJ Justice Manual, `Volume 1 - General Policies and Procedures` for the USCIS Policy Manual. Null for flat corpora, where one document is the whole unit. examples: - 'Title 9: Criminal' externalUrl: anyOf: - type: string - type: 'null' title: Externalurl description: URL on the official source website (eCFR or uscode.house.gov). type: object required: - actId title: StatuteResult description: A single statute section from search results. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError FrRelatedDocument: properties: actId: type: string title: Actid citation: anyOf: - type: string - type: 'null' title: Citation title: anyOf: - type: string - type: 'null' title: Title description: The related document's own title/heading, when known. documentType: anyOf: - type: string - type: 'null' title: Documenttype description: >- `proposed_rule`, `final_rule`, or the raw Federal Register category otherwise. publicationDate: anyOf: - type: string - type: 'null' title: Publicationdate description: Federal Register publication date (ISO 8601 date), when known. type: object required: - actId title: FrRelatedDocument description: >- One other Federal Register document sharing a RIN with this one. A Regulation Identifier Number (RIN) tracks one regulatory action through its lifecycle -- a proposed rule, its final rule, and any later corrections all carry the same RIN. This is what answers "what happened to this proposed rule": look up its RIN's other documents. securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: vq_key_* description: >- API key issued from the developer dashboard. Pass as `Authorization: Bearer vq_key_...` ````