<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/LocationQueryResponse",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:LocationQueryResponse"
  },
  "title" : "LocationQueryResponse"
}
-->

# LocationQueryResponse

The paginated response envelope returned by the Query Locations endpoint.

```
object LocationQueryResponse
```

## Discussion

The `LocationQueryResponse` object is the top-level envelope returned by [`Query for Locations`](/documentation/Apple-Ads-Platform-API/Query-Locations). The `result` array contains [`Location`](/documentation/Apple-Ads-Platform-API/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`](/documentation/Apple-Ads-Platform-API/LocationGroup).

### Example

```json
{
  "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
  }
}
```

---

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)