{"uid":"cap_Gp9t35TJfJRLbTRxjrvQH","slug":"hotel-property-details-rates-reviews-by-token-e29d8e72","name":"Hotel Property Details, Rates & Reviews by Token","description":"Hotel details & rates — one hotel's full profile by property token: address, phone, per-booking-site nightly & total rates, rooms, amenities & review breakdown as clean JSON.","url":"https://hotels.use.x402atlas.com/property","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["property_token"],"properties":{"property_token":{"type":"string","minLength":1,"description":"Property token from a /hotels/search result"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","property"],"properties":{"property":{"type":"object","required":["name"],"properties":{"link":{"type":"string","description":"The hotel's own site"},"name":{"type":"string"},"type":{"type":"string"},"phone":{"type":"string"},"images":{"type":"array","items":{"type":"object"}},"prices":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string","description":"Booking page for this offer"},"logo":{"type":"string"},"rooms":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"name":{"type":"string"},"rates":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"inclusions":{"type":"array","items":{"type":"string"}},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"free_cancellation":{"type":"boolean"},"breakfast_included":{"type":"boolean"}}}},"images":{"type":"array","items":{"type":"string"}},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}}}},"description":"Room types this source offers, with per-room and per-rate pricing"},"source":{"type":"string","description":"Booking site offering this rate"},"benefits":{"type":"string"},"official":{"type":"boolean","description":"True when the source is the property itself"},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"discount_remarks":{"type":"array","items":{"type":"string"}},"free_cancellation":{"type":"boolean"}}},"description":"All booking sources with their rates"},"address":{"type":"string"},"ratings":{"type":"array","items":{"type":"object"},"description":"Review count per star bucket"},"reviews":{"type":"integer"},"amenities":{"type":"array","items":{"type":"string"}},"directions":{"type":"string"},"phone_link":{"type":"string"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"description":{"type":"string"},"hotel_class":{"type":"string"},"photos_link":{"type":"string","description":"This API's /photos URL for the hotel"},"reviews_link":{"type":"string","description":"This API's /reviews URL for the hotel"},"check_in_time":{"type":"string"},"nearby_places":{"type":"array","items":{"type":"object"}},"other_reviews":{"type":"array","items":{"type":"object"},"description":"Third-party review sites' scores and a quoted review"},"check_out_time":{"type":"string"},"overall_rating":{"type":"number"},"property_token":{"type":"string"},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"sustainability":{"type":"object"},"featured_prices":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string","description":"Booking page for this offer"},"logo":{"type":"string"},"rooms":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"name":{"type":"string"},"rates":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"inclusions":{"type":"array","items":{"type":"string"}},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"free_cancellation":{"type":"boolean"},"breakfast_included":{"type":"boolean"}}}},"images":{"type":"array","items":{"type":"string"}},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}}}},"description":"Room types this source offers, with per-room and per-rate pricing"},"source":{"type":"string","description":"Booking site offering this rate"},"benefits":{"type":"string"},"official":{"type":"boolean","description":"True when the source is the property itself"},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"discount_remarks":{"type":"array","items":{"type":"string"}},"free_cancellation":{"type":"boolean"}}},"description":"Highlighted booking offers, with per-room rates and inclusions"},"gps_coordinates":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"location_rating":{"type":"number"},"health_and_safety":{"type":"object"},"reviews_breakdown":{"type":"array","items":{"type":"object"},"description":"Themed sentiment breakdown; each entry links back to its filtered reviews"},"amenities_detailed":{"type":"object","description":"Amenities grouped by category, plus the popular ones"},"excluded_amenities":{"type":"array","items":{"type":"string"}},"typical_price_range":{"type":"object","description":"What the property usually costs, independent of the searched dates"},"extracted_hotel_class":{"type":"integer"}}},"queried_at":{"type":"string","format":"date-time","description":"Time the lookup ran (UTC)"},"check_in_date":{"type":"string","format":"date","description":"Stay window actually priced"},"check_out_date":{"type":"string","format":"date"}}}}}}},"responseSchema":{"type":"json","example":{"property":{"link":"https://www.theanvayabali.com/","name":"The Anvaya Beach Resort Bali","type":"hotel","phone":"+62 361 2090477","prices":[{"source":"The Anvaya Beach Resort Bali","official":true,"num_guests":2,"rate_per_night":{"lowest":"$149","extracted_lowest":149}}],"address":"Jl. Kartika Plaza, Tuban, Kec. Kuta, Kabupaten Badung, Bali 80361, Indonesia","reviews":14899,"amenities":["Free breakfast","Free Wi-Fi","Free parking","Outdoor pool","Spa"],"total_rate":{"lowest":"$289","extracted_lowest":289},"hotel_class":"5-star hotel","photos_link":"https://hotels.use.x402atlas.com/photos?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE","reviews_link":"https://hotels.use.x402atlas.com/reviews?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE","check_in_time":"3:00 PM","check_out_time":"11:00 AM","overall_rating":4.7,"property_token":"ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE","rate_per_night":{"lowest":"$145","extracted_lowest":145,"before_taxes_fees":"$119","extracted_before_taxes_fees":119},"gps_coordinates":{"latitude":-8.7322397,"longitude":115.1659119},"extracted_hotel_class":5},"queried_at":"2026-07-25T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_njMd0aZDH8GJ1TLaTiFD2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a single hotel's full profile — address, phone, per-booking-site nightly and total rates, room types, amenities, and review breakdown — given a property token.","exampleAgentPrompt":"I found a hotel in the search results — can you pull up the full profile for property token 'ChIJN1t_tDeuEmsRUsoyG83frY4', including the nightly rates from all booking sites, available room types, and any free cancellation options?","exampleUseCases":[{"title":"Pre-booking hotel price comparison","prompt":"I'm looking at the Marriott in downtown Chicago — I have its property token 'ChIJabc123xyz'. Can you pull up all the booking site rates for it so I can find the cheapest deal, and flag any rooms with free cancellation?"},{"title":"Business travel itinerary enrichment","prompt":"I need the full details for our conference hotel — property token is 'ChIJdef456uvw' — including the address, phone number, and whether they have breakfast-included rooms for 2 guests."},{"title":"Vacation planning rate check","prompt":"We're planning a beach trip and narrowed it down to one hotel with token 'ChIJghi789rst'. Can you get me all the room options and nightly rates so I can compare what's available before I book?"}],"resultDescription":"A JSON object containing the hotel's name, type, address, phone, website link, images, and a list of prices broken down by booking site — each with room names, nightly rates (with and without taxes), total rates, number of guests, free cancellation flag, breakfast inclusion, and a direct booking link. May also include amenities and review score breakdown.","failureModes":["Invalid or missing property_token returns an error or empty result","Stale property token (from an old search) may yield no data if the property is no longer indexed","Sample/demo token returns a cached example response with a note warning to use real parameters","Rate data may be incomplete if upstream booking sites are temporarily unavailable","Some hotels may have limited room or rate data depending on booking site coverage"],"whenToPreferThis":"Use this endpoint when you already have a property_token from a hotel search result and need the full details — rates across booking sites, room types, amenities, and contact info — for a single specific hotel. It is the right choice for deep-dive comparisons on one property rather than broad destination searches.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:36:38.549Z","isFirstParty":false}