---
title: "Lists available state names"
method: GET
path: "/states"
tags: ["States"]
---

# Lists available state names

`GET /states`

## Request

- Base URL: `/api/v4` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v4/states`
- Auth: none declared

## Response `200`

returns state names

- object: List of available state names
  - `states` object[]
    - `name` string

## Changes

- **2021-08-24** (v4) `da9b86655086`: 1 info
  - endpoint added
- **2020-04-20** (v4) `44261500935e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/simpledotorg/apis/simple-api/changes/states/get.md)

---

[API](https://skmtc.dev/simpledotorg/apis/simple-api.md) - [All operations](https://skmtc.dev/simpledotorg/apis/simple-api/llms.txt) - [OpenAPI document](https://skmtc.dev/simpledotorg/apis/simple-api/revisions/31ffa1d07978?raw)