# List states

List all states

Endpoint: GET /data-api/v1/catalog/states
Security: authorization

## Response 200 fields (application/json):

  - `count` (integer)
    Record count
    Example: 1

  - `data` (array)
    Example: [{"country":{"alpha2":"FR"},"id":"AEA8D2254D475DED13FD3F4339C6B8G","name":"Île-de-France"}]

  - `data.country` (object, required)
    Example: {"alpha2":"FR"}

  - `data.country.alpha2` (string, required)
    Country code (alpha-2)
    Example: "FR"

  - `data.id` (any, required)
    A unique hexadecimal identifier for the desired field.
    Example: "1698C53EBC888758570396E0334965C1"

  - `data.name` (string, required)
    State name
    Example: "Île-de-France"

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)
    Example: "The token provided is not valid"

  - `errors.source` (object)

  - `errors.title` (string, required)
    Example: "Unauthorized"

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.detail` (string, required)
    Example: "null value where string expected"

  - `errors.source` (object, required)

  - `errors.source.pointer` (string, required)
    Example: "/data/attributes/petName"

  - `errors.title` (string, required)
    Example: "Invalid value"