---
title: "Get country options"
method: GET
path: "/api/demographics/v1/References/CountryOptions"
tags: ["References"]
---

# Get country options

`GET /api/demographics/v1/References/CountryOptions`

Retrieve a collection of country options based on the provided addressType.

## Query parameters

- `addressType` string

## Response `200`

Returns a list of country options successfully.

- MerchantDemographicsReferencesApiModelsCountryOptionCollection
  - `content` MerchantDemographicsReferencesApiModelsCountryOption[], nullable — A collection of Company Option and their respective details.
    - `countryCode` integer — The unique numeric code for the country.
    - `countryName` string, nullable — The name of the country.
    - `isDisplayed` boolean — Indicates whether the country should be displayed in the UI or a specific context.
    - `iso2` string, nullable — The ISO 3166-1 alpha-2 code for the country.
    - `iso3` string, nullable — The ISO 3166-1 alpha-3 code for the country.
    - `stateOrProvinceIsRequired` boolean — Indicates whether the state or province is required for addresses in this country.

## Other responses

- `400` — Bad request: If Address type is not proper enum values
- `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)