Hotel Content API

openapi: 3.0.3
info:
  title: Amadeus Hotel Content API
  version: 1.0.0
  description: >-
    The Amadeus Hotel Content API provides detailed property information for
    hotels in the Amadeus inventory, including property descriptions, amenities,
    facilities, contact details, and media assets such as images and multimedia
    content. This Enterprise API enables travel platforms to build rich hotel
    profiles with photos, room images, and comprehensive property descriptions.

    Before using this API, obtain an access token. See the Authorization Guide
    for details.
  contact:
    name: Amadeus for Developers
    url: https://developers.amadeus.com/support
  license:
    name: Amadeus Terms and Conditions
    url: https://developers.amadeus.com/legal/terms-and-conditions
  x-generated-from: documentation
servers:
- url: https://api.amadeus.com/v1
  description: Production server
- url: https://test.api.amadeus.com/v1
  description: Test server
security:
- BearerAuth: []
paths:
  /reference-data/locations/hotels/by-hotels/content:
    get:
      operationId: getHotelContent
      summary: Amadeus Get Hotel Content
      description: >-
        Returns detailed content for one or more hotels including property
        descriptions, amenities, facilities, contact information, geolocation,
        and media assets such as images and videos. Provide one or more hotel
        IDs (Amadeus property codes) to retrieve their content.
      tags:
      - Hotel Content
      parameters:
      - name: hotelIds
        in: query
        required: true
        description: >-
          Amadeus property codes (8 characters) for which to retrieve content.
          Up to 20 hotel IDs can be specified per request.
        schema:
          type: array
          items:
            type: string
          minItems: 1
          maxItems: 20
          example:
          - MCLONGHM
        style: form
        explode: false
      - name: language
        in: query
        required: false
        description: >-
          Language code for the content response (e.g., EN, FR, DE). Defaults
          to English if not specified.
        schema:
          type: string
          example: EN
      - name: fields
        in: query
        required: false
        description: >-
          Comma-separated list of content fields to include in the response.
          Options include: basicInfo, descriptions, amenities, media,
          contact, location.
        schema:
          type: string
          example: basicInfo,descriptions,media,amenities
      responses:
        '200':
          description: Successful response with hotel content data.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/HotelContentResponse'
              examples:
                GetHotelContent200Example:
                  summary: Default getHotelContent 200 response
                  x-microcks-default: true
                  value:
                    data:
                    - hotelId: MCLONGHM
                      chainCode: MC
                      iataCode: LON
                      name: THE LONGCHAMP HOTEL
                      basicInfo:
                        category: 4
                        rating: FOUR_STARS
                        numberOfRooms: 120
                        checkInTime: '14:00'
                        checkOutTime: '12:00'
                      descriptions:
                      - lang: EN
                        text: >-
                          A luxury boutique hotel in the heart of London,
                          offering stunning views and exceptional service.
                      contact:
                        phone: '+44-20-12345678'
                        email: info@thelongchamp.com
                        website: https://www.thelongchamp.com
                      address:
                        lines:
                        - 15 Park Lane
                        postalCode: W1K 1BE
                        cityName: London
                        countryCode: GB
                      geoCode:
                        latitude: 51.508
                        longitude: -0.145
                      amenities:
                      - WIFI
                      - RESTAURANT
                      - SPA
                      - GYM
                      - PARKING
                      media:
                      - category: EXTERIOR
                        uri: https://media.amadeus.com/hotels/MCLONGHM/exterior-01.jpg
                        caption: Hotel Exterior
                      - category: LOBBY
                        uri: https://media.amadeus.com/hotels/MCLONGHM/lobby-01.jpg
                        caption: Grand Lobby
                      - category: ROOM
                        uri: https://media.amadeus.com/hotels/MCLONGHM/room-deluxe-01.jpg
                        caption: Deluxe Room
                    meta:
                      count: 1
                      links:
                        self: https://api.amadeus.com/v1/reference-data/locations/hotels/by-hotels/content?hotelIds=MCLONGHM
        '400':
          description: Bad request. Invalid parameters.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                GetHotelContent400Example:
                  summary: Default getHotelContent 400 response
                  x-microcks-default: true
                  value:
                    errors:
                    - status: 400
                      code: 477
                      title: INVALID FORMAT
                      detail: >-
                        Invalid value for parameter hotelIds. Must be 8-character
                        Amadeus property codes.
        '401':
          description: Unauthorized. Access token missing or invalid.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found. No hotels found for the given IDs.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /reference-data/locations/hotels/by-hotels/media:
    get:
      operationId: getHotelMedia
      summary: Amadeus Get Hotel Media
      description: >-
        Returns media assets (images, videos) for one or more hotels in the
        Amadeus inventory. Media includes exterior shots, lobby photos, room
        images, restaurant photos, and amenity images categorized by type.
      tags:
      - Hotel Media
      parameters:
      - name: hotelIds
        in: query
        required: true
        description: >-
          Amadeus property codes (8 characters). Up to 20 hotel IDs per
          request.
        schema:
          type: array
          items:
            type: string
          minItems: 1
          maxItems: 20
          example:
          - MCLONGHM
        style: form
        explode: false
      - name: category
        in: query
        required: false
        description: >-
          Filter media by category. Options: EXTERIOR, LOBBY, ROOM,
          RESTAURANT, POOL, SPA, GYM, MEETING_ROOM, COMMON_AREA.
        schema:
          type: string
          enum:
          - EXTERIOR
          - LOBBY
          - ROOM
          - RESTAURANT
          - POOL
          - SPA
          - GYM
          - MEETING_ROOM
          - COMMON_AREA
          example: EXTERIOR
      - name: format
        in: query
        required: false
        description: >-
          Preferred image format. Options: JPEG, PNG, WEBP.
        schema:
          type: string
          enum:
          - JPEG
          - PNG
          - WEBP
          example: JPEG
      responses:
        '200':
          description: Successful response with hotel media assets.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/HotelMediaResponse'
              examples:
                GetHotelMedia200Example:
                  summary: Default getHotelMedia 200 response
                  x-microcks-default: true
                  value:
                    data:
                    - hotelId: MCLONGHM
                      media:
                      - id: media-001
                        category: EXTERIOR
                        uri: https://media.amadeus.com/hotels/MCLONGHM/exterior-01.jpg
                        thumbnailUri: https://media.amadeus.com/hotels/MCLONGHM/exterior-01-thumb.jpg
                        caption: Hotel Exterior
                        width: 1920
                        height: 1080
                        format: JPEG
                        isPrimary: true
                      - id: media-002
                        category: ROOM
                        uri: https://media.amadeus.com/hotels/MCLONGHM/room-deluxe-01.jpg
                        thumbnailUri: https://media.amadeus.com/hotels/MCLONGHM/room-deluxe-01-thumb.jpg
                        caption: Deluxe Double Room
                        width: 1920
                        height: 1080
                        format: JPEG
                        isPrimary: false
                    meta:
                      count: 1
                      links:
                        self: https://api.amadeus.com/v1/reference-data/locations/hotels/by-hotels/media?hotelIds=MCLONGHM
        '400':
          description: Bad request.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                GetHotelMedia400Example:
                  summary: Default getHotelMedia 400 response
                  x-microcks-default: true
                  value:
                    errors:
                    - status: 400
                      code: 477
                      title: INVALID FORMAT
                      detail: Invalid value for parameter hotelIds.
        '401':
          description: Unauthorized.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        OAuth2 Bearer token. Obtain a token using the Amadeus Authorization API
        at https://test.api.amadeus.com/v1/security/oauth2/token.
  schemas:
    HotelContentResponse:
      type: object
      description: Response containing hotel content data for one or more hotels.
      properties:
        data:
          type: array
          description: Array of hotel content objects.
          items:
            $ref: '#/components/schemas/HotelContent'
        meta:
          $ref: '#/components/schemas/Meta'
    HotelContent:
      type: object
      description: Detailed content for a single hotel property.
      properties:
        hotelId:
          type: string
          description: Amadeus property code (8 characters).
          example: MCLONGHM
        chainCode:
          type: string
          description: Hotel chain code.
          example: MC
        iataCode:
          type: string
          description: IATA city code where the hotel is located.
          example: LON
        name:
          type: string
          description: Hotel name.
          example: THE LONGCHAMP HOTEL
        basicInfo:
          $ref: '#/components/schemas/HotelBasicInfo'
        descriptions:
          type: array
          description: Hotel descriptions in various languages.
          items:
            $ref: '#/components/schemas/HotelDescription'
        contact:
          $ref: '#/components/schemas/HotelContact'
        address:
          $ref: '#/components/schemas/HotelAddress'
        geoCode:
          $ref: '#/components/schemas/GeoCode'
        amenities:
          type: array
          description: List of hotel amenity codes.
          items:
            type: string
          example:
          - WIFI
          - RESTAURANT
          - SPA
        media:
          type: array
          description: List of hotel media assets.
          items:
            $ref: '#/components/schemas/MediaAsset'
    HotelBasicInfo:
      type: object
      description: Basic hotel classification information.
      properties:
        category:
          type: integer
          description: Hotel star category (1-5).
          example: 4
        rating:
          type: string
          description: Hotel rating classification.
          example: FOUR_STARS
        numberOfRooms:
          type: integer
          description: Total number of rooms in the property.
          example: 120
        checkInTime:
          type: string
          description: Standard check-in time (HH:MM format).
          example: '14:00'
        checkOutTime:
          type: string
          description: Standard check-out time (HH:MM format).
          example: '12:00'
    HotelDescription:
      type: object
      description: Hotel description in a specific language.
      properties:
        lang:
          type: string
          description: ISO 639-1 language code.
          example: EN
        text:
          type: string
          description: Hotel description text.
          example: >-
            A luxury boutique hotel offering exceptional service and stunning
            city views.
    HotelContact:
      type: object
      description: Hotel contact information.
      properties:
        phone:
          type: string
          description: Hotel phone number in international format.
          example: '+44-20-12345678'
        fax:
          type: string
          description: Hotel fax number.
          example: '+44-20-12345679'
        email:
          type: string
          format: email
          description: Hotel email address.
          example: info@hotel.com
        website:
          type: string
          format: uri
          description: Hotel website URL.
          example: https://www.hotel.com
    HotelAddress:
      type: object
      description: Hotel physical address.
      properties:
        lines:
          type: array
          description: Street address lines.
          items:
            type: string
          example:
          - 15 Park Lane
        postalCode:
          type: string
          description: Postal or ZIP code.
          example: W1K 1BE
        cityName:
          type: string
          description: City name.
          example: London
        countryCode:
          type: string
          description: ISO 3166-1 alpha-2 country code.
          example: GB
        stateCode:
          type: string
          description: State or province code (where applicable).
          example: ENG
    GeoCode:
      type: object
      description: Geographic coordinates of the hotel.
      properties:
        latitude:
          type: number
          format: double
          description: Latitude in decimal degrees.
          example: 51.508
        longitude:
          type: number
          format: double
          description: Longitude in decimal degrees.
          example: -0.145
    MediaAsset:
      type: object
      description: A single media asset (image or video) for a hotel property.
      properties:
        category:
          type: string
          description: Media category.
          enum:
          - EXTERIOR
          - LOBBY
          - ROOM
          - RESTAURANT
          - POOL
          - SPA
          - GYM
          - MEETING_ROOM
          - COMMON_AREA
          example: EXTERIOR
        uri:
          type: string
          format: uri
          description: URL of the full-size media asset.
          example: https://media.amadeus.com/hotels/MCLONGHM/exterior-01.jpg
        caption:
          type: string
          description: Caption or alt text for the media asset.
          example: Hotel Exterior
    HotelMediaResponse:
      type: object
      description: Response containing media assets for one or more hotels.
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/HotelMediaData'
        meta:
          $ref: '#/components/schemas/Meta'
    HotelMediaData:
      type: object
      description: Media assets for a single hotel.
      properties:
        hotelId:
          type: string
          description: Amadeus property code.
          example: MCLONGHM
        media:
          type: array
          description: List of media assets for the hotel.
          items:
            $ref: '#/components/schemas/HotelMediaItem'
    HotelMediaItem:
      type: object
      description: A detailed media item with dimensions and format information.
      properties:
        id:
          type: string
          description: Unique identifier for the media item.
          example: media-001
        category:
          type: string
          description: Media category type.
          example: EXTERIOR
        uri:
          type: string
          format: uri
          description: URL of the full-size image.
          example: https://media.amadeus.com/hotels/MCLONGHM/exterior-01.jpg
        thumbnailUri:
          type: string
          format: uri
          description: URL of the thumbnail image.
          example: https://media.amadeus.com/hotels/MCLONGHM/exterior-01-thumb.jpg
        caption:
          type: string
          description: Image caption or alt text.
          example: Hotel Exterior View
        width:
          type: integer
          description: Image width in pixels.
          example: 1920
        height:
          type: integer
          description: Image height in pixels.
          example: 1080
        format:
          type: string
          description: Image format.
          enum:
          - JPEG
          - PNG
          - WEBP
          example: JPEG
        isPrimary:
          type: boolean
          description: Indicates whether this is the primary/featured image for this category.
          example: true
    Meta:
      type: object
      description: Metadata about the response.
      properties:
        count:
          type: integer
          description: Number of results returned.
          example: 1
        links:
          type: object
          properties:
            self:
              type: string
              format: uri
              description: URL of the current request.
              example: https://api.amadeus.com/v1/reference-data/locations/hotels/by-hotels/content
    ErrorResponse:
      type: object
      description: Error response from the API.
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/Error'
    Error:
      type: object
      description: Individual error detail.
      properties:
        status:
          type: integer
          description: HTTP status code.
          example: 400
        code:
          type: integer
          description: Amadeus error code.
          example: 477
        title:
          type: string
          description: Short error title.
          example: INVALID FORMAT
        detail:
          type: string
          description: Detailed error description.
          example: Invalid value for parameter.
        source:
          type: object
          properties:
            parameter:
              type: string
              description: Name of the parameter that caused the error.
              example: hotelIds
tags:
- name: Hotel Content
  description: Operations for retrieving detailed hotel property content.
- name: Hotel Media
  description: Operations for retrieving hotel media assets including images and videos.