> ## 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.

# Get metadata for many statute sections

> Metadata for up to 50 sections in one call.

**Cost**: 2 credits **per section returned**. Identifiers with no match
are refunded, so a batch of 50 ids that resolves 47 costs 94 credits, not 100.
Batching is a round-trip and latency win, not a discount.

Exists because enriching a search page previously meant one HTTP call per
result: a 50-result page was 50 round trips. The response preserves the order of
`actIds` and reports misses separately in `notFound`, so results can be zipped
back onto the ids that produced them.

Use `/statutes/section/{actId}/body` for full text; this endpoint returns
metadata and source links only.



## OpenAPI

````yaml https://api.vaquill.ai/external/openapi.json post /api/v1/statutes/sections
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 `/statutes/states` for live
    counts.


    ## Endpoints


    - **US Statutes**: Search and retrieve USC, CFR, state statutes,
    constitutions, court rules, executive orders, and regulations with full text

    - **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 |

    |---|---|---|---|

    | API (1x) | 30 | 500 | 2,000 |

    | API Business (5x) | 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: Ask
    description: >-
      AI-powered US legal Q&A. Ask a question in plain language and get an
      answer grounded in 8M+ federal and state court opinions plus the US Code,
      the CFR, and all 50 state statute codes, returned with verified citations.
      Optionally scope to a single state with `usState`, filter sources with
      `sourcesFilter`, and pass `chatHistory` for multi-turn follow-ups.
  - 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/statutes/sections:
    post:
      tags:
        - US Statutes
      summary: Get metadata for many statute sections
      description: >-
        Metadata for up to 50 sections in one call.


        **Cost**: 2 credits **per section returned**. Identifiers with no match

        are refunded, so a batch of 50 ids that resolves 47 costs 94 credits,
        not 100.

        Batching is a round-trip and latency win, not a discount.


        Exists because enriching a search page previously meant one HTTP call
        per

        result: a 50-result page was 50 round trips. The response preserves the
        order of

        `actIds` and reports misses separately in `notFound`, so results can be
        zipped

        back onto the ids that produced them.


        Use `/statutes/section/{actId}/body` for full text; this endpoint
        returns

        metadata and source links only.
      operationId: get_sections_batch_api_v1_statutes_sections_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatuteSectionsRequest'
        required: true
      responses:
        '200':
          description: Sections found, plus any ids that did not resolve.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatuteSectionsResponse'
              example:
                sections:
                  - actId: USC_T42_C21_S1983
                    citation: 42 U.S.C. § 1983 (2024)
                    citationShort: 42 U.S.C. § 1983
                    title: Civil action for deprivation of rights
                    corpusType: USC
                    state: federal
                    year: 2024
                    relevanceScore: 0
                    excerpt: >-
                      officer's judicial capacity, injunctive relief shall not
                      be granted unless a declaratory decree was violated or
                      declaratory relief was unavailable".


                      1979—Pub. L. 96–170 inserted "or the District of Columbia"
                      after "Territory", and provisions relating to Acts of
                      Congress applicable solely to the District of Columbia.


                      Statutory Notes and Related Subsidiaries


                      Effective Date of 1979 Amendment


                      Amendment by Pub. L. 96–170 applicable with respect to any
                      deprivation of rights, privileges, or...
                    titleNumber: '42'
                    titleName: THE PUBLIC HEALTH AND WELFARE
                    chapter: '21'
                    chapterName: CIVIL RIGHTS
                    sectionNumber: '1983'
                    sectionTitle: Civil action for deprivation of rights
                    displayPath: >-
                      Title 42: THE PUBLIC HEALTH AND WELFARE / Chapter 21:
                      CIVIL RIGHTS / Subchapter I: GENERALLY / Section 1983:
                      Civil action for deprivation of rights
                    breadcrumb:
                      - type: title
                        num: '42'
                        label: Title 42
                        name: THE PUBLIC HEALTH AND WELFARE
                      - type: chapter
                        num: '21'
                        label: Chapter 21
                        name: CIVIL RIGHTS
                      - type: subchapter
                        num: I
                        label: Subchapter I
                        name: GENERALLY
                      - type: section
                        num: '1983'
                        label: Section 1983
                        name: Civil action for deprivation of rights
                    parent:
                      corpusType: USC
                      titleNumber: 42
                      chapter: '21'
                    subchapter: I
                    subchapterName: GENERALLY
                    popularName: Public Health and Welfare
                    actStatus: in_force
                    goodLawStatus: good_law
                    renumberedTo: ''
                    transferredTo: ''
                    sourceCredit: >-
                      R.S. §1979; Pub. L. 96–170, §1, Dec. 29, 1979, 93 Stat.
                      1284; Pub. L. 104–317, title III, §309(c), Oct. 19, 1996,
                      110 Stat. 3853.
                    amendmentYears:
                      - 1996
                      - 1979
                    lastAmendedYear: 1996
                    amendmentsCount: 2
                    publicLaws:
                      - Pub. L. 104-317
                      - Pub. L. 96-170
                    granuleId: USCODE-2024-title42-chap21-subchapI-sec1983
                    packageId: USCODE-2024-title42
                    htmlUrl: >-
                      https://statutes-us.vaquill.ai/usc/html/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1983.htm
                    pdfUrl: >-
                      https://statutes-us.vaquill.ai/usc/pdf/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1983.pdf
                    govInfoHtmlUrl: >-
                      https://www.govinfo.gov/content/pkg/USCODE-2024-title42/html/USCODE-2024-title42-chap21-subchapI-sec1983.htm
                    govInfoPdfUrl: >-
                      https://www.govinfo.gov/content/pkg/USCODE-2024-title42/pdf/USCODE-2024-title42-chap21-subchapI-sec1983.pdf
                    externalUrl: >-
                      https://www.govinfo.gov/app/details/USCODE-2024-title42/USCODE-2024-title42-chap21-subchapI-sec1983
                  - actId: USC_T42_C21_S1981a
                    citation: 42 U.S.C. § 1981a (2024)
                    citationShort: 42 U.S.C. § 1981a
                    title: >-
                      Damages in cases of intentional discrimination in
                      employment
                    corpusType: USC
                    state: federal
                    year: 2024
                    relevanceScore: 0
                    excerpt: >-
                      practice or discriminatory practices with malice or with
                      reckless indifference to the federally protected rights of
                      an aggrieved individual.


                      (2) Exclusions from compensatory damages


                      Compensatory damages awarded under this section shall not
                      include backpay, interest on backpay, or any other type of
                      relief authorized under section 706(g) of the Civil Rights
                      Act of 1964 [42 U.S.C. 2000e–5(g)].


                      (3) Limitations


                      The sum of the amount of compensatory damages awarded
                      under this section for future...
                    titleNumber: '42'
                    titleName: THE PUBLIC HEALTH AND WELFARE
                    chapter: '21'
                    chapterName: CIVIL RIGHTS
                    sectionNumber: 1981a
                    sectionTitle: >-
                      Damages in cases of intentional discrimination in
                      employment
                    displayPath: >-
                      Title 42: THE PUBLIC HEALTH AND WELFARE / Chapter 21:
                      CIVIL RIGHTS / Subchapter I: GENERALLY / Section 1981a:
                      Damages in cases of intentional discrimination in
                      employment
                    breadcrumb:
                      - type: title
                        num: '42'
                        label: Title 42
                        name: THE PUBLIC HEALTH AND WELFARE
                      - type: chapter
                        num: '21'
                        label: Chapter 21
                        name: CIVIL RIGHTS
                      - type: subchapter
                        num: I
                        label: Subchapter I
                        name: GENERALLY
                      - type: section
                        num: 1981a
                        label: Section 1981a
                        name: >-
                          Damages in cases of intentional discrimination in
                          employment
                    parent:
                      corpusType: USC
                      titleNumber: 42
                      chapter: '21'
                    subchapter: I
                    subchapterName: GENERALLY
                    popularName: Public Health and Welfare
                    actStatus: in_force
                    goodLawStatus: good_law
                    renumberedTo: ''
                    transferredTo: ''
                    sourceCredit: >-
                      R.S. §1977A, as added Pub. L. 102–166, title I, §102, Nov.
                      21, 1991, 105 Stat. 1072.
                    amendmentsCount: 0
                    publicLaws:
                      - Pub. L. 101-336
                      - Pub. L. 102-166
                      - Pub. L. 88-352
                    granuleId: USCODE-2024-title42-chap21-subchapI-sec1981a
                    packageId: USCODE-2024-title42
                    htmlUrl: >-
                      https://statutes-us.vaquill.ai/usc/html/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1981a.htm
                    pdfUrl: >-
                      https://statutes-us.vaquill.ai/usc/pdf/2024/title-42/USCODE-2024-title42-chap21-subchapI-sec1981a.pdf
                    govInfoHtmlUrl: >-
                      https://www.govinfo.gov/content/pkg/USCODE-2024-title42/html/USCODE-2024-title42-chap21-subchapI-sec1981a.htm
                    govInfoPdfUrl: >-
                      https://www.govinfo.gov/content/pkg/USCODE-2024-title42/pdf/USCODE-2024-title42-chap21-subchapI-sec1981a.pdf
                    externalUrl: >-
                      https://www.govinfo.gov/app/details/USCODE-2024-title42/USCODE-2024-title42-chap21-subchapI-sec1981a
                notFound: []
                count: 2
                processingTimeMs: 11
                creditsConsumed: 12
        '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'
        '422':
          description: Empty or oversized `actIds`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiDetailError'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiDetailError'
components:
  schemas:
    StatuteSectionsRequest:
      properties:
        actIds:
          items:
            type: string
          type: array
          maxItems: 50
          minItems: 1
          title: Actids
          description: >-
            Section identifiers from a prior `/statutes/search` response. Up to
            50 per call. Duplicates are collapsed, and order is preserved in the
            response. Each id encodes the citation's hierarchy:
            `USC_T42_C21_S1983` is Title 42, Chapter 21, Section 1983. The
            chapter is not derivable from a citation, so take ids from search
            results rather than assembling them.
          examples:
            - - USC_T42_C21_S1983
              - CFR_T17_P240_S240_10b5_1
      type: object
      required:
        - actIds
      title: StatuteSectionsRequest
      description: Batch metadata lookup. See `POST /statutes/sections`.
      example:
        actIds:
          - USC_T42_C21_S1983
          - USC_T42_C21_S1981a
    StatuteSectionsResponse:
      properties:
        sections:
          items:
            $ref: '#/components/schemas/StatuteResult'
          type: array
          title: Sections
          description: Found sections, in the order the ids were supplied.
        notFound:
          items:
            type: string
          type: array
          title: Notfound
          description: >-
            Identifiers with no match. These are NOT charged, so a batch with
            misses costs less than `len(actIds)` times the per-section rate.
        count:
          type: integer
          title: Count
          description: Number of sections returned.
          default: 0
        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:
            - 240.5
        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, and batch
            endpoints charge per item returned, so a partial result costs less
            than a full one.
          default: 0
          examples:
            - 4
      type: object
      title: StatuteSectionsResponse
      description: Response for `POST /statutes/sections`.
    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.
    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 /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:<section>'` 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 /statutes/section/{actId}` for a row
            that carries `frRegulationIdNumbers`; always null on
            `/statutes/search` results, since computing it needs a follow-up
            lookup that is too expensive to run per search result.
        sourceCredit:
          anyOf:
            - type: string
            - type: 'null'
          title: Sourcecredit
          description: >-
            The source's amendment/credit line, e.g. `[48 FR 3956, Jan. 28,
            1983, as amended at 49 FR 15073, Apr. 17, 1984]`.
        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.
        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.
        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.
        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.
    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 Vaquill developer dashboard. Pass as
        `Authorization: Bearer vq_key_...`

````