---
title: "Get state options"
method: GET
path: "/api/demographics/v2/References/StateOptions"
tags: ["ReferencesControllerV2"]
---

# Get state options

`GET /api/demographics/v2/References/StateOptions`

Retrieve a list of state options from the database.

Note: The response includes a structured collection of states based on predefined configurations.

## Query parameters

- `countryCode` string

## Response `200`

Returns a list of state types successfully.

- MerchantDemographicsReferencesApiModelsStateOptionCollection
  - `content` MerchantDemographicsReferencesApiModelsStateOption[], nullable — A collection of State Option and their respective details.
    - `stateCode` string, nullable — The unique code for the state or province, typically represented as an abbreviation.
    - `stateName` string, nullable — The full name of the state or province.
    - `isDisplayed` boolean — Indicates whether the state or province should be displayed in the UI or a specific context.
    - `countryCode` string, nullable — The country code associated with this state or province, typically using ISO 3166-1 alpha-2 format.

## Other responses

- `401` — Unauthorized: User does not have the required role or access.
- `500` — Internal Server Error: This could be due to system errors. Please contact support for assistance.

---

[API](https://skmtc.net/xplorpay/apis/external-us-onboarding-workflow.md) · [All operations](https://skmtc.net/xplorpay/apis/external-us-onboarding-workflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xplorpay/external-us-onboarding-workflow/revisions/f37077c24b66/schema)