> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valpashotels.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get hotel by ID

> Returns a single hotel by its unique identifier.



## OpenAPI

````yaml /openapi.json get /hotels/{id}
openapi: 3.1.0
info:
  title: Valpas Public API
  description: Hotel data for external developers
  version: 1.0.0
servers:
  - url: https://connect.valpashotels.com
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /hotels/{id}:
    get:
      summary: Get hotel by ID
      description: Returns a single hotel by its unique identifier.
      operationId: getHotel
      parameters:
        - name: id
          in: path
          required: true
          description: Unique hotel identifier
          schema:
            type: string
            example: 00391351-e308-4aae-8b66-d868ebb37ff3
      responses:
        '200':
          description: Hotel found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Hotel'
              example:
                id: 00391351-e308-4aae-8b66-d868ebb37ff3
                name: Paris Marriott Rive Gauche Hotel & Conference Center
                description: >-
                  Surrounded by diverse attractions, Paris Marriott Rive Gauche
                  Hotel is a stylish haven in an iconic travel destination.
                address: 17 Boulevard Saint Jacques, 75014 Paris France
                latitude: 48.831917
                longitude: 2.340172
                language: null
                room_count: null
                images:
                  - url: >-
                      https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg
                    caption: Great Room Lobby
                  - url: >-
                      https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/2.jpg
                    caption: Palyma Bar
                  - url: >-
                      https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/3.jpg
                    caption: Brasserie Restaurant
                certified: true
                certified_from: null
                certified_until: null
                certification_url: https://valpashotels.com
                netstorming_id: '45373'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Unauthorized
        '404':
          description: Hotel not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Hotel not found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal server error
components:
  schemas:
    Hotel:
      type: object
      required:
        - id
        - name
        - description
        - language
        - images
        - certified
        - certified_from
        - certified_until
        - certification_url
        - netstorming_id
      properties:
        id:
          type: string
          description: Unique hotel identifier
          example: 00391351-e308-4aae-8b66-d868ebb37ff3
        name:
          type: string
          description: Hotel name
          example: Grand Helsinki Hotel
        description:
          type:
            - string
            - 'null'
          description: Marketing description of the hotel (null if not available)
          example: >-
            A refined stay in the heart of Helsinki, steps from the central
            railway station.
        address:
          type:
            - string
            - 'null'
          description: Street address of the hotel
          example: Mannerheimintie 1, 00100 Helsinki
        latitude:
          type:
            - number
            - 'null'
          description: Geographic latitude in decimal degrees
          example: 60.1699
        longitude:
          type:
            - number
            - 'null'
          description: Geographic longitude in decimal degrees
          example: 24.9384
        language:
          type:
            - string
            - 'null'
          description: Primary language at the hotel (ISO 639-1 code)
          example: fi
        room_count:
          type:
            - integer
            - 'null'
          description: Total number of rooms (null if not configured)
          example: 85
        images:
          type: array
          description: >-
            Hotel photos (up to 3), served from the Valpas CDN. Empty array if
            no photos are available.
          items:
            type: object
            required:
              - url
              - caption
            properties:
              url:
                type: string
                format: uri
                description: Publicly accessible image URL
              caption:
                type:
                  - string
                  - 'null'
                description: Short image caption (null if not available)
          example:
            - url: >-
                https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg
              caption: Great Room Lobby
        certified:
          type: boolean
          description: Whether the hotel holds a current Valpas certification
          example: true
        certified_from:
          type:
            - string
            - 'null'
          format: date
          description: >-
            Date when the hotel's Valpas certification becomes valid
            (YYYY-MM-DD)
          example: '2026-01-15'
        certified_until:
          type:
            - string
            - 'null'
          format: date
          description: Date when the hotel's Valpas certification expires (YYYY-MM-DD)
          example: '2026-03-30'
        certification_url:
          type:
            - string
            - 'null'
          format: uri
          description: >-
            Link target for the Valpas certification badge (null when the hotel
            is not certified)
          example: https://valpashotels.com
        netstorming_id:
          type:
            - string
            - 'null'
          description: Netstorming integration identifier
          example: '45373'
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message
          example: Unauthorized
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````