Retrieve Room

This endpoint retrieves all rooms associated with a specific Airbnb listing, including room types and bed configurations.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/room/retrieve

---

Header

-app-id: App Id
Authorization: Basic Authorization
Content-Type: application/json

Header	Type	Required	Description
app-id	string	Yes	Your application ID. Required for authentication.
Authorization	string	Yes	Your API key. for authorization. Required for authentication.
Content-Type	string	Yes	Must be set to application/json.

---

Attributes

---

hotelid alphanumeric (Required)

Specifies the required node hotelid containing the IT provider's hotel ID for which the provider wishes to add mapping information.

---

channelhotelid alphanumeric (Required)

Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).

---

listingid numeric (Required)

Listing ID of the property allocated by Airbnb.

---

Request

{
  "hotelid": "SUTEST01",
  "channelhotelid": "511039958",
  "listingid": "1541919118065328804"
}

---

Response

---

Success Response

{
  "Status": "Success",
  "Data": {
    "listing_rooms": [
      {
        "room_type": "bedroom",
        "beds": [
          {
            "quantity": 1,
            "type": "king_bed"
          },
          {
            "type": "queen_bed",
            "quantity": 2
          }
        ],
        "id": "746982076",
        "listing_id": "1541919118065328804",
        "is_private": false
      },
      {
        "room_type": "bedroom",
        "beds": [
          {
            "type": "king_bed",
            "quantity": 1
          },
          {
            "type": "queen_bed",
            "quantity": 2
          }
        ],
        "id": "746987706",
        "is_private": false,
        "listing_id": "1541919118065328804"
      },
      {
        "id": "747495841",
        "is_private": false,
        "listing_id": "1541919118065328804",
        "room_type": "half_bathroom",
        "beds": []
      },
      {
        "is_private": false,
        "listing_id": "1541919118065328804",
        "id": "747495842",
        "beds": [],
        "room_type": "full_bathroom"
      },
      {
        "id": "752081735",
        "listing_id": "1541919118065328804",
        "is_private": true,
        "room_type": "bedroom",
        "beds": [
          {
            "type": "king_bed",
            "quantity": 1
          }
        ]
      }
    ]
  },
  "Message": "Rooms retrieved successfully"
}

---

Success Response - Body Elements

Status string

Indicates the result of the API call. Will be "Success" when room details are retrieved successfully.

---

Data object

Contains the list of rooms for the specified Airbnb listing.

---

listing_rooms array of objects

List of rooms returned for the listing:

---

id string

Airbnb-assigned room ID.

---

listing_id string

ID of the Airbnb listing to which the room belongs.

---

room_type string

Type of the room.

---

is_private boolean

Indicates whether the room is private.

---

beds array of objects

Bed configuration for the room:

---

type string

Type of bed.

---

quantity numeric

Number of beds of this type.

---

Message string

Describes the result of the operation, confirming that rooms were retrieved successfully.

---

Error Response

Error 1

{
  "Status": "Fail",
  "Errors": [
    {
      "Code": "981",
      "ShortText": "channelhotelid is not defined or invalid value"
    }
  ]
}

Error 2

---

Error Response - Body Elements

Status string

Indicates the result of the API call.

Will be always "Fail" in case of an error response.

---

Errors object

The response error, the root element.

---

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

---

ShortText string

A short description of the error.

---

Message string

The message in the response.