Get Listing Status

This API retrieves the current status and validation checkpoints for a specific VRBO listing.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/vrbo/property/status/get

Header

app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
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

hotel_id string (Required)

The unique property ID as assigned by the provider upon creation of the property.

listing_id string (Required)

VRBO listing ID.

Request

{
  "hotel_id": "AWSTEST",
  "listing_id": "7338475"
}

Response

Success Response

{
  "Status": "Success",
  "Data": {
    "property_name": "XYZ hotel 1",
    "units": [
      {
        "ids": [
          {
            "id": "318420152",
            "source": "EXPEDIA"
          },
          {
            "id": "STAAH/100000/88888/1",
            "source": "SUPPLIER"
          },
          {
            "id": "321.1258395.1817454",
            "source": "VRBO"
          }
        ],
        "active_status": false,
        "status_check_point": {
          "name": "HasUnitMinimumContentProvided",
          "last_evaluated": "2025-06-06T12:16:14.487Z",
          "resolution_status": "RESOLVED",
          "check_points": [
            {
              "name": "HasImages",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            },
            {
              "name": "HasRates",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": false,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            },
            {
              "name": "HasRegistrationNumber",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": false,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            },
            {
              "name": "HasBookingType",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            },
            {
              "name": "HasAcceptedPaymentForm",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            },
            {
              "name": "HasCancellationPolicy",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            },
            {
              "name": "HasHouseRules",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            },
            {
              "name": "HasCheckInCheckOut",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            },
            {
              "name": "HasPropertyAddress",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasLocation"
              ]
            },
            {
              "name": "HasGeoCode",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasLocation"
              ]
            },
            {
              "name": "HasPropertyDescription",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": false,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasPropertyDetails"
              ]
            },
            {
              "name": "HasPropertyHeadline",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": false,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasPropertyDetails"
              ]
            },
            {
              "name": "HasBathroom",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasPropertyDetails"
              ]
            },
            {
              "name": "HasMaxOccupancy",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasPropertyDetails"
              ]
            },
            {
              "name": "HasPropertyType",
              "last_evaluated": "2025-04-17T12:26:40.473Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasPropertyDetails"
              ]
            },
            {
              "name": "Reverse Geocode Country",
              "last_evaluated": "2025-02-19T04:59:42.491Z",
              "resolution_status": "RESOLVED",
              "fulfilled": false,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasValidatedAddress"
              ]
            },
            {
              "name": "HasPassedOFACFilter",
              "last_evaluated": "2025-02-19T04:59:42.491Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasValidatedAddress"
              ]
            },
            {
              "name": "Valid Geo Coordinates",
              "last_evaluated": "2025-02-19T04:59:42.491Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasValidatedAddress"
              ]
            },
            {
              "name": "TierOneAddressContentValidation",
              "last_evaluated": "2025-02-19T04:59:42.491Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasValidatedAddress"
              ]
            },
            {
              "name": "HasNoDuplicateAddressContent",
              "last_evaluated": "2025-02-19T04:59:42.491Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasValidatedAddress"
              ]
            },
            {
              "name": "Valid Country Code",
              "last_evaluated": "2025-02-19T04:59:42.491Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasValidatedAddress"
              ]
            },
            {
              "name": "IsAddressLine1Complete",
              "last_evaluated": "2025-02-06T10:26:36.068Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasCompletedAddress"
              ]
            },
            {
              "name": "IsCityComplete",
              "last_evaluated": "2025-02-06T10:26:36.068Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasCompletedAddress"
              ]
            },
            {
              "name": "IsStateProvinceComplete",
              "last_evaluated": "2025-02-06T10:26:36.068Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasCompletedAddress"
              ]
            },
            {
              "name": "IsCountryComplete",
              "last_evaluated": "2025-02-06T10:26:36.068Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasCompletedAddress"
              ]
            },
            {
              "name": "IsPostalCodeComplete",
              "last_evaluated": "2025-02-06T10:26:36.068Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided",
                "HasCompletedAddress"
              ]
            },
            {
              "name": "IsNotVrboAsMOR",
              "last_evaluated": "1970-01-01T00:00:00.000Z",
              "resolution_status": "RESOLVED",
              "fulfilled": true,
              "path": [
                "HasUnitMinimumContentProvided"
              ]
            }
          ]
        }
      }
    ],
    "listings": [
      {
        "locale": "en_US",
        "url": null
      },
      {
        "locale": "en_US",
        "url": "https://stage.vrbo.com/1258395?dateless=true"
      }
    ]
  },
  "Message": "Listing status fetched successfully",
  "Trace-ID": ""
}

Success Response - Body Elements

Status string

Indicates the result of the API call.

Will be "Success" when the listing status is fetched successfully.

Data object

Contains the detailed information related to the property listing, including property name, associated units, and listing URLs.

property_name string

Specifies the name of the property for which the listing status is being fetched.

units array

Represents a list of units associated with the property.

Each unit object contains identifiers, activity status, and status validation checkpoints.

ids array

Contains the list of identifiers for the unit across various connected systems.

id string

The unique identifier of the unit as per the respective source system.

source string

Indicates the source system to which the identifier belongs.

active_status boolean

Shows whether the property unit is currently active or inactive on VRBO.

true → The unit is active. false → The unit is inactive.

status_check_point object

Provides details about the validation and content completeness checks performed on the property listing.

name string

The main validation category or checkpoint name.

last_evaluated string

Indicates the timestamp when this checkpoint was last evaluated.

resolution_status string

Represents the outcome or resolution state of the validation.

check_points array

Lists all sub-checkpoints evaluated under the main checkpoint, showing individual validation results.

name string

The name of the specific validation rule.

last_evaluated string

Timestamp of the last time this individual checkpoint was evaluated.

resolution_status string

Indicates the resolution status of this checkpoint.

fulfilled boolean

Specifies whether the validation requirement was successfully met.

true → Validation passed. false → Validation failed.

path array

Displays the hierarchical path of the validation checkpoints.

listings array

Represents the localized versions of the property listings, including URLs for each locale.

locale string

Specifies the locale/language code for the listing.

url string

The listing URL for the property in the specified locale.

Can be null if the listing is not yet published or live.

Message string

Provides a descriptive message indicating the result of the API request.

Example: "Listing status fetched successfully".

Trace-ID string

A unique identifier assigned to the API request, used for tracing and debugging.

Error Response

{
  "Status": "Fail",
  "Errors": [
    {
      "Code": "400",
      "ShortText": "hotel_id: Invalid HotelCode (:hotelid)"
    },
    {
      "Code": "2004",
      "ShortText": "Listing Id is required"
    }
  ],
  "Message": "",
  "Trace-ID": ""
}

Error Response - Body Elements

Status string

Indicates the result of the API call.

Will be always "Fail" in case of an error response.

Errors array

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.

Trace-ID string

Unique ID for tracing the API request.

PreviousUpdate Listing NextSet Listing Status

Last updated 1 day ago

Was this helpful?