---
title: "List all states"
method: GET
path: "/v1/states"
tags: ["States"]
---

# List all states

`GET /v1/states`

## Request

- Base URL: `https://api.hempdata.io`
- URL: `https://api.hempdata.io/v1/states`
- Auth: HTTP bearer

Returns all 50 US states plus DC with summary regulatory information.

## Response `200`

List of state summaries

- ApiResponseStateList
  - `success` boolean, required
  - `data` StateSummary[], required
    - `code` string, required: Two-letter state code
    - `name` string, required
    - `regulation_count` integer, required: Number of regulation records for this state
    - `overall_stance` 'permissive' | 'moderate' | 'restrictive' | 'prohibitive', required: General regulatory stance toward hemp products
    - `last_updated` string, date-time, required
  - `meta` object
    - `total` integer
  - `errors` ApiError[], nullable
    - `code` string, required: Machine-readable error code
    - `message` string, required: Human-readable error message
    - `field` string, nullable: Field that caused the error, if applicable

---

[API](https://skmtc.dev/hempdata/apis/hempdata-api.md) · [All operations](https://skmtc.dev/hempdata/apis/hempdata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hempdata/apis/hempdata-api/revisions/2c2946badd40?raw)