> ## Documentation Index > Fetch the complete documentation index at: https://docs.sanfoundation.com/llms.txt > Use this file to discover all available pages before exploring further. # Get hotel details > Retrieve property information and available rates for a stay. Use an `id` from [hotel search](https://docs.sanfoundation.com/api-reference/hotels-search.md). Supply both `check_in` and `check_out` to request rates. Without dates, the response omits `booking_options`. Compare offers for the same stay and currency. Rates and seller links can be absent. `rate_per_night` and `total_rate` contain numeric `amount` and formatted `display` values. ## OpenAPI ````yaml https://api.sanfoundation.com/openapi.json GET /v1/hotels/{id} openapi: 3.0.0 info: title: SAN API description: >- Web data and context for agents, served by a network of miners running real browsers on residential connections. One resource per thing an agent asks for: search the web, read the news, find places, hotels and flights, and quote a symbol. Present an API key as `Authorization: Bearer san_...`. Every response is snake_case JSON and every error is `{ error: { code, message, param } }`. version: 0.0.1 contact: {} servers: [] security: [] tags: - name: web description: Web search - name: news description: News search - name: places description: Places search - name: hotels description: Stays search - name: flights description: Flight search - name: finance description: Quotes and charts - name: shopping description: Products and sellers - name: account description: Plan and remaining budget paths: /v1/hotels/{id}: get: tags: - hotels summary: One property in full description: >- Everything the listing leaves out for one property: address, site, description, check-in and check-out times, the full amenity list and who is offering the stay. Takes the `id` a hotels search returned. Give the dates to get rates: without them no prices are quoted, because every rate is a function of the stay. operationId: HotelsController_details parameters: - name: id required: true in: path description: The `id` of a property from a hotels search. schema: type: string example: san1.QkFEQ0FGRTAxMjM0NTY3ODk - name: country required: false in: query description: ISO 3166-1 alpha-2. Defaults to `us`. schema: type: string example: us - name: currency required: false in: query description: ISO 4217. Defaults to the currency of `country`. schema: type: string example: USD - name: check_out required: false in: query description: YYYY-MM-DD. 1 to 30 nights after `check_in`. schema: type: string example: '2026-10-18' - name: check_in required: false in: query description: YYYY-MM-DD. Not in the past. Required with `check_out`. schema: type: string example: '2026-10-15' responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/HotelDetailsResponseDto' '400': description: A parameter is missing, invalid or not recognized. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '401': description: Invalid API key. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '404': description: The id is not one this API issued. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '429': description: Monthly quota exhausted. Hard stop, no overage. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '503': description: No miner and no fallback could serve the request. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' security: - api_key: [] - x-api-key: [] components: schemas: HotelDetailsResponseDto: type: object properties: id: type: string format: uuid description: Id of this request. Quote it when reporting a problem. took_ms: type: number example: 1420 description: How long the request took, in milliseconds. request: additionalProperties: true description: >- The parameters as accepted, after defaults and normalization. What the request actually ran with. example: id: san1.QkFEQ0FGRTAxMjM0NTY3ODk check_in: '2026-10-15' check_out: '2026-10-18' currency: USD country: us allOf: - $ref: '#/components/schemas/HotelDetailsRequestEchoDto' hotel: $ref: '#/components/schemas/HotelDetailDto' required: - id - took_ms - request - hotel PublicErrorDto: type: object properties: error: $ref: '#/components/schemas/PublicErrorBodyDto' required: - error HotelDetailsRequestEchoDto: type: object properties: id: type: string example: san1.QkFEQ0FGRTAxMjM0NTY3ODk check_in: type: string example: '2026-10-15' check_out: type: string example: '2026-10-18' currency: type: string example: USD country: type: string example: us required: - id - currency - country HotelDetailDto: type: object properties: name: type: string example: Park Hotel Tokyo type: type: string enum: - hotel - vacation_rental example: hotel stars: type: number example: 4 description: Star class, 1 to 5. rating: type: number example: 4.3 reviews: type: number example: 2841 address: type: string example: 1-7-1 Higashi-Shimbashi, Minato City, Tokyo phone: type: string example: +81 3-6252-1111 description: 'Rarely listed: most property pages give a site and no number.' website: type: string example: https://example.com/tokyo/ description: The property's own site. description: type: string example: A high-rise hotel with city views, 5 minutes from the station. check_in_time: type: string example: '15:00' description: 24 hour HH:MM. check_out_time: type: string example: '11:00' description: 24 hour HH:MM. amenities: example: - Pool - Wi-Fi (free) - Breakfast (extra charge) description: Each with the page's own qualifier where it states one. type: array items: type: string booking_options: description: >- Who is offering the stay, and for how much. Present only when `check_in` and `check_out` were given: every rate is a function of the dates. type: array items: $ref: '#/components/schemas/BookingOptionDto' rating_breakdown: description: Share of reviews at each star rating, highest first. type: array items: $ref: '#/components/schemas/RatingBucketDto' required: - name PublicErrorBodyDto: type: object properties: code: type: string enum: - unauthorized - missing_parameter - invalid_parameter - not_found - quota_exceeded - rate_limited - unavailable - expired - internal_error example: missing_parameter message: type: string example: Missing parameter `query`. param: type: string example: query description: The parameter at fault, when one parameter is at fault. required: - code - message BookingOptionDto: type: object properties: provider: type: string example: Somewhere Travel rate_per_night: $ref: '#/components/schemas/MoneyDto' total_rate: description: Total for the stay. allOf: - $ref: '#/components/schemas/MoneyDto' link: type: string example: https://example.com/book/asakusa-view?checkin=2026-10-15 description: >- The partner's own booking URL. Absent when the listing carried no destination that could be handed on. required: - provider RatingBucketDto: type: object properties: stars: type: number example: 5 description: 1 to 5. percent: type: number example: 47 description: Whole percent of all reviews at this star rating. required: - stars - percent MoneyDto: type: object properties: amount: type: number example: 180 description: The amount as a number. display: type: string example: $180 description: The same amount as displayed, with its currency. required: - amount - display securitySchemes: api_key: scheme: bearer bearerFormat: JWT type: http description: 'Public API key: `Authorization: Bearer san_...`.' x-api-key: type: apiKey in: header name: X-Api-Key description: The same public API key, as a header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.