# Country Subdivision Search
source: https://developer.mastercard.com/locations/documentation/use-cases/country-subdivision-code/index.md

## Country Subdivision Search {#country-subdivision-search}

This endpoint allows customers to retrieve a list of administrative subdivisions (such as states, provinces, or regions) for a specified country to support location-based searches and filtering.

### Where it applies {#where-it-applies}

Organizations that provide consumer-facing financial experiences and need to support customer cash-access journeys.

* Issuers
* Retail Banks
* Digital Banks
* Fintechs
* Digital Wallet Providers
* Consumer Banking Applications

## How it works {#how-it-works}

Diagram sequence-subdivision

**Example Response for country_code = `USA`:**

```json
{
  "countrySubdivisions": [
    {
      "countrySubdivisionCode": "AK",
      "countrySubdivisionName": "ALASKA"
    },
    {
      "countrySubdivisionCode": "AL",
      "countrySubdivisionName": "ALABAMA"
    },
    ...

    ...
    {
      "countrySubdivisionCode": "WI",
      "countrySubdivisionName": "WISCONSIN"
    },
    {
      "countrySubdivisionCode": "WV",
      "countrySubdivisionName": "WEST VIRGINIA"
    },
    {
      "countrySubdivisionCode": "WY",
      "countrySubdivisionName": "WYOMING"
    }
  ]
}
```

## Relevant Endpoints {#relevant-endpoints}

[Country Subdivisions](https://developer.mastercard.com/locations/documentation/api-reference/index.md#tag/ATMs/operation/getCountrySubdivisions)
This API allows returns a list of country subdivisions for a given country

API Reference: `GET /country-subdivisions`

## Useful Links {#useful-links}

* [View the full Open API Specification](https://developer.mastercard.com/locations/documentation/api-reference/index.md)
* [Review the APIs error responses](https://developer.mastercard.com/locations/documentation/code-and-formats/index.md)