# List states

List all states

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

## Security:

  - `authorization` (unknown)
    http bearer API_KEY

## Query parameters:

  - `limit` (integer)
    The number of records to return

  - `offset` (integer)
    The number of records to skip

  - `name` (string)
    Filter by name (case-insensitive partial match)

  - `country_code` (string)
    Filter by country code (exact match, e.g. "US")

## Response 200:

  - `200` (unknown)
    States

## Response 200 fields (application/json):

  - `count` (integer)
    Record count

  - `data` (array)

  - `data.country` (object, required)

  - `data.country.code` (string, required)
    Country code (alpha-2)

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

  - `data.name` (string, required)
    State name

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `errors` (array)

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

  - `errors.source` (string)

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

## Response 402:

  - `402` (unknown)
    Payment Required

## Response 402 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)
    Example: Your organization has exhausted its available credits. Contact customersupport@hginsights.com.

  - `errors.source` (string)

  - `errors.title` (string, required)
    Example: Credits exhausted

## Response 422:

  - `422` (unknown)
    Unprocessable Entity

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