---
title: Get Supported Countries or Regions
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/get-supported-countries-or-regions
---

# Get Supported Countries or Regions

Fetches supported languages and language codes.

## URL

GET https://api.searchads.apple.com/api/v5/countries-or-regions

## Query Parameters

countriesOrRegions: Filters by ISO alpha-2 country codes using one or more comma-separated values. For example, use https://api.searchads.apple.com/api/v5/countries-or-regions?countriesOrRegions=US for a single country or region, or https://api.searchads.apple.com/api/v5/countries-or-regions?countriesOrRegions=US, MX for multiple countries or regions.

## Response Codes

200 OK: If the call succeeds, the API returns the CountriesOrRegionsListResponse object in the response payload with an HTTP status code of 200(OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 400 Bad Request: An invalid query or missing required parameters. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

## Mentioned in

Apple Ads Campaign Management API 4

## Discussion

Discussion Use this endpoint to fetch supported product page languages for countries or regions. Payload example 1: Get supported countries or regions Payload example 2: Get supported countries or regions

## See Also

### Product Page Endpoints

- [Get Product Pages](apple_ads/get-product-pages.md)
- [Get Product Pages by Identifier](apple_ads/get-product-pages-by-identifier.md)
- [Get Product Page Locales](apple_ads/get-product-page-locales.md)
- [Get App Preview Device Sizes](apple_ads/get-app-preview-device-sizes.md)