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

# LocationResponse

The response object returned by the Get a Location endpoint.

```
object LocationResponse
```

## Discussion

The `LocationResponse` object is the top-level envelope returned by [`Get a Location`](/documentation/Apple-Ads-Platform-API/Get-Location-by-ID). On success, `result` contains a single [`Location`](/documentation/Apple-Ads-Platform-API/Location) object representing a physical brand location sourced from Apple Maps. On failure (for example, 404 Not Found), the response contains only the `error` object. The response omits the `result` key entirely rather than setting it to `null`.

### Example

```json
{
  "result": {
    "id": "7205759403792794",
    "name": "AwayFinder - Downtown SF",
    "brandId": "9151314442816847872",
    "status": "OPEN",
    "countryOrRegion": "US",
    "categories": [
      "travel",
      "tourism"
    ],
    "address": {
      "subThoroughfare": "123",
      "thoroughfare": "Market Street",
      "locality": "San Francisco",
      "adminArea": "California",
      "postalCode": "94105",
      "countryOrRegion": "US",
      "fullThoroughfare": "123 Market Street",
      "fullAddress": "123 Market Street, San Francisco, California 94105, US"
    },
    "displayPoint": {
      "latitude": "37.7749",
      "longitude": "-122.4194"
    },
    "creationTime": "2025-01-15T10:00:00.000",
    "modificationTime": "2026-03-20T14:45:00.000",
    "eligibility": {
      "status": "ELIGIBLE"
    }
  }
}
```

---

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)