Get hotel information

POST /v1/hotels/get · MCP tool: get_hotel

Get information about one hotel by HotelUse ID: address, photos, facilities, policies and source metadata. No live rates. Each newly read hotel version costs $0.005 after signup credits; repeat reads of the same version are free.

Run this tool on HotelUse · Download full captured response

Information for one hotel

Pass a HotelUse hu_… ID returned by search_hotels. The response contains data.hotel with address, photos, facilities, descriptions, policies and source metadata. No stay dates or live price request are needed. Use the same ID with get_room_rates to explore room options.

Each newly read hotel version uses one hotel information unit. Repeat reads of the same version are free.

Filters & sorting: complete field reference

Request fields

Field	Required	Type	Details
`hotel_id`	Required	string	See request and field notes below
`billing`	Optional	object	Maximum new units authorized for this call
`include`	Optional	array	See request and field notes below

Request example

This static request does not require stay dates or occupancy. Use a fresh Idempotency-Key per intended operation; keep it for retries.

bash

curl 'https://www.hoteluse.dev/v1/hotels/get' \
  -H "Authorization: Bearer $HOTELUSE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: replace-with-a-unique-operation-id' \
  --data '{
  "hotel_id": "hu_69450c903d9c06226f1ce17b",
  "billing": {
    "max_units": 1
  }
}'

Captured response

Captured 2026-10-21 17:50:47 UTC. The preview below is abridged for reading: arrays and static records can be shortened or selected. The downloadable JSON preserves the full captured transport page. Only request/session/billing identifiers and cursors are redacted. Historical sessions cannot be resumed.

json

{
  "schema_version": "1.0",
  "request_id": "req_documentation_capture",
  "data": {
    "hotel": {
      "hotel_id": "hu_69450c903d9c06226f1ce17b",
      "name": "Hilton Bellevue",
      "address": {
        "address": "300 112th Ave SE",
        "city": "Bellevue (WA)",
        "state": "Washington",
        "country": "US",
        "postalCode": "98004"
      },
      "giata_id": "65307",
      "geo": {
        "longitude": -122.18915,
        "latitude": 47.60723
      },
      "star_rating": 4,
      "timezone": "America/Los_Angeles",
      "provider_records": [
        {
          "connection": "tgx",
          "provider": "abreu",
          "external_hotel_id": "2529194"
        },
        {
          "connection": "tgx",
          "provider": "hotelbeds",
          "external_hotel_id": "131339"
        },
        {
          "connection": "tgx",
          "provider": "w2m",
          "external_hotel_id": "JP047245"
        },
        {
          "connection": "tgx",
          "provider": "hprotravel",
          "external_hotel_id": "11069c"
        },
        {
          "connection": "tgx",
          "provider": "tbo",
          "external_hotel_id": "1096022"
        },
        {
          "connection": "tgx",
          "provider": "priceline",
          "external_hotel_id": "59c1c29f-77ac-5db1-ae08-67d7b6639582"
        },
        {
          "connection": "tgx",
          "provider": "expedia_eps",
          "external_hotel_id": "4497"
        },
        {
          "connection": "metasearch",
          "provider": "agoda",
          "external_hotel_id": "166523"
        },
        {
          "connection": "metasearch",
          "provider": "expedia",
          "external_hotel_id": "4497"
        },
        {
          "connection": "metasearch",
          "provider": "hotels.com",
          "external_hotel_id": "4497"
        },
        {
          "connection": "tgx",
          "provider": "rakuten",
          "external_hotel_id": "3H9L"
        },
        {
          "connection": "tgx",
          "provider": "restel",
          "external_hotel_id": "809596"
        },
        {
          "connection": "tgx",
          "provider": "price_travel",
          "external_hotel_id": "120318"
        },
        {
          "connection": "tgx",
          "provider": "goglobal",
          "external_hotel_id": "143194"
        },
        {
          "connection": "tgx",
          "provider": "webbeds",
          "external_hotel_id": "146946"
        },
        {
          "connection": "tgx",
          "provider": "ratehawk",
          "external_hotel_id": "7441551"
        },
        {
          "connection": "metasearch",
          "provider": "booking.com",
          "external_hotel_id": "180673"
        }
      ],
      "source_updated_at": "2026-10-06T11:08:12.169Z",
      "record_version": "2026-10-06T21:43:17.002Z"
    }
  },
  "usage": {
    "hotel_record_units": 0,
    "search_calls": 0,
    "room_calls": 0,
    "trial_units_used": 0,
    "paid_units": 0,
    "paid_usd": "0.000",
    "unit_price_usd": "0.005",
    "billing_receipt_id": "bill_documentation_capture",
    "replayed": false
  }
}

Field	Meaning
`schema_version`	Current response schema, `1.0`.
`request_id`	Include this value when reporting an issue.
`data.hotel`	One static hotel record with provider ID mappings, source timestamps and a record version.
`usage`	Actual units, signup units used, paid units and USD charged for this response.

Hotel record fields

include accepts provider_records and provenance. The current response already includes the full public record; these flags do not expose private supplier fields.

Field	Meaning
`hotel_id`	Stable HotelUse identifier for subsequent rate calls.
`giata_id`	GIATA identity where present, otherwise null.
`provider_records[]`	Connection, provider and external_hotel_id; no supplier credentials.
`source_updated_at`	Reported source refresh timestamp, or null if unavailable.
`record_version`	Version used for repeat-read billing.
`address`, `geo`, `star_rating`, `amenities`, `images`, `descriptions`, `timezone`	Normalized static data. Source values can be missing or null.

Pagination

This operation returns one record and has no result pages.

Pricing and limits · Errors and retries.