---
title: "Multiple Locations Details"
method: GET
path: "/locations"
tags: ["Location"]
---

# Multiple Locations Details

`GET /locations`

Retrieves the full details of multiple Tripadvisor Locations in a single request.

 <p>This is the batch (multi-GET) counterpart to the single Location Details endpoint; supply a set of
 Location IDs and receive the corresponding Locations. IDs that you are not licensed to access, or that
 do not exist, are omitted from the response rather than causing the whole request to fail.

## Query parameters

- `id` integer[], required
- `locale` string[]

## Response `200`

the details for each requested Location that could be resolved

- DataResponseLocation
  - `data` Location[]
    - `accommodation` Accommodation
      - `brand` string — Hotel brand name (e.g. <code>&quot;Marriott&quot;</code>, <code>&quot;Hilton&quot;</code>).
      - `chain` string — Hotel chain affiliation (e.g. <code>&quot;Marriott International&quot;</code>).
      - `prices` Price[] — Rate ranges for the accommodation, one entry per currency.
        - `currency` string — ISO 4217 currency code for the rates (e.g. <code>&quot;USD&quot;</code>, <code>&quot;EUR&quot;</code>).
        - `max_rate` number — Maximum room rate in the specified currency.
        - `min_rate` number — Minimum room rate in the specified currency.
      - `room_count` integer — Total number of rooms at the accommodation.
      - `star_rating` integer — Official star rating of the accommodation (1–5).
    - `addresses` Address[] — Postal addresses for the Location, including a pre-formatted single-line representation per language.
      - `city` string — City or municipality name
      - `country_code` string — ISO 3166-1 alpha-2 country code (e.g., "US", "CA", "GB")
      - `country_name` string — Full country name
      - `formatted` string — Complete formatted address string
      - `language` string — Language code for the address text (e.g., "en", "es", "fr")
      - `postal_code` string — Postal or ZIP code
      - `state` string — State, province, or region name
      - `street_address` string — Primary street address line containing building number and street name
      - `street_address2` string — Secondary street address line for apartment, suite, or unit information
    - `attributes` Attribute[] — Descriptive attributes of the Location, such as amenities and features (e.g. Free Wi-Fi, Outdoor Pool).
      - `id` string — Unique identifier for the attribute
      - `name` string — Human-readable name of the attribute
      - `type` string — Type of attribute (e.g., "amenity", "feature", "service")
      - `type_id` string — Type identifier for the attribute
    - `awards` AwardV1[] — Tripadvisor awards the Location has received (e.g. Travelers' Choice).
      - `category` string — Category of the award (e.g., "restaurants", "hotels")
      - `geo` string — Geographic location where the award was received
      - `image` ImageUrl
        - `key` string — Unique identifier for the image
        - `url` string — URL to access the image
      - `name` string — Name of the award
      - `type` 'Certificate of Excellence' | 'Travelers' Choice'
      - `year` integer — Year the award was received
    - `categories` Category[] — The categories this Location is classified under, including the top-level category and parent hierarchy (e.g. Lodging &gt; Hotels).
      - `display_name` string — Human-readable display name for the category
      - `hierarchy` string — Hierarchical path of the category (e.g., "restaurants > fine_dining")
      - `id` string, required — Unique identifier for the category
      - `parent_category` ParentCategory
        - `display_name` string — Display name for the parent category
        - `id` string — Unique identifier for the parent category
        - `parent_category` object
      - `top_level_category` 'Accommodation' | 'Experience' | 'Attraction' | 'Eat & Drink'
    - `coordinates` Coordinates
      - `latitude` number, required — Geographic latitude coordinate in decimal degrees (-90 to 90)
      - `longitude` number, required — Geographic longitude coordinate in decimal degrees (-180 to 180)
    - `descriptions` Translation[], required — Editorial descriptions of the Location, provided in one or more languages.
      - `language` string, required — Language code for the translation (e.g., "en", "es", "fr")
      - `value` string, required — Translated text content in the specified language
    - `geo` string, required — Display name of the Geo that this Location belongs to (e.g. <code>&quot;Lisbon&quot;</code>).
    - `geo_id` integer, required — Identifier of the Tripadvisor Geo (e.g. city or region) that this Location belongs to.
    - `id` integer, required — Tripadvisor's unique identifier for this Location.
    - `names` TranslationWithPrimary[], required — The Location's name in one or more languages. One name per language is flagged as the primary name.
      - `language` string, required — Language code for the translation (e.g., "en", "es", "fr")
      - `primary` boolean — Indicates if this is the primary language version of the text
      - `value` string, required — Translated text content in the specified language
    - `neighborhoods` Neighborhood[] — Neighborhoods (sub-geographic areas) that the Location is part of.
      - `geo_id` string
      - `name` string
    - `official_email` string — The Location's official contact email address, when available.
    - `opening_hours` OpeningHours
      - `formatted` string[] — Human-readable formatted opening hours strings
      - `periods` Period[] — List of opening hours periods for different days of the week
        - `closes` string — Closing time in HH:MM format (24-hour)
        - `day_of_week` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday'
        - `opens` string — Opening time in HH:MM format (24-hour)
      - `timezone` string — Timezone identifier for the opening hours (e.g., "America/New_York")
    - `phone_numbers` PhoneNumber[] — Contact phone numbers for the Location, each tagged with its type (e.g. phone, fax).
      - `type` string, required — Type of phone number (e.g., "main", "fax", "mobile", "toll-free") <p> One of: <ul> <li>phone</li> </ul>
      - `value` string, required — The phone number value in international format (e.g., "+1-555-123-4567")
    - `photos` LocationPhotoInfo, required
      - `total_count` integer
    - `price_level` string — Indicative price level for the Location, applicable to restaurants. One of: <ul> <li>Cheap Eats</li> <li>Fine Dining</li> <li>Mid Range</li> </ul>
    - `rankings` RankingV1[] — The Location's rank within its Geo and category (e.g. "#23 of 500 Hotels in Lisbon").
      - `category` string — Category name for the ranking
      - `category_id` string — Category ID for the ranking
      - `display_text` string — Human-readable display text for the ranking
      - `geo` string — Geographic location name where the ranking applies
      - `geo_id` integer — Geographic ID where the ranking applies
      - `rank` integer — Current rank position (1-based)
      - `total` integer — Total number of items in the ranking category
    - `recommended_visit_length` integer — Coded indicator of the suggested length of a visit to the Location: <ul> <li>0 — unknown / not set</li> <li>1 — under 1 hour</li> <li>2 — 1–2 hours</li> <li>3 — 2–3 hours</li> <li>4 — over 3 hours</li> </ul>
    - `status` Status, required
      - `closed_date` string — Date when the location was closed
      - `reopen_date` string — Date when the location is scheduled to reopen
      - `value` 'OPEN' | 'CLOSED' | 'TEMPORARILY_CLOSED', required
    - `traveler_ratings` TravelerRatings — Aggregated traveler rating information for a Location, summarizing all of its reviews.
      - `breakdowns` Breakdown[] — Distribution of reviews across each rating value (e.g. how many reviews rated the Location 5, 4, 3).
        - `count` integer
        - `rating` integer
        - `rating_name` string
      - `language_counts` LanguageCount[] — Number of reviews available for the Location per language.
        - `count` integer
        - `language` string
      - `overall` Overall
        - `count` integer — Total number of reviews contributing to this rating
        - `icon_url` string — URL to the rating icon/image
        - `rating` number — Overall rating score (typically 1.0 to 5.0)
      - `subratings` SubRating[] — Average ratings broken down by aspect (e.g. service, cleanliness, value).
        - `count` integer
        - `icon_url` string
        - `rating` number
        - `type` string
        - `type_name` string
    - `urls` Urls
      - `android_intent` string
      - `menu` string
      - `official` string
      - `tripadvisor` Tripadvisor
        - `main` string
        - `photos` string
        - `questions_answers` string
        - `write_review` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/tripadvisor/apis/partner-api.md) · [All operations](https://skmtc.dev/tripadvisor/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tripadvisor/partner-api/revisions/b42bdf9fd6a5/schema)
