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