Retrieve Detailed Description

This endpoint retrieves the full set of descriptive information for a specific Airbnb listing, including summary, space details, rules, notes, and other description fields.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/description/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 contains 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_descriptions": [
      {
        "transit": "Street parking only",
        "summary": "A beautiful and cozy place to stay.",
        "notes": "Notes",
        "name": "Airbnb Extranet Listing",
        "locale": "en",
        "interaction": "Host",
        "house_rules": "small",
        "listing_id": "1541919118065328804",
        "neighborhood_overview": "A very good Exprience of view",
        "access": "Space",
        "space": "Unique",
        "description": "A beautiful and cozy place to stay"
      }
    ]
  },
  "Message": "Description retrieved successfully"
}

---

Success Response - Body Elements

Status string

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

---

Data object

Contains the listing description details.

---

listing_descriptions array of objects

List of description records for the listing:

---

transit string

Transportation or transit-related details.

---

summary string

Short summary of the listing.

---

notes string

Additional notes provided by the host.

---

name string

Name of the listing.

---

locale string

Language code of the description.

---

interaction string

Host–guest interaction details.

---

house_rules string

House rules for the listing.

---

listing_id string

ID of the listing.

---

neighborhood_overview string

Overview of the neighborhood.

---

access string

Guest access details.

---

space string

Description of the space.

---

description string

Primary description of the listing.

---

Message string

Message confirming that the listing description was 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.