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

# Resolve many citations at once

> Resolve up to 50 Bluebook citations to their exact sections in one call.

The batch form of `GET /us/statutes/resolve`, and the same verdict per
citation. Use it when you are checking the citations in a document rather than
looking one up: a brief, a memo, or a model's output typically carries dozens,
and the single-citation route makes that dozens of round trips.

**Cost**: 2 credits per citation, the same as resolving them one at a time.
Batching buys a round trip and latency, not a discount. Unresolved citations
are charged (a confident "this does not resolve" is the answer you are paying
for when verifying a model's output); only citations we failed to process
because of a backend error are refunded, and `creditsConsumed` reports what was
actually billed.

**Duplicates are collapsed** before pricing and before the response is built,
so sending the same citation twice costs once and returns one entry.

**Every input gets an entry.** An unresolved citation appears with
`resolved: false`, never as an omission: a caller checking thirty citations
needs to know WHICH failed, and a shorter array cannot say that.

## Example

```python
requests.post(url, headers=h, json={
    "citations": [
        "42 U.S.C. 1983",
        "16 C.F.R. 444.1",
        "Cal. Civ. Code 1950.5",
    ],
})
```

Scope the whole batch with `state` or `corpusType` when every citation belongs
to one jurisdiction or corpus (`22 CCR 76227` is California and `8 CCR 1206-2`
is Colorado; the acronym alone cannot say which). Omit both for a batch that
spans jurisdictions and let each citation name its own.



## OpenAPI

````yaml https://api.vaquill.ai/external/openapi.json post /api/v1/us/statutes/resolve
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 and the Statutes at Large, the CFR and its annual
    editions, all 52 state and territory statutory codes (50 states plus DC and
    Puerto Rico), state administrative regulations, court rules, federal and
    state constitutions, federal agency guidance and adjudications, the Federal
    Register, the Sentencing Guidelines and US tax treaties. | `US` |


    See the full [Coverage page](https://www.vaquill.ai/docs/api-guide/coverage)
    for the jurisdiction-by-jurisdiction breakdown, or call
    `/us/statutes/coverage` for live counts. Coverage is per (jurisdiction,
    corpusType) pair, so treat that endpoint as the authoritative list rather
    than this summary.


    ## Endpoints


    - **US Statutes**: Search and retrieve any of the corpora above with full
    text, resolve a citation to its exact section, browse the statutory
    hierarchy, read a section as it stood on a past date, and follow its change
    history, cross-references and defined terms

    - **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/resolve:
    post:
      tags:
        - US Statutes
      summary: Resolve many citations at once
      description: >-
        Resolve up to 50 Bluebook citations to their exact sections in one call.


        The batch form of `GET /us/statutes/resolve`, and the same verdict per

        citation. Use it when you are checking the citations in a document
        rather than

        looking one up: a brief, a memo, or a model's output typically carries
        dozens,

        and the single-citation route makes that dozens of round trips.


        **Cost**: 2 credits per citation, the same as resolving them one at a
        time.

        Batching buys a round trip and latency, not a discount. Unresolved
        citations

        are charged (a confident "this does not resolve" is the answer you are
        paying

        for when verifying a model's output); only citations we failed to
        process

        because of a backend error are refunded, and `creditsConsumed` reports
        what was

        actually billed.


        **Duplicates are collapsed** before pricing and before the response is
        built,

        so sending the same citation twice costs once and returns one entry.


        **Every input gets an entry.** An unresolved citation appears with

        `resolved: false`, never as an omission: a caller checking thirty
        citations

        needs to know WHICH failed, and a shorter array cannot say that.


        ## Example


        ```python

        requests.post(url, headers=h, json={
            "citations": [
                "42 U.S.C. 1983",
                "16 C.F.R. 444.1",
                "Cal. Civ. Code 1950.5",
            ],
        })

        ```


        Scope the whole batch with `state` or `corpusType` when every citation
        belongs

        to one jurisdiction or corpus (`22 CCR 76227` is California and `8 CCR
        1206-2`

        is Colorado; the acronym alone cannot say which). Omit both for a batch
        that

        spans jurisdictions and let each citation name its own.
      operationId: resolve_statute_citations_batch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatuteResolveBatchRequest'
      responses:
        '200':
          description: One verdict per submitted citation, in order.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatuteResolveBatchResponse'
        '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 `citations`, more than 50, or a bad `state`/`corpusType`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiDetailError'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiDetailError'
components:
  schemas:
    StatuteResolveBatchRequest:
      properties:
        citations:
          items:
            type: string
          type: array
          minItems: 1
          title: Citations
          description: >-
            Bluebook citation strings to resolve, up to 50 per call. Duplicates
            are collapsed and order is preserved, so the response's `results`
            array lines up with the de-duplicated input.


            Priced PER CITATION at the single-resolve rate, exactly like `POST
            /us/statutes/sections`: batching is a round-trip and latency win,
            not a discount. Thirty citations cost the same 60 credits either way
            and take one request instead of thirty.
          examples:
            - - 42 U.S.C. 1983
              - 16 C.F.R. 444.1
              - Cal. Civ. Code 1950.5
        state:
          anyOf:
            - type: string
              maxLength: 2
              minLength: 2
            - type: 'null'
          title: State
          description: >-
            Optional two-letter jurisdiction to resolve every citation WITHIN.
            Applies to the whole batch: a batch spanning jurisdictions should
            omit it and let each citation name its own. Same semantics as the
            single-citation route -- a constraint, not a hint.
          examples:
            - ca
        corpusType:
          anyOf:
            - type: string
            - type: 'null'
          title: Corpustype
          description: >-
            Optional corpus to resolve every citation WITHIN: `STATE`,
            `REGULATION`, `STATE_RULES`, `CONSTITUTION`, `STATE_CONSTITUTION`.
          examples:
            - REGULATION
      additionalProperties: false
      type: object
      required:
        - citations
      title: StatuteResolveBatchRequest
      description: >-
        Batch citation resolution. See `POST /us/statutes/resolve`.


        `/resolve` took 1,159 calls in the 16 days to 2026-08-31, second only to

        search, and every one of them carried a single citation. The caller
        shape it

        is actually serving is an agent handed a brief, a memo or a model's
        output

        with thirty citations in it, doing thirty round trips to check them.
    StatuteResolveBatchResponse:
      properties:
        results:
          items:
            $ref: '#/components/schemas/StatuteResolveBatchItem'
          type: array
          title: Results
          description: >-
            One entry per de-duplicated input citation, in the order supplied.
            An unresolved citation is an entry with `resolved: false`, never an
            omission: a caller checking thirty citations needs to know which of
            them failed, and a shorter array cannot say.
        resolvedCount:
          type: integer
          title: Resolvedcount
          description: How many of the submitted citations resolved.
          default: 0
          examples:
            - 2
        count:
          type: integer
          title: Count
          description: Total entries in `results`, after de-duplication.
          default: 0
          examples:
            - 3
        processingTimeMs:
          type: number
          title: Processingtimems
          description: Server-side time for this request in milliseconds.
          default: 0
          examples:
            - 610.2
        creditsConsumed:
          type: number
          title: Creditsconsumed
          description: >-
            Credits actually charged. Read it rather than multiplying the list
            price by your input length: a backend failure on some citations
            refunds those, so this can be lower than 2 x `count`.
          default: 0
          examples:
            - 6
      type: object
      title: StatuteResolveBatchResponse
      description: Response for `POST /us/statutes/resolve`.
    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.
    StatuteResolveBatchItem:
      properties:
        resolved:
          type: boolean
          title: Resolved
          description: True when this citation resolved to an exact section.
        inputCitation:
          type: string
          title: Inputcitation
          description: The citation string you asked to resolve, echoed back.
        section:
          anyOf:
            - $ref: '#/components/schemas/StatuteResult'
            - type: 'null'
          description: The resolved section, or null when this citation did not resolve.
        subsection:
          anyOf:
            - type: string
            - type: 'null'
          title: Subsection
          description: >-
            Parsed pinpoint subsection when the citation carried one. See the
            single-citation route for the full semantics, including the case
            where the publisher issues a larger unit than the citation names.
      type: object
      required:
        - resolved
        - inputCitation
      title: StatuteResolveBatchItem
      description: >-
        One citation's verdict inside a batch response.


        Deliberately the same field names as `StatuteResolveResponse` minus the

        per-request bookkeeping, so a caller migrating from the single route
        reads

        each item with the code it already has.
    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: `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), `irs_irm` (Internal Revenue Manual (IRS internal
            procedure)), `merger_guidelines` (DOJ & FTC Merger Guidelines
            (2023)), `doj_leniency` (DOJ Antitrust Division Leniency Policy),
            `doj_business_review` (DOJ Antitrust Division Business Review
            Letters (1991-2021)), `cms_iom` (CMS Medicare Internet-Only Manuals
            (instruction to Medicare contractors, not a regulation)),
            `copyright_circular` (US Copyright Office Circulars),
            `copyright_compendium` (Compendium of U.S. Copyright Office
            Practices, Third Edition (2014, 2017 and 2021 editions)),
            `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)), `fincen_boi_faq` (FinCEN Beneficial Ownership Information
            FAQs), `fincen_boi_rule_qa` (FinCEN BOI Rulemaking Q&As (final rule
            and interim final rule)), `fincen_boi_compliance_guide` (FinCEN
            Small Entity Compliance Guide (Beneficial Ownership Information
            Reporting)), `fincen_amla_material` (FinCEN Anti-Money Laundering
            Act of 2020 Implementation Material), `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)), `cfpb_supervisory_guidance` (CFPB Supervisory
            Guidance), `cfpb_circular` (CFPB Consumer Financial Protection
            Circulars), `dfars_pgi` (DFARS PGI (Procedures, Guidance, and
            Information)), `ftc_advisory_opinion` (FTC Advisory Opinions),
            `ftc_policy_statement` (FTC Policy Statements (1967-present)),
            `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), `whd_opinion_letter` (DOL
            Wage and Hour Division Opinion, Ruling and Administrator
            Interpretation Letters (FLSA, FMLA, DBRA, SCA, CCPA, MSPA;
            1993-present)), `whd_foh` (DOL Wage and Hour Field Operations
            Handbook (WHD internal enforcement procedure, not law; 22
            chapters)), `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), `ofac_faq` (OFAC (Office of
            Foreign Assets Control) Frequently Asked Questions),
            `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), `eeoc_guidance` (EEOC
            (Equal Employment Opportunity Commission) Enforcement and Policy
            Guidance, including Compliance Manual sections),
            `irs_written_determination` (IRS Written Determinations under 26
            U.S.C. § 6110: Private Letter Rulings (PLR), Technical Advice
            Memoranda (TAM) and Chief Counsel Advice (CCA). Each is directed
            only to the taxpayer who requested it and, by § 6110(k)(3), may not
            be used or cited as precedent).


            `US_TAX_TREATY` sources: `us_tax_treaty` (U.S. Bilateral Income and
            Estate Tax Treaties), `us_tax_treaty_technical_explanation`
            (Treasury Technical Explanations (article-by-article commentary on a
            tax treaty)), `senate_treaty` (Senate Treaty Records (transmittal,
            parties and proceedings)), `senate_treaty_resolution` (Senate
            Resolutions of Advice and Consent, including the reservations,
            understandings and declarations that narrow a treaty's effect in US
            law), `senate_treaty_document` (Treaty Documents (CDOC TDOC series):
            the President's message transmitting a treaty to the Senate, with
            the instrument's text).


            `STATE_AGENCY_GUIDANCE` sources: `state_insurance_bulletin` (State
            Department of Insurance Bulletins), `state_financial_bulletin`
            (State Financial-Institutions Regulator Bulletins (banking, credit
            unions, trust companies, escrow agents, consumer lenders, money
            transmitters; AZ and OR only, where that regulator shares an index
            with the insurance regulator)).


            `AGENCY_ADJUDICATION` sources: `mspb_precedential` (MSPB
            Precedential Decisions), `mspb_nonprecedential` (MSPB
            Nonprecedential Orders), `olc_opinion` (DOJ Office of Legal Counsel
            Opinions (official bound volumes, 1933-2020)),
            `cfpb_enforcement_action` (CFPB Enforcement Actions),
            `sec_commission_opinion` (SEC Commission Opinions and Adjudicatory
            Orders), `bia_precedent` (BIA Precedent Decisions (I&N Dec.)),
            `ag_precedent` (Attorney General Immigration Decisions (I&N Dec.)),
            `immigration_admin_precedent` (INS and USCIS Administrative
            Precedent Decisions (I&N Dec.)), `nlrb_board_decision` (NLRB Board
            Decisions (bounded window; see coverage.mdx for the exact years
            covered)), `ftc_administrative_decision` (FTC Part 3 Administrative
            Decisions). 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: >-
            The year this row was ingested, not the year of the law. Most
            ingesters stamp the capture year (`time.gmtime().tm_year`) and a few
            pin a literal, so 1,575,300 statute sections currently read 2026.
            **Do not filter or reason about currency with it.**
            `lastAmendedYear` carries the amendment year, `currentThrough` and
            `currencyNote` carry the publisher's own currency statement, and
            `goodLawStatus` carries the status.
        relevanceScore:
          anyOf:
            - type: number
            - type: 'null'
          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. **null on any
            endpoint that did not rank**: fetching a section by id, a batch
            fetch, or a section embedded in an intelligence response. It
            defaulted to 0.0 there, which reads as 'worst possible match' on a
            section the caller asked for by name.
        excerpt:
          type: string
          title: Excerpt
          description: Text excerpt (up to 500 characters).
          default: ''
        body:
          anyOf:
            - type: string
            - type: 'null'
          title: Body
          description: >-
            Full plain text of the section. Present ONLY when the request set
            `includeBody: true`, and null on any row whose text could not be
            resolved (those rows are not charged for a body).


            This is the actual statutory text, not the `excerpt`. The two are
            different things and the difference matters for quoting: `excerpt`
            is a ranking preview windowed around the match, so it can begin
            mid-section and drop a leading subsection marker -- measured
            2026-09-02, four of five California rows lost their opening `(a) `.
            `body` is the document as the publisher printed it.
          examples:
            - (a) If within a reasonable time after written or oral notice...
        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:<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.
            `[{'cfrTitle': 17, 'part': '240', 'partName': '...', '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: >-
            Distinct years the section was amended, parsed from the publisher's
            history note.


            **Always newest first, and de-duplicated.** Ingesters store the
            array in both orders (eCFR writes newest first, state regulations
            and state statutes write oldest first), so the order is imposed at
            serve time and the served order is the only one to rely on. Years
            outside 1789..(current year) are dropped rather than served:
            amendment dates are parsed out of prose and a note can yield a
            sunset or substitution date that is not an amendment at all.
        lastAmendedYear:
          anyOf:
            - type: integer
            - type: 'null'
          title: Lastamendedyear
          description: >-
            Most recent amendment year, when known. Re-derived at serve time as
            `max(amendmentYears)`, so it never exceeds the list served beside
            it. Falls back to the publisher's own scalar only when
            `amendmentYears` is empty, and only when that scalar is itself
            within 1789..(current year).
        amendmentsCount:
          anyOf:
            - type: integer
            - type: 'null'
          title: Amendmentscount
          description: >-
            How many amendments the publisher recorded for this section. **Not
            the length of `amendmentYears`, and it is not safe to derive one
            from the other.**


            For regulations and court rules this counts amending EVENTS: one per
            register citation, filing or history entry, so a section amended
            twice in the same year counts 2 against a single entry in
            `amendmentYears`. Measured 2026-08-30, the two numbers differ on
            181,757 regulation sections and 15,648 court-rule sections. For the
            other corpora, and for any source that publishes no per-event
            record, it falls back to the number of distinct years, which
            understates a section amended twice in one year.
        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: >-
            HTML rendering of the document. For most state corpora this is the
            publisher's own page; for corpora we mirror (state agency guidance,
            regulations, court rules) it is our archived copy of the artifact
            the publisher served, on statutes-us.vaquill.ai. Use `externalUrl`
            for the publisher's canonical address. Never a PDF: a mirrored PDF
            is served as `pdfUrl` instead. 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.
        forum:
          anyOf:
            - type: string
            - type: 'null'
          title: Forum
          description: >-
            For `corpusType=AGENCY_ADJUDICATION`, the KIND of proceeding that
            produced the document, in the publisher's own words. On CFPB
            enforcement actions this is `Administrative Proceeding` (the
            Bureau's own Office of Administrative Adjudication, under 12 C.F.R.
            Part 1081) or `Civil Action` (a suit the Bureau filed in a federal
            district court). One action can carry both, in which case they are
            joined with `; `. Null on every other corpus.
          examples:
            - Administrative Proceeding
        court:
          anyOf:
            - type: string
            - type: 'null'
          title: Court
          description: >-
            The body that heard the matter, where the publisher names one.
            Distinct from `forum`, which is the KIND of proceeding: `forum` has
            two values and is what you filter on, `court` has as many values as
            there are districts and is for display. Populated on every CFPB
            civil action and on the administrative proceedings the Bureau labels
            with its own adjudication office.
          examples:
            - U.S. District Court for the District of Massachusetts
        relatedDocuments:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Relateddocuments
          description: >-
            The publisher's own labels for the filings whose text this record
            carries, in the order the publisher lists them. A CFPB enforcement
            action is ONE legal event published as two to seventeen PDFs and the
            unit we serve is the ACTION, not the filing: a consent order and the
            stipulation consenting to it are one record, because splitting them
            makes every search return two half-answers. This is what tells you
            which filings are inside the record you are holding. Only the
            operative instrument is mirrored under `pdfUrl`.
          examples:
            - - Consent Order
              - Stipulation
        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.
    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_...`

````