Retrieve Availability Rule

This end point retrieves the availability rules for a specific Airbnb listing, including check-in/check-out days, minimum/maximum nights, booking lead time, and seasonal rules.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/availabilityrules/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": "1460656632408024582"
}

---

Response

---

Success Response

{
  "Status": "Success",
  "Data": {
    "availability_rule": {
      "default_max_nights": 5,
      "day_of_week_check_out": [
        {
          "day_of_week": 0
        },
        {
          "day_of_week": 2
        },
        {
          "day_of_week": 5
        }
      ],
      "default_min_nights": 2,
      "allow_rtb_above_max_nights": false,
      "day_of_week_check_in": [
        {
          "day_of_week": 1
        },
        {
          "day_of_week": 3
        },
        {
          "day_of_week": 4
        },
        {
          "day_of_week": 6
        }
      ],
      "turnover_days": {
        "days": 1
      },
      "max_days_notice": {
        "days": 90
      },
      "booking_lead_time": {
        "allow_request_to_book": 0,
        "hours": 1
      },
      "day_of_week_min_nights": [
        {
          "day_of_week": 6,
          "min_nights": 2
        },
        {
          "min_nights": 2,
          "day_of_week": 4
        },
        {
          "min_nights": 2,
          "day_of_week": 0
        },
        {
          "day_of_week": 5,
          "min_nights": 2
        },
        {
          "day_of_week": 1,
          "min_nights": 2
        },
        {
          "day_of_week": 2,
          "min_nights": 2
        },
        {
          "day_of_week": 3,
          "min_nights": 2
        }
      ],
      "listing_id": "1460656632408024582"
    }
  },
  "Message": "Availability rules retrieved successfully"
}

---

Success Response - Body Elements

---

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.