Get RTB by request by ID¶

Use the /rtb/properties/{property_id}/requests/{id} endpoint to retrieve a RTB request by its ID.

Method and URL¶

GET https://supply-xml.booking.com/rtb/properties/{property_id}/requests/{id}

Request headers¶

Header	Description	Type	Required
`Authorization`	Your Base-64 encoded username and password.	String	Required

Sample request¶

curl --user username:password \
-H 'Content-Type: application/json' \
"https://supply-xml.booking.com/rtb/properties/{property_id}/requests/{id}

Response¶

In case of a successful request, you'll receive the RTB entity with status code 200.

In case of an error, you'll receive the following:

An error code
A message explaining the error, and
An RUID in the metadata

Sample response — Success¶

{
    "data": {
        "id": 3478615,
        "propertyId": 10736409,
        "requestStatus": "REJECTED",
        "checkin": "2023-09-22",
        "checkout": "2023-09-23",
        "totalPrice": {
            "amount": 5.0,
            "currency": "EUR"
        },
        "units": [
            {
                "id": 1079428902,
                "rateId": 38372481,
                "name": "Apartment with Balcony",
                "price": {
                    "amount": 5.0,
                    "currency": "EUR"
                }
            }
        ],
        "occupancy": {
            "adults": 2,
            "children": 0,
            "total": 2
        },
        "guestInfo": {
            "guestMessage": "testing rtb mxn",
            "emailVerified": false,
            "phoneVerified": false,
            "registeredSince": 2023,
            "domestic": true
        },
        "statusUpdateTime": "2023-09-20T13:28:05Z",
        "createdAt": "2023-09-20T07:30:22Z",
        "updatedAt": "2023-09-20T13:28:05Z"
    },
    "warnings": [],
    "errors": [],
    "meta": {
        "ruid": "0000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
}

Sample response — Errors¶

{
  "warnings": [],
  "errors": [
    {
      "message": "Booking request not found for property.",
      "code": "RTB_REQUEST_NOT_FOUND"
    }
  ],
  "meta": {
    "ruid": "0000000000000000000000000000000000000000000000000000000000000000000000000000"
  }
}

Detailed Guest Information¶

Guest details are added to the guestInfo property in an RTB entity. Information unknown for a specific guest is not included in the object.

Parameter	Type	Description
`guestMessage`	String	Contains the message added by the guest when making the request to book.
`emailVerified`	Boolean	If the email was verified as working by Booking.com.
`phoneVerified`	Boolean	Specifies whether the phone was verified as working by Booking.com.
`registeredSince`	String	Year of registry on Booking.com.
`domestic`	Boolean	If the guest is traveling within the same country.
`hasNoShow`	Boolean	Specifies whether the guest has a previous no-show booking.
`hasPastMisconduct`	Boolean	Specifies whether the guest has a history of misconduct.
`hasStayWithPartnerBefore`	Boolean	Specifies whether the guest is a returning guest for the property.
`completedStays`	String	"5+" is present when the guest has at least 5 completed stays on Booking.com.

Is this page helpful? Yes | No