<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Get-Supported-Countries-or-Regions",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:get:v5-countries-or-regions"
  },
  "title" : "Get Supported Countries or Regions"
}
-->

# Get Supported Countries or Regions

Fetches supported languages and language codes.

## Discussion

Use this endpoint to fetch supported product page languages for countries or regions.

### Payload example 1: Get supported countries or regions

**Request:**

```
GET https://api.searchads.apple.com/api/v5/countries-or-regions?countriesOrRegions=US,AU,GB,CA
```

**Response:**

```json
{
   "data": [
        {
            "countryOrRegion": “US”,
            "supportedLanguages": [
                {
                    "language": "en",
                    "languageCode": "en-US"
                },
                {
                    "language": “es”,
                    "languageCode": "es-MX"
                }
            ],
            "defaultLanguage": {
                "language": "en",
                "languageCode": "en-US"
            }
        },
        {
            "countryOrRegion": "AU",
            "supportedLanguages": [
                {
                    "language": "en",
                    "languageCode": "en-AU"
                },
                {
                    "language": "en",
                    "languageCode": "en-GB"
                }
            ],
            "defaultLanguage": {
                "language": "en",
                "languageCode": "en-AU"
            }
        },
        {
            "countryOrRegion": "GB",
            "supportedLanguages": [
                {
                    "language": "en",
                    "languageCode": "en-GB"
                }
            ],
            "defaultLanguage": {
                "language": "en",
                "languageCode": "en-GB"
            }
        },
        {
            "countryOrRegion": "CA",
            "supportedLanguages": [
                {
                    "language": "en",
                    "languageCode": "en-CA"
                },
                {
                    "language”: "fr",
                    "languageCode": "fr-CA"
                }
            ],
            "defaultLanguage": {
                "language": "en",
                "languageCode": "en-CA"
            }
        }
    ]
}
```

### Payload example 2: Get supported countries or regions

**Request:**

```
GET https://api.searchads.apple.com/api/v5/countries-or-regions?countriesOrRegions=CA
```

**Response:**

```json
{
  "countryOrRegion": "CA",
  "supportedLocales": [
    {
      "language": "en",
      "languageCode": "en-CA"
    },
    {
      "language": "fr",
      "languageCode": "fr-CA"
    }
  ],
  "defaultLanguages": [
    {
      "language": "en",
      "languageCode": "en-CA"
    },
    {
      "language": "fr",
      "languageCode": "fr-CA"
    }
  ]
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)