Get Location Resource by ID

API Description

Get information about a specific location resource, including resource state. Supply the unique Apple-generated location ID assigned to the partner’s description of a location, and the service will return the corresponding resource.

note

Service does not return "soft" deleted resources. Refer to the Get service

Request

URI Parameters

Name	Input
orgId
locationId

Path Template

GET {url}/api/{version}/orgs/{orgId}/locations/{locationId}

Path Example

GET {url}/api/v1/orgs/9467895078742654934/locations/9467895078742654976

Request Headers

Name	Input
Authorization
Accept

Example Request Headers

Authorization: Bearer <access_token>
Accept: application/json

Request Body

None

Response

200 OK or Error

Response Headers

Name
apple-request-id
content-type
etag

Example Response Headers

HTTP/1.1 200 OK
apple-request-id: 27753bac-a682-4119-9c80-e17312e13b8c
content-type: application/json
etag: "9a37da78-ddd2-11ec-b327-a33f2f0dc19a"

Response Body

Refer to create operation's response body for property descriptions.

Example Response Body (raw JSON)

{
  "orgId": "9467895078742654934",
  "id": "9467895078742654976",
  "createdDate": "2026-10-10T17:22:19.00Z",
  "updatedDate": "2026-10-10T17:22:19.00Z",
  "state": "SUBMITTED",
  "etag": "9a37da78-ddd2-11ec-b327-a33f2f0dc19a",
  "placeCardUrl": "https://maps.apple.com/place?auid=7378763904743701440",
  "locationDetails": {
    "partnersLocationId": "1212121212",
    "partnersLocationVersion": "PV01",
    "brandId": "9467895078742654946",
    "displayNames": [
      {
        "name": "Malibu Ice Cream",
        "locale": "en-US",
        "primary": true
      }
    ],
    "storeCode": "#123",
    "internalNicknames": [
      {
        "name": "9th Ave & West 15th",
        "locale": "en"
      }
    ],
    "mainAddress": {
      "structuredAddress": {
        "floor": "7th floor",
        "thoroughfare": "9th Ave",
        "subThoroughfare": "75",
        "fullThoroughfare": "75 9th Ave",
        "subLocality": "pos. Lesnoe",
        "locality": "New York",
        "administrativeArea": "New York",
        "postCode": "10011",
        "countryCode": "US"
      },
      "locale": "en"
    },
    "urls": [
      {
        "url": "http://example.com",
        "type": "HOMEPAGE"
      }
    ],
    "locationDescriptions": [
      {
        "type": "ABOUT",
        "descriptions": [
          {
            "text": "Established in 1984, Malibu Ice Cream handcrafts artisan super premium ice creams, dairy-free fruit juices and frozen yogurt! We are the home of world famous Mexican Vanilla Ice Cream. Explore your favorite flavors at Malibu IceCream.",
            "locale": "en"
          }
        ]
      }
    ],
    "openingHoursByDay": [
      {
        "day": "MONDAY",
        "times": [
          {
            "startTime": "10:00",
            "endTime": "22:00"
          }
        ]
      },
      {
        "day": "TUESDAY",
        "times": [
          {
            "startTime": "10:00",
            "endTime": "22:00"
          }
        ]
      },
      {
        "day": "WEDNESDAY",
        "times": [
          {
            "startTime": "10:00",
            "endTime": "22:00"
          }
        ]
      },
      {
        "day": "THURSDAY",
        "times": [
          {
            "startTime": "10:00",
            "endTime": "22:00"
          }
        ]
      },
      {
        "day": "FRIDAY",
        "times": [
          {
            "startTime": "10:00",
            "endTime": "22:00"
          }
        ]
      },
      {
        "day": "SATURDAY",
        "times": [
          {
            "startTime": "09:00",
            "endTime": "23:30"
          }
        ]
      }
    ],
    "specialHours": [
      {
        "hoursByDay": [
          {
            "day": "SUNDAY",
            "times": [
              {
                "startTime": "09:00",
                "endTime": "12:00"
              }
            ]
          }
        ],
        "startDate": "2026-12-25",
        "endDate": "2026-12-25",
        "closed": false,
        "descriptions": [
          {
            "text": "Early Closing Christmas Day",
            "locale": "en-US"
          },
          {
            "text": "Día de Navidad de cierre anticipado",
            "locale": "es"
          }
        ]
      }
    ],
    "categories": [
      "dining.dessert_shop.ice_cream_shop",
      "dining.dessert_shop.ice_cream_shop.gelato_shop"
    ],
    "locationAttributes": [
      {
        "name": "crossbusiness.restrooms.gender_neutral_restroom",
        "value": "true"
      }
    ],
    "paymentMethods": [
      "VISA",
      "MASTERCARD"
    ],
    "displayPoint": {
      "coordinates": {
        "latitude": "52.358834",
        "longitude": "4.893834"
      },
      "source": "MANUALLY_PLACED"
    },
    "phoneNumbers": [
      {
        "phoneNumber": "+12225551212",
        "type": "LANDLINE",
        "primary": true
      }
    ],
    "locationStatus": {
      "status": "OPEN"
    },
    "callToAction": "MENU",
    "actionLinkDetails": {
      "quicklinks": [
        {
          "category": "quicklinks.restaurant_order_food",
          "quicklinkUrl": "https://www.yelp.com/menu/malibuiscream",
          "appStoreUrl": "https://apps.apple.com/us/app/yelp-food-delivery-reviews/id284910350",
          "relationship": "AUTHORIZED"
        }
      ]
    }
  },
  "metadata": []
}