---
title: LocationQueryResponse
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/locationqueryresponse
---

# LocationQueryResponse

The paginated response envelope returned by the Query Locations endpoint.

## Declaration

```data
object LocationQueryResponse
```

## Properties

result: Array of Location objects matching the supplied query filters. Empty array if no locations match. Read-only. pagination: Pagination metadata for the result set, including totalCount, offset, and pageSize. See QueryPaginationResult. Read-only. error: Error details if the request failed. Absent on success. Read-only.

## Discussion

Discussion The LocationQueryResponse object is the top-level envelope returned by Query for Locations. The result array contains Location objects matching the filters you supplied in the request body. Use pagination.totalCount together with pagination.offset and pagination.pageSize to page through large result sets. Always filter by brandId to scope results to a specific brand. Omitting a brand filter returns locations across all brands in the ad account, which can produce very large result sets. You can assign only locations with eligibility.status: ELIGIBLE to ad group targeting. Use the status filter to narrow to OPEN locations before referencing them in a LocationGroup. Example {   "result": [     {       "id": "123456789",       "brandId": "987654321",       "status": "OPEN",       "name": "AwayFinder Downtown",       "categories": [         "shopping.retail",         "technology"       ],       "address": {         "countryOrRegion": "US",         "adminArea": "California",         "adminAreaCode": "CA",         "locality": "Cupertino",         "subLocality": "De Anza",         "subAdminArea": "Santa Clara County",         "postalCode": "95014",         "thoroughfare": "Infinite Loop",         "subThoroughfare": "1",         "fullThoroughfare": "1 Infinite Loop",         "fullAddress": "1 Infinite Loop, Cupertino, California 95014, US"       },       "displayPoint": {         "latitude": "37.3318",         "longitude": "-122.0312"       },       "countryOrRegion": "US",       "creationTime": "2025-01-10T08:00:00.000",       "modificationTime": "2025-03-20T14:45:00.000",       "eligibility": {         "status": "ELIGIBLE",         "blockedGroups": [],         "allowedGroups": [           {             "supplyPlacement": [               "SEARCH_TAB",               "TODAY_TAB"             ],             "countryOrRegion": [               "US"             ]           }         ]       }     }   ],   "pagination": {     "pageSize": 20,     "offset": 0,     "totalCount": 1   } }

## See Also

- [Brand](apple-ads-platform-api/brand.md)
- [BrandResponse](apple-ads-platform-api/brandresponse.md)
- [BrandQueryResponse](apple-ads-platform-api/brandqueryresponse.md)
- [BrandRejectionReasonResponse](apple-ads-platform-api/brandrejectionreasonresponse.md)
- [BusinessCategory](apple-ads-platform-api/businesscategory.md)
- [BusinessCategoryResponse](apple-ads-platform-api/businesscategoryresponse.md)
- [BusinessCategoryQueryResponse](apple-ads-platform-api/businesscategoryqueryresponse.md)
- [Location](apple-ads-platform-api/location.md)
- [LocationResponse](apple-ads-platform-api/locationresponse.md)
- [LocationGroup](apple-ads-platform-api/locationgroup.md)
- [LocationGroupCreate](apple-ads-platform-api/locationgroupcreate.md)
- [LocationGroupUpdate](apple-ads-platform-api/locationgroupupdate.md)
- [LocationGroupResponse](apple-ads-platform-api/locationgroupresponse.md)
- [LocationGroupQueryResponse](apple-ads-platform-api/locationgroupqueryresponse.md)
- [Eligibility](apple-ads-platform-api/eligibility.md)