Get a Location
Retrieve a single business location by its unique identifier.
URL
GET https://api.ads.apple.com/v1/locations/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string |
Header Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | LocationResponse | |
| 400 | Bad Request Content-Type: application/json | Error | |
| 401 | Unauthorized Content-Type: application/json | Error | |
| 403 | Forbidden Content-Type: application/json | Error | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Too Many Requests Content-Type: application/json | Error | |
| 500 | Internal Server Error Content-Type: application/json | Error |
Discussion
This endpoint retrieves the full details of a specific business location registered in Apple Ads. The response includes the location’s address, geographic coordinates, business categories, and current status.
To verify location details before adding a location to a group, or to inspect the current status of a known location, use this endpoint.
The location’s status field can be one of the following:
Status | Description |
|---|---|
| The location is open and eligible for targeting in Apple Maps campaigns. |
| The location has permanently closed. |
| The location has relocated. A new location record reflects the current address. |
| The location is temporarily unavailable. |
| The location is not yet open but will open soon. |
Retrieving a location’s details is subject to brand ownership and status limitations:
Constraint | Detail |
|---|---|
Brand ownership | You can only retrieve locations belonging to brands accessible to your ad account. |
Open locations only | Only locations with |