Retrieve Listing Data

This endpoint retrieves complete Airbnb listing details for a specific listing ID, including property attributes, location, facilities, check-in/out instructions, availability, and quality assessment.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/listing/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": {
      "zipcode": "394510",
      "has_availability": false,
      "host_roles": [
        {
          "is_primary_host": true,
          "user_id": "511039958",
          "type": "OWNER",
          "is_super_host": false
        }
      ],
      "directions": "opp rajhansh multiplex",
      "lat": 21.182063,
      "city": "Surat",
      "country_code": "IN",
      "lng": 72.782675,
      "room_type_category": "shared_room",
      "reservation_issues": [],
      "tier": "marketplace",
      "state": "Gujarat",
      "id": "1559213514575692094",
      "has_active_disaster": false,
      "name": "Heaven Feels House",
      "display_exact_location_to_guest": true,
      "property_type_category": "hut",
      "person_capacity": 5,
      "quality_standards": {
        "state": "GOOD"
      },
      "property_details": {
        "number_of_floors": 1,
        "listing_size": {
          "size": 250,
          "size_unit": "SQUARE_METERS"
        },
        "listing_floor": 1,
        "year_built": 2022
      },
      "synchronization_category": "sync_all",
      "street": "5QJM+R3F, Hazira - Adajan Road",
      "listing_views": [
        "BAY_VIEW"
      ],
      "property_type_group": "houses",
      "check_out_tasks": {
        "GATHER_TOWELS": {
          "is_present": true,
          "task_detail": "gather towels description"
        }
      },
      "check_in_option": {
        "instruction": "instruction",
        "category": "lockbox"
      },
      "categories": [],
      "apt": "Apt 32",
      "facilities": [
        {
          "facility_id": 689,
          "is_available": true,
          "instances": [
            {
              "key": "ac_options",
              "value": "CENTRAL,PORTABLE"
            }
          ]
        },
        {
          "facility_id": 698,
          "is_available": true,
          "instances": [
            {
              "key": "workspace_setup_types",
              "value": "ERGONOMIC_CHAIR"
            },
            {
              "key": "privacy",
              "value": "PRIVATE_SPACE"
            }
          ]
        },
        {
          "facility_id": 720,
          "is_available": true,
          "instances": [
            {
              "key": "stove_materials",
              "value": "STAINLESS_STEEL"
            },
            {
              "key": "brand",
              "value": "panasonic"
            },
            {
              "key": "number_of_burners",
              "value": 2
            },
            {
              "key": "stove_type",
              "value": "ELECTRIC"
            }
          ]
        },
        {
          "facility_id": 708,
          "is_available": true,
          "instances": [
            {
              "key": "number_of_spaces",
              "value": 6
            }
          ]
        },
        {
          "facility_id": 712,
          "is_available": true,
          "instances": [
            {
              "key": "brand",
              "value": "LG"
            },
            {
              "key": "fridge_type",
              "value": "MINI_FRIDGE"
            }
          ]
        },
        {
          "facility_id": 702,
          "is_available": true
        },
        {
          "facility_id": 691,
          "is_available": true,
          "instances": [
            {
              "key": "fireplace_types",
              "value": "ELECTRIC,GAS"
            }
          ]
        }
      ]
    }
  },
  "Message": "Listing retrieved 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 the full listing information returned from Airbnb for the provided listingid.

---

listing object

The root object containing all listing-level details such as address, availability, host info, facilities, and property attributes.

---

zipcode string

The postal code associated with the listing’s location.

---

has_availability boolean

Indicates whether the listing is currently active and available on Airbnb.

---

host_roles array

List of host-related details, including whether the user is the primary host and their role (e.g., OWNER, CO-HOST).

---

directions string

Directions or guidance to help guests locate the listing.

---

lat number

Latitude coordinate of the property.

---

city string

City where the property is located.

---

country_code string

Two-letter country code of the listing (ISO standard).

---

lng number Longitude coordinate of the property.

---

room_type_category string

Type of room offered (e.g., entire_place, private_room, shared_room).

---

reservation_issues array

Indicates any reservation-related issues associated with the listing. Empty if none exist.

---

tier string

Airbnb category tier assigned to the listing (e.g., marketplace).

---

state string

State or region where the property is located.

---

id string

The Airbnb-generated unique identifier for the listing.

---

has_active_disaster boolean

Indicates whether the property is in an active disaster region as identified by Airbnb.

---

name string

The display name/title of the listing on Airbnb.

---

display_exact_location_to_guest boolean

Indicates whether Airbnb shows the exact map location to guests.

---

property_type_category string

Category of property type (e.g., hut, apartment, villa).

---

person_capacity number

The maximum number of guests allowed at the listing.

---

quality_standards object

Represents Airbnb’s quality standard assessment of the listing (e.g., "GOOD").

---

property_details object

Detailed property specifications such as floor count, size, and construction year.

---

synchronization_category string

Specifies the synchronization level (e.g., sync_all).

---

street string

Street address of the listing.

---

listing_views array

List of view categories visible from the property (e.g., "BAY_VIEW").

---

property_type_group string

The broader group of the property type (e.g., houses, apartments).

---

check_out_tasks object

Defines checkout tasks guests must complete (e.g., gathering towels).

---

check_in_option object

Includes instructions and the method of check-in (e.g., lockbox).

---

categories array

List of Airbnb categories associated with the listing (empty if none).

---

apt string

Apartment or unit number, if applicable.

---

facilities array

List of facilities available at the property. Each object contains:

facility_id

is_available

optional instances (key–value details)

---

Message string

A descriptive message about the result of the request.

---

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.