---
title: Query Supported App Languages
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/query-supported-app-languages
---

# Query Supported App Languages

Query countries and regions to discover the ad-supported languages available in each market.

## URL

POST https://api.ads.apple.com/v1/metadata/apps/supported-languages/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint returns a list of countries and regions along with the languages supported for Apple Ads in each market, including each market’s adsSupportedLanguages and adsDefaultLanguages. Use this endpoint to: Validate locale codes before setting them on creatives or ad groups. Populate country/language selection UI in campaign setup workflows. Confirm which languages are available when expanding campaigns into new markets. An empty request body returns all supported countries and regions with default pagination. To scope results to specific country codes, use filters. To order results alphabetically, use sorting. See QueryFilterOperator for the full set of supported comparison operators. Filterable Fields  |  |  |  |   |  |  |  |   |  |  |  |  The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Each result row includes the following fields:  |  |   |  |   |  |   |  |   |  |   |  |   |  |  Payload Examples

## See Also

- [Search for Apps](apple-ads-platform-api/searches-for-a-list-of-apps.md)
- [Get App Details by Adam ID](apple-ads-platform-api/get-app-details-by-adam-id.md)