Change Listing Status

This endpoint updates the publication status of an Airbnb listing by activating or deactivating it, including optional details when disabling the listing.

Endpoint

POST

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

---

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.

---

has_availability boolean (Required)

whether you want to publish listing or want to deactivate the listing.

---

deactivation_reason string (Optional)

The reason for listing deactivation, must be set when setting has_availability to false

---

deactivation_details string (Optional)

Optional free text field to enter any additional details for why you are deactivating the listing.

---

Request

{
  "hotelid": "SUTEST01",
  "channelhotelid": "511039958",
  "listingid": "1541919118065328804",
  "has_availability": false,
  "deactivation_reason": "Reason of deactivation",
  "deactivation_details": "Details of Deactivation"
}

---

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 status changed 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 whose status has been changed. Includes:

---

listing object

Listing details such as:

---

id string

Listing ID provided by Airbnb.

---

name string

Listing name/title.

---

has_availability boolean

Indicates if the listing is published (true) or deactivated (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.

---

Message string

Descriptive message about the result of the request. Example: "Listing status changed successfully".

---

Error Response

Error 1

{
  "Status": "Fail",
  "Errors": [],
  "Message": "Your listing cannot be published at this time. Please contact customer support for more information. "
}

---

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.