---
title: Query for Locations
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-locations
---

# Query for Locations

Retrieve a paginated list of business locations using filters and sorting.

## URL

POST https://api.ads.apple.com/v1/locations/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 retrieves a paginated list of physical business locations associated with a brand. Locations are the physical stores or venues that BUSINESS_BRAND campaigns advertise. When creating ad groups for these campaigns, use location id values from this endpoint to scope delivery to specific stores or venues. Locations are registered entities that represent physical places of business, such as retail stores, restaurants, and service centers. An empty request body returns all locations with default pagination. Filter by brandId to retrieve locations for a specific brand. 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. Request Body See QueryRequest. Each location record returned by this endpoint includes the following fields:  |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |  A few limitations apply to querying locations and using the results for targeting:  |   |   |   |  Payload Examples

## See Also

- [Get a Location](apple-ads-platform-api/get-location-by-id.md)