Ready for Review

This endpoint marks an Airbnb listing as ready for review in the external channel, initiating the approval process required before the listing can be published.

If you get error while publishing listing, then make changes in listing data through Content APIs and then again publish listing with this API.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/listing/readyForReview

---

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 provided by Airbnb while listing was created.

---

Request

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

---

Response

---

Success Response

{
  "Status": "Success",
  "Data": {
    "listing": {
      "synchronization_category": "sync_all",
      "has_active_disaster": false,
      "amenities": [],
      "name": "Heaven Feels Home",
      "tier": "marketplace",
      "directions": "",
      "property_details": {
        "listing_size": []
      },
      "categories": [],
      "host_roles": [
        {
          "type": "OWNER",
          "is_super_host": false,
          "user_id": "511039958",
          "is_primary_host": true
        }
      ],
      "has_availability": false,
      "quality_standards": {
        "state": "GOOD"
      },
      "person_capacity": 1,
      "reservation_issues": [],
      "id": "1559211888155549924",
      "display_exact_location_to_guest": false
    }
  },
  "Message": "Listing has been approved successfully"
}

---

Success Response - Body Elements

Status string Indicates whether the API request was successful. Will always be "Success" in a successful response.

---

Data object Contains details about the listing that has been marked ready for review. Includes:

---

listing object

Listing details such as:

---

id string

Listing ID provided by Airbnb.

---

name string

Listing name/title.

---

has_availability boolean

Whether the listing is published (true) or not (false).

---

synchronization_category string

Synchronization type, e.g., "sync_all".

---

tier string

Marketplace tier.

---

person_capacity numeric

Maximum number of guests.

---

display_exact_location_to_guest boolean

Whether the exact location is shown to guests.

---

quality_standards object

Quality state of the listing.

---

categories array

Categories assigned to the listing.

---

amenities array

Amenities available in the listing.

---

property_details object

Listing-specific details such as listing_size.

---

host_roles array

Roles of hosts associated with the listing.

---

reservation_issues array

Any current reservation issues.

---

has_active_disaster boolean

Indicates if there is an active disaster affecting the listing.

---

directions string

Directions for guests, if any.

---

Message string

Descriptive message about the result of the request. Example: "Listing has been approved 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.