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

# List US statutes coverage by jurisdiction

> List every jurisdiction in the corpus (49 of the 50 states, plus DC, Puerto Rico, and federal USC/CFR), each with its ingested section count. Use this to discover what is queryable via /statutes/search. `kind` is `federal`, `state`, or `territory` (DC, PR). Each row also carries a `corpora` breakdown of counts per `corpusType` token.

For a self-describing matrix with a corpusType legend, call /statutes/coverage. For the human-readable breakdown, see the [Coverage page](https://www.vaquill.ai/docs/coverage).

**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/states
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/states:
    get:
      tags:
        - US Statutes
      summary: List US statutes coverage by jurisdiction
      description: >-
        List every jurisdiction in the corpus (49 of the 50 states, plus DC,
        Puerto Rico, and federal USC/CFR), each with its ingested section count.
        Use this to discover what is queryable via /statutes/search. `kind` is
        `federal`, `state`, or `territory` (DC, PR). Each row also carries a
        `corpora` breakdown of counts per `corpusType` token.


        For a self-describing matrix with a corpusType legend, call
        /statutes/coverage. For the human-readable breakdown, see the [Coverage
        page](https://www.vaquill.ai/docs/coverage).


        **Free.** Requires an API key and is rate-limited, but costs no credits.
      operationId: list_statutes_states_api_v1_statutes_states_get
      responses:
        '200':
          description: Coverage summary across all jurisdictions.
          content:
            application/json:
              schema: {}
              example:
                data:
                  jurisdictions:
                    - code: federal
                      name: Federal (USC + CFR)
                      kind: federal
                      sectionCount: 706474
                      hasData: true
                    - code: ms
                      name: Mississippi
                      kind: state
                      sectionCount: 184561
                      hasData: true
                    - code: nj
                      name: New Jersey
                      kind: state
                      sectionCount: 158892
                      hasData: true
                    - code: tx
                      name: Texas
                      kind: state
                      sectionCount: 68338
                      hasData: true
                    - code: dc
                      name: District of Columbia
                      kind: territory
                      sectionCount: 21088
                      hasData: true
                    - code: in
                      name: Indiana
                      kind: state
                      sectionCount: 0
                      hasData: false
                  totalSections: 2663317
                  stateCountWithData: 49
                meta:
                  processingTimeMs: 5385.6
                  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_...`

````