---
title: "List Country States"
method: GET
path: "/consumer/v1/customers/states"
tags: ["Customers"]
---

# List Country States

`GET /consumer/v1/customers/states`

Use this endpoint to return a **List of Countries with their associated State Codes**. Supply a country code to filter results further. If states for your countries of operation are not currently listed, contact us at _**support@onsched.com**_.

## Query parameters

- `country` string

## Response `200`

Success

- StateViewModel[]
  - `object` string, nullable
  - `name` string, nullable
  - `code` string, nullable
  - `country` string, nullable
  - `countryName` string, nullable

---

[API](https://skmtc.net/onsched/apis/onsched-consumer-api.md) · [All operations](https://skmtc.net/onsched/apis/onsched-consumer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onsched/onsched-consumer-api/versions/1cd2a28a0305/schema)