Skip to content

Full accommodation catalog

With this method we request the full information of an accommodation. It includes information about the rates of the different available rooms.

Access method

POST /Accommodation/FullCatalog

Request structure

  • People: (list) Required. List of people included in the package. The order in which people are added to this list later determines the index to use in the Room property.

    • Person: (object) Required. Person information.

      • Type: (int) Required. Person type.

        Possible values
        • 0: Baby
        • 1: Child
        • 2: Adult
        • 3: Senior
        • 4: Generic
      • Age: (int) Optional. Person age. Required only if the person is a child or a baby (types 1 and 2).

  • AccommodationId: (string) Required. Accommodation identifier.

  • CheckIn: (date) Required. Accommodation check-in date. ISO 8601 format (yyyy-MM-dd).
  • CheckOut: (date) Required. Accommodation check-out date. ISO 8601 format (yyyy-MM-dd).
  • RoomDistribution: (list) Required. List of rooms that will make up the package.
    • Room: (list) Required. Information about the people who make up this room.
      • (int): Required. Index corresponding to the position of the person in the People list.

Request example

Example: 2 rooms: \"1 adult + 1 child\" and \"1 adult\"
{
    "People": [
        {
            "Type": 2
        },
        {
            "Type": 2
        },
        {
            "Type": 1,
            "Age": 5
        },
        {
            "Type": 2
        }
    ]
    "AccommodationId": "291641/weqn6yqht5bfw",
    "CheckIn": "2023-01-25",
    "CheckOut": "2023-01-28",
    "RoomDistribution": [
        [
            0,
            1,
            2
        ],
        [
            3
        ]
    ]

}

Response structure

  • Echotoken: (string). Token needed for subsequent requests such as requesting prices, adding items to the cart, etc.
  • Accommodations: (list). Information about the accommodation specified in the request.

    • Id: (string). Accommodation identifier.
    • Name: (string). Accommodation name.
    • Description: (string). Accommodation description.
    • Address: (string). Accommodation address.
    • PostalCode: (string). Accommodation postal code.
    • City: (string). Accommodation city.
    • Country: (string). Accommodation country.
    • Type: (int). Accommodation type.

      Possible values
      • 0: Unclassified
      • 1: Hotel
      • 2: Hostel
      • 3: Campsite
      • 4: Apartment
    • Category: (int). Category type.

      Possible values
      • 0: Unknown.
      • 1: 1 Star.
      • 2: 2 Stars.
      • 3: 3 Stars.
      • 4: 4 Stars.
      • 5: 5 Stars.
    • Location: (object). Exact accommodation location.

      • Latitude: (decimal). Location latitude.
      • Longitude: (decimal). Location longitude.
    • AccommodationImages: (list). List of accommodation images.

      • Description: (string). Image description.
      • Order: (int). Display order.
      • Url: (string). Image URL.
    • AccommodationRooms: (list). List of different accommodation rooms.

      • AccommodationRoom: (object). Information about the accommodation room.

        • RoomRequestNumber: (string). Requested distribution identifier according to the room.

          Example
          • If 3 rooms for 2 adults each are requested.

            In this case, the identifiers defined between 1 and 3 will appear, but the rooms can be selected as desired. Examples:

            • 3 of type RoomRequestNumber = 1
            • 2 of type RoomRequestNumber = 1 and 1 of type RoomRequestNumber = 3
            • 1 of type RoomRequestNumber = 1, another of type RoomRequestNumber = 2 and another of type RoomRequestNumber = 3
          • If 3 rooms are requested, one for 2 adults, another for 2 children and another for 1 child and 1 adult.

            It will be necessary to select one of type RoomRequestNumber = 1, one RoomRequestNumber = 2 and another RoomRequestNumber = 3.

        • TypeName: (string). Room type name.

        • AccommodationRoomRates: (list). Array with the accommodation room rates.
          • AccommodationRoomRate: (list). Information about the room rate.

            • Id: (string). Room identifier.
            • BoardCode: (int). Board type code.

              Possible values
              • 10: Room only.
              • 20: Bed and breakfast.
              • 30: Half board.
              • 40: Full board.
              • 50: All inclusive.
            • BoardName: (string). Board type name.

            • Adults: (int). Number of adults.
            • Children: (int). Number of children.
            • RateClass: (int). Rate type.

              Possible values
              • 1: Non-refundable
              • 2: Refundable.
            • Price: (decimal). Rate price.

            • PriceMode: (int). Price type.

              Possible values
              • 1: Retail price
              • 2: Net
            • Commission: (object). Commission information.

              • Type: (int). Commission type.

                Possible values
                • 1: percentage.
                • 2: absolute value.
              • Value: (decimal). Commission value.

  • Flags: (list). List with additional information.

    • IncludesTickets: (boolean). Indicates whether tickets are included.
    • Promoted: (boolean). Indicates whether it is promoted.
  • Success: (boolean). Value that indicates whether the call was processed correctly or not.

  • Errors: (list). Array of errors.
    • Error: (object).
      • ErrorMessage: (string). Error message explaining why the request was not successful. If it was correct, it will return null.
      • ErrorCode: (int). Code that identifies the error.
  • ErrorEntityBreakDown (list): list that contains objects with the name and ID in case of error.
    • Id (string): identifier
    • Name (string): related name of the identifier.