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

# Coverage matrix by jurisdiction and corpusType

> Self-describing coverage matrix. Returns a legend of every `corpusType` token (what it contains and whether it is federal or state-scoped) plus, for each jurisdiction, the per-corpusType ingested chunk counts in `corpora`. Use it to learn exactly what is queryable where before calling /statutes/search: read a jurisdiction's `corpora` keys, then pass one as `corpusType` (paired with `state` for state-scoped corpora).

**Free.** Requires an API key and is rate-limited, but costs no credits.



## OpenAPI

````yaml https://api.vaquill.ai/external/openapi.json get /api/v1/statutes/coverage
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 ($199/mo, 1x) | 30 | 500 | 2,000 |

    | API Business ($1,000/mo, 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: 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/coverage:
    get:
      tags:
        - US Statutes
      summary: Coverage matrix by jurisdiction and corpusType
      description: >-
        Self-describing coverage matrix. Returns a legend of every `corpusType`
        token (what it contains and whether it is federal or state-scoped) plus,
        for each jurisdiction, the per-corpusType ingested chunk counts in
        `corpora`. Use it to learn exactly what is queryable where before
        calling /statutes/search: read a jurisdiction's `corpora` keys, then
        pass one as `corpusType` (paired with `state` for state-scoped corpora).


        **Free.** Requires an API key and is rate-limited, but costs no credits.
      operationId: list_statutes_coverage_api_v1_statutes_coverage_get
      responses:
        '200':
          description: Coverage legend plus per-jurisdiction corpusType counts.
          content:
            application/json:
              schema: {}
              example:
                data:
                  corpusTypes:
                    - token: USC
                      description: United States Code (federal statutes)
                      scope: federal
                    - token: REGULATION
                      description: State administrative regulations
                      scope: state
                  jurisdictions:
                    - code: federal
                      name: Federal (USC + CFR)
                      kind: federal
                      sectionCount: 812553
                      hasData: true
                      corpora:
                        CFR: 491612
                        USC: 212042
                        FEDERAL_REGISTER: 102861
                        EXECUTIVE_ACTION: 3599
                        AGENCY_GUIDANCE: 2510
                        FEDERAL_RULES: 526
                        CONSTITUTION: 74
                    - code: wa
                      name: Washington
                      kind: state
                      sectionCount: 140326
                      hasData: true
                      corpora:
                        STATE: 89005
                        REGULATION: 51142
                        STATE_CONSTITUTION: 179
                  totalSections: 2937552
                  stateCountWithData: 49
                meta:
                  processingTimeMs: 5401.2
                  creditsConsumed: 0
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiDetailError'
              example:
                detail: Invalid or missing API key.
        '403':
          description: API key lacks `research:read` scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiDetailError'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiDetailError'
components:
  schemas:
    ApiDetailError:
      properties:
        detail:
          type: string
          title: Detail
          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.
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: vq_key_*
      description: >-
        API key issued from the Vaquill developer dashboard. Pass as
        `Authorization: Bearer vq_key_...`

````