Products (In Progress)

2-step booking process through: reserving availability and making the booking.

When making a reservation for availability this is performed in 2 steps:

1. Check Availability: Check for availability using the POST /availability endpoint to retrieve the availabilityId.

2. Booking Reservation: Create the booking which reserves that availability. The booking will keep the status ON_HOLD until the booking is confirmed or the reservation expirationMinutes expires. A reservation can be extended by calling the POST /bookings/:uuid/extend endpoint.

We have described the possible Booking calls here:

1. Booking Endpoints

   1. Reserve - stage 1 reserves the availability by providing the availabilityId. The Availability ID comes from checking inventory.

   2. Confirm - stage 2 finalizes the booking.

   3. Cancel (Optional) - allows cancelling a confirmed booking.

   4. Update (Optional) - allows updating of an existing booking.

   5. Extend (Optional) - allows extending the expirationMinutes or hold time.

2. Access to Existing Bookings

   1. Get Booking - this end point will retrieve a single valid booking associated with your reseller account.

   2. Get Bookings - this end point will retrieve a list of bookings associated with your reseller account.

Create booking

post

This endpoint creates a new booking. Before creating the booking, it checks the availability of the requested service. - Note All newly created bookings have a default status of ON_HOLD.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

availabilityIdstringRequired

The availability id for this booking.

Example: {{AVAILABILITY_ID}}

expirationMinutesnumberRequired

This attribute extends the ON_HOLD status of the reserve and its value is represented in minutes (Min 20 - Max 200).

Example: 200

notesstringOptional

Optional notes for the booking.

Example: My notes

optionIdstringRequired

The option id for this booking.

Example: DEFAULT

productIdstringRequired

The product id for this booking.

Example: {"[object Object]":null}

uuidany | nullableOptional

A UUID used as an idempotency key when creating the booking.

Responses

200

Object of booking

application/json

post

/bookings (Products)

JS

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "uuid": null,
  "productId": "65981a24d09fc62f079ed751",
  "availabilityId": "2024-05-26T00:00:00-05:00",
  "expirationMinutes": "580",
  "optionId": "DEFAULT",
  "notes": "lorem ipsim "
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch('/bookings', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

200

Object of booking

{
  "uuid": "ecdcef4c-462b-400d-9e0e-d48f8871a985",
  "status": "ON_HOLD",
  "utcCreatedAt": "2025-12-21T15:35:20.812Z",
  "utcUpdatedAt": "2025-12-21T15:35:20.812Z",
  "utcExpiresAt": "2025-12-21T15:35:20.812Z",
  "utcRedeemedAt": "2025-12-21T15:35:20.812Z",
  "utcConfirmedAt": "2025-12-21T15:35:20.812Z",
  "productId": "66d9cda3026dcae628481e4b",
  "product": {
    "id": "66d9cda3026dcae628481e4b",
    "internalName": "Arrival transfer From Naples to Sorrento with 2 h stops on Pompei",
    "description": "<p><span style=\"color: rgb(0, 0, 0);\">Discover the hidden gems of Naples, Italy with the transfers to Sorrento with a stop on Pompeii! Enjoy the luxury of a private driver and vehicle to take you to the places you want to go, at the time that suits you. Marvel at the stunning views from the top of Mount Vesuvius or explore the ancient ruins of Pompeii, both just a short drive away. Take a stroll through the picturesque streets of the historic center and indulge in delicious local cuisine. Visit the grand Royal Palace, the iconic Castel dell'Ovo, or the vibrant Piazza del Plebiscito. include 2 h. stop on Pompai </span></p>",
    "category": "LUXURY",
    "currency": "EUR",
    "inclusions": [
      "flight tracking",
      "60-minutes waiting time",
      "bottle of water",
      "tolls and taxes",
      "meet & greet"
    ],
    "exclusions": [
      "food",
      "drinks",
      "gratuity"
    ],
    "images": [
      "https://upcdn.io/FW25b8h/raw/products/Pmpei3-Epdv.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-2rDP.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-75St.jpg",
      "https://upcdn.io/FW25b8h/raw/products/Pompei2-24fJ.jpeg",
      "https://upcdn.io/FW25b8h/raw/products/Pompai1-6Gvh.jpeg"
    ],
    "cancellationPolicy": [
      "To receive a Full Refund, cancellations must be made at least 24 Hours prior to the start time of the experience.",
      "If you cancel less than 24 Hours before the experience's start time, the amount you paid will not be refunded.",
      "Changes made less than 24 Hours before the experience's start time will not be accepted."
    ],
    "meetingPoints": [
      "Naples Airport arrival hall"
    ],
    "createdAt": "2025-12-21T15:35:20.812Z",
    "updatedAt": "2025-12-21T15:35:20.812Z",
    "importantInformation": [
      "2h stop in Pompi include",
      "tickets is not included"
    ],
    "timeZone": "Europe/Rome",
    "type": "PRIVATE_TRANSFER",
    "productCode": "A28-TR-01155",
    "pickupRequired": true,
    "dropoffRequired": false,
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "Audi A8 or similar",
        "reference": "5dca9af9edceaa58fa3e84b3",
        "restrictions": {
          "minUnits": 0,
          "maxUnits": 2
        },
        "units": [
          {}
        ]
      }
    ]
  },
  "optionId": "DEFAULT",
  "option": {
    "id": "DEFAULT",
    "default": true,
    "internalName": "Audi A8 or similar",
    "reference": "5dca9af9edceaa58fa3e84b3",
    "restrictions": {
      "minUnits": 0,
      "maxUnits": 2
    },
    "units": [
      {}
    ]
  },
  "cancellable": true,
  "cancellation": {
    "refund": "FULL_REFUND",
    "reason": "Lorem impsun",
    "utcCancelledAt": "2025-12-21T15:35:20.812Z"
  },
  "availabilityId": "2024-09-30T14:00:00+00:00",
  "availability": {
    "id": "2024-09-30T14:00:00+00:00",
    "openingHours": [],
    "status": "AVAILABLE",
    "available": true,
    "capacity": 2,
    "localDate": "2024-09-30",
    "startTime": "14:00",
    "pricing": {
      "basePrice": 47.03,
      "netPrice": 69.16,
      "fees": [
        {
          "name": "Night Fees",
          "net": 15,
          "description": "Night Fees"
        }
      ],
      "totalPrice": 84.16
    }
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[e-mail]",
    "phoneNumber": "[phone]",
    "postalCode": "80147",
    "country": "Italy",
    "notes": "Lorem impsun"
  },
  "notes": "Lorem impsun"
}

Booking Confirmation

Booking Confirmation

post

This endpoint confirms the booking so it's ready to be used.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The booking id.

Body

application/json

emailReceiptstringRequired

Whether you want RhonTrip Cloud to email the guest a copy of their receipt. (defaults to false)

Example: [e-mail]

resellerReferencestringRequired

Your reference for this booking. Also known as a Voucher Number.

Example: u7ut5rr

Responses

200

Object of booking

application/json

post

/bookings/{id}/confirm (Products)

JS

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "resellerReference": "u7ut5rr",
  "emailReceipt": "[e-mail]",
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[e-mail]",
    "phoneNumber": "1111111111",
    "postalCode": 2323,
    "country": "US",
    "notes": "Lorem ipsum"
  }
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch('/bookings/confirm', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

200

Object of booking

{
  "uuid": "ecdcef4c-462b-400d-9e0e-d48f8871a985",
  "status": "ON_HOLD",
  "utcCreatedAt": "2025-12-21T15:35:20.812Z",
  "utcUpdatedAt": "2025-12-21T15:35:20.812Z",
  "utcExpiresAt": "2025-12-21T15:35:20.812Z",
  "utcRedeemedAt": "2025-12-21T15:35:20.812Z",
  "utcConfirmedAt": "2025-12-21T15:35:20.812Z",
  "productId": "66d9cda3026dcae628481e4b",
  "product": {
    "id": "66d9cda3026dcae628481e4b",
    "internalName": "Arrival transfer From Naples to Sorrento with 2 h stops on Pompei",
    "description": "<p><span style=\"color: rgb(0, 0, 0);\">Discover the hidden gems of Naples, Italy with the transfers to Sorrento with a stop on Pompeii! Enjoy the luxury of a private driver and vehicle to take you to the places you want to go, at the time that suits you. Marvel at the stunning views from the top of Mount Vesuvius or explore the ancient ruins of Pompeii, both just a short drive away. Take a stroll through the picturesque streets of the historic center and indulge in delicious local cuisine. Visit the grand Royal Palace, the iconic Castel dell'Ovo, or the vibrant Piazza del Plebiscito. include 2 h. stop on Pompai </span></p>",
    "category": "LUXURY",
    "currency": "EUR",
    "inclusions": [
      "flight tracking",
      "60-minutes waiting time",
      "bottle of water",
      "tolls and taxes",
      "meet & greet"
    ],
    "exclusions": [
      "food",
      "drinks",
      "gratuity"
    ],
    "images": [
      "https://upcdn.io/FW25b8h/raw/products/Pmpei3-Epdv.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-2rDP.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-75St.jpg",
      "https://upcdn.io/FW25b8h/raw/products/Pompei2-24fJ.jpeg",
      "https://upcdn.io/FW25b8h/raw/products/Pompai1-6Gvh.jpeg"
    ],
    "cancellationPolicy": [
      "To receive a Full Refund, cancellations must be made at least 24 Hours prior to the start time of the experience.",
      "If you cancel less than 24 Hours before the experience's start time, the amount you paid will not be refunded.",
      "Changes made less than 24 Hours before the experience's start time will not be accepted."
    ],
    "meetingPoints": [
      "Naples Airport arrival hall"
    ],
    "createdAt": "2025-12-21T15:35:20.812Z",
    "updatedAt": "2025-12-21T15:35:20.812Z",
    "importantInformation": [
      "2h stop in Pompi include",
      "tickets is not included"
    ],
    "timeZone": "Europe/Rome",
    "type": "PRIVATE_TRANSFER",
    "productCode": "A28-TR-01155",
    "pickupRequired": true,
    "dropoffRequired": false,
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "Audi A8 or similar",
        "reference": "5dca9af9edceaa58fa3e84b3",
        "restrictions": {
          "minUnits": 0,
          "maxUnits": 2
        },
        "units": [
          {}
        ]
      }
    ]
  },
  "optionId": "DEFAULT",
  "option": {
    "id": "DEFAULT",
    "default": true,
    "internalName": "Audi A8 or similar",
    "reference": "5dca9af9edceaa58fa3e84b3",
    "restrictions": {
      "minUnits": 0,
      "maxUnits": 2
    },
    "units": [
      {}
    ]
  },
  "cancellable": true,
  "cancellation": {
    "refund": "FULL_REFUND",
    "reason": "Lorem impsun",
    "utcCancelledAt": "2025-12-21T15:35:20.812Z"
  },
  "availabilityId": "2024-09-30T14:00:00+00:00",
  "availability": {
    "id": "2024-09-30T14:00:00+00:00",
    "openingHours": [],
    "status": "AVAILABLE",
    "available": true,
    "capacity": 2,
    "localDate": "2024-09-30",
    "startTime": "14:00",
    "pricing": {
      "basePrice": 47.03,
      "netPrice": 69.16,
      "fees": [
        {
          "name": "Night Fees",
          "net": 15,
          "description": "Night Fees"
        }
      ],
      "totalPrice": 84.16
    }
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[e-mail]",
    "phoneNumber": "[phone]",
    "postalCode": "80147",
    "country": "Italy",
    "notes": "Lorem impsun"
  },
  "notes": "Lorem impsun"
}

Booking Cancellation

Booking Cancellation

post

For cancelling bookings. - Note You can only cancel a booking if booking.cancellable is TRUE, and is within the booking cancellation cut-off window.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The booking id.

Body

application/json

reasonstringOptional

A text value explaining the reason for the cancellation.

Example: Lorem ipsum dolor sit amet

Responses

200

Object of booking

application/json

post

/bookings/{id}/cancel (Products)

JS

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "reason": "Lorem ipsum"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch('/bookings/cancel', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

200

Object of booking

{
  "uuid": "ecdcef4c-462b-400d-9e0e-d48f8871a985",
  "status": "ON_HOLD",
  "utcCreatedAt": "2025-12-21T15:35:20.812Z",
  "utcUpdatedAt": "2025-12-21T15:35:20.812Z",
  "utcExpiresAt": "2025-12-21T15:35:20.812Z",
  "utcRedeemedAt": "2025-12-21T15:35:20.812Z",
  "utcConfirmedAt": "2025-12-21T15:35:20.812Z",
  "productId": "66d9cda3026dcae628481e4b",
  "product": {
    "id": "66d9cda3026dcae628481e4b",
    "internalName": "Arrival transfer From Naples to Sorrento with 2 h stops on Pompei",
    "description": "<p><span style=\"color: rgb(0, 0, 0);\">Discover the hidden gems of Naples, Italy with the transfers to Sorrento with a stop on Pompeii! Enjoy the luxury of a private driver and vehicle to take you to the places you want to go, at the time that suits you. Marvel at the stunning views from the top of Mount Vesuvius or explore the ancient ruins of Pompeii, both just a short drive away. Take a stroll through the picturesque streets of the historic center and indulge in delicious local cuisine. Visit the grand Royal Palace, the iconic Castel dell'Ovo, or the vibrant Piazza del Plebiscito. include 2 h. stop on Pompai </span></p>",
    "category": "LUXURY",
    "currency": "EUR",
    "inclusions": [
      "flight tracking",
      "60-minutes waiting time",
      "bottle of water",
      "tolls and taxes",
      "meet & greet"
    ],
    "exclusions": [
      "food",
      "drinks",
      "gratuity"
    ],
    "images": [
      "https://upcdn.io/FW25b8h/raw/products/Pmpei3-Epdv.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-2rDP.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-75St.jpg",
      "https://upcdn.io/FW25b8h/raw/products/Pompei2-24fJ.jpeg",
      "https://upcdn.io/FW25b8h/raw/products/Pompai1-6Gvh.jpeg"
    ],
    "cancellationPolicy": [
      "To receive a Full Refund, cancellations must be made at least 24 Hours prior to the start time of the experience.",
      "If you cancel less than 24 Hours before the experience's start time, the amount you paid will not be refunded.",
      "Changes made less than 24 Hours before the experience's start time will not be accepted."
    ],
    "meetingPoints": [
      "Naples Airport arrival hall"
    ],
    "createdAt": "2025-12-21T15:35:20.812Z",
    "updatedAt": "2025-12-21T15:35:20.812Z",
    "importantInformation": [
      "2h stop in Pompi include",
      "tickets is not included"
    ],
    "timeZone": "Europe/Rome",
    "type": "PRIVATE_TRANSFER",
    "productCode": "A28-TR-01155",
    "pickupRequired": true,
    "dropoffRequired": false,
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "Audi A8 or similar",
        "reference": "5dca9af9edceaa58fa3e84b3",
        "restrictions": {
          "minUnits": 0,
          "maxUnits": 2
        },
        "units": [
          {}
        ]
      }
    ]
  },
  "optionId": "DEFAULT",
  "option": {
    "id": "DEFAULT",
    "default": true,
    "internalName": "Audi A8 or similar",
    "reference": "5dca9af9edceaa58fa3e84b3",
    "restrictions": {
      "minUnits": 0,
      "maxUnits": 2
    },
    "units": [
      {}
    ]
  },
  "cancellable": true,
  "cancellation": {
    "refund": "FULL_REFUND",
    "reason": "Lorem impsun",
    "utcCancelledAt": "2025-12-21T15:35:20.812Z"
  },
  "availabilityId": "2024-09-30T14:00:00+00:00",
  "availability": {
    "id": "2024-09-30T14:00:00+00:00",
    "openingHours": [],
    "status": "AVAILABLE",
    "available": true,
    "capacity": 2,
    "localDate": "2024-09-30",
    "startTime": "14:00",
    "pricing": {
      "basePrice": 47.03,
      "netPrice": 69.16,
      "fees": [
        {
          "name": "Night Fees",
          "net": 15,
          "description": "Night Fees"
        }
      ],
      "totalPrice": 84.16
    }
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[e-mail]",
    "phoneNumber": "[phone]",
    "postalCode": "80147",
    "country": "Italy",
    "notes": "Lorem impsun"
  },
  "notes": "Lorem impsun"
}

Get Bookings

Get Bookings

get

Get full booking details for all bookings

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pagenumberOptional

Specifies the page number of the results to retrieve. This parameter is used to paginate the query results, allowing users to navigate between different pages of data.

Example: 1

limitnumberOptional

Specifies the maximum number of results to retrieve per page. This parameter controls how many items will be returned on each page of the response.

Example: 100

sortstringOptional

Defines the field by which to sort the results. This parameter allows users to specify which property of the data will be used to order the list of results.

Example: PRICE

orderstringOptional

Determines the order in which results are returned. Allowed values are 'Descending' for sorting results in descending order (from highest to lowest), and 'Ascending' for sorting results in ascending order (from lowest to highest).

Example: DESCENDING

typestringOptional

Determines the type of bookings.

Example: Product

Responses

200

An object

application/json

get

/bookings (Products)

JS

const myHeaders = new Headers();

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch('/bookings?page=1&limit=100&sort=CREATED&order=DESCENDING', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

200

An object

{
  "totalPages": 1,
  "pageNumber": 1,
  "pageSize": 1,
  "count": 1,
  "bookings": [
    {
      "uuid": "ecdcef4c-462b-400d-9e0e-d48f8871a985",
      "status": "ON_HOLD",
      "utcCreatedAt": "2025-12-21T15:35:20.812Z",
      "utcUpdatedAt": "2025-12-21T15:35:20.812Z",
      "utcExpiresAt": "2025-12-21T15:35:20.812Z",
      "utcRedeemedAt": "2025-12-21T15:35:20.812Z",
      "utcConfirmedAt": "2025-12-21T15:35:20.812Z",
      "productId": "66d9cda3026dcae628481e4b",
      "product": {
        "id": "66d9cda3026dcae628481e4b",
        "internalName": "Arrival transfer From Naples to Sorrento with 2 h stops on Pompei",
        "description": "<p><span style=\"color: rgb(0, 0, 0);\">Discover the hidden gems of Naples, Italy with the transfers to Sorrento with a stop on Pompeii! Enjoy the luxury of a private driver and vehicle to take you to the places you want to go, at the time that suits you. Marvel at the stunning views from the top of Mount Vesuvius or explore the ancient ruins of Pompeii, both just a short drive away. Take a stroll through the picturesque streets of the historic center and indulge in delicious local cuisine. Visit the grand Royal Palace, the iconic Castel dell'Ovo, or the vibrant Piazza del Plebiscito. include 2 h. stop on Pompai </span></p>",
        "category": "LUXURY",
        "currency": "EUR",
        "inclusions": [
          "flight tracking",
          "60-minutes waiting time",
          "bottle of water",
          "tolls and taxes",
          "meet & greet"
        ],
        "exclusions": [
          "food",
          "drinks",
          "gratuity"
        ],
        "images": [
          "https://upcdn.io/FW25b8h/raw/products/Pmpei3-Epdv.jpg",
          "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-2rDP.jpg",
          "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-75St.jpg",
          "https://upcdn.io/FW25b8h/raw/products/Pompei2-24fJ.jpeg",
          "https://upcdn.io/FW25b8h/raw/products/Pompai1-6Gvh.jpeg"
        ],
        "cancellationPolicy": [
          "To receive a Full Refund, cancellations must be made at least 24 Hours prior to the start time of the experience.",
          "If you cancel less than 24 Hours before the experience's start time, the amount you paid will not be refunded.",
          "Changes made less than 24 Hours before the experience's start time will not be accepted."
        ],
        "meetingPoints": [
          "Naples Airport arrival hall"
        ],
        "createdAt": "2025-12-21T15:35:20.812Z",
        "updatedAt": "2025-12-21T15:35:20.812Z",
        "importantInformation": [
          "2h stop in Pompi include",
          "tickets is not included"
        ],
        "timeZone": "Europe/Rome",
        "type": "PRIVATE_TRANSFER",
        "productCode": "A28-TR-01155",
        "pickupRequired": true,
        "dropoffRequired": false,
        "options": [
          {
            "id": "DEFAULT",
            "default": true,
            "internalName": "Audi A8 or similar",
            "reference": "5dca9af9edceaa58fa3e84b3",
            "restrictions": {
              "minUnits": 0,
              "maxUnits": 2
            },
            "units": [
              {}
            ]
          }
        ]
      },
      "optionId": "DEFAULT",
      "option": {
        "id": "DEFAULT",
        "default": true,
        "internalName": "Audi A8 or similar",
        "reference": "5dca9af9edceaa58fa3e84b3",
        "restrictions": {
          "minUnits": 0,
          "maxUnits": 2
        },
        "units": [
          {}
        ]
      },
      "cancellable": true,
      "cancellation": {
        "refund": "FULL_REFUND",
        "reason": "Lorem impsun",
        "utcCancelledAt": "2025-12-21T15:35:20.812Z"
      },
      "availabilityId": "2024-09-30T14:00:00+00:00",
      "availability": {
        "id": "2024-09-30T14:00:00+00:00",
        "openingHours": [],
        "status": "AVAILABLE",
        "available": true,
        "capacity": 2,
        "localDate": "2024-09-30",
        "startTime": "14:00",
        "pricing": {
          "basePrice": 47.03,
          "netPrice": 69.16,
          "fees": [
            {
              "name": "Night Fees",
              "net": 15,
              "description": "Night Fees"
            }
          ],
          "totalPrice": 84.16
        }
      },
      "contact": {
        "fullName": "John Doe",
        "firstName": "John",
        "lastName": "Doe",
        "emailAddress": "[e-mail]",
        "phoneNumber": "[phone]",
        "postalCode": "80147",
        "country": "Italy",
        "notes": "Lorem impsun"
      },
      "notes": "Lorem impsun"
    }
  ]
}

Get Booking

Get Booking

get

Get the details of an existing booking.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The booking id.

Responses

200

Object of booking

application/json

get

/bookings/{id} (Products)

JS

const myHeaders = new Headers();

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch('/bookings/', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

200

Object of booking

{
  "uuid": "ecdcef4c-462b-400d-9e0e-d48f8871a985",
  "status": "ON_HOLD",
  "utcCreatedAt": "2025-12-21T15:35:20.812Z",
  "utcUpdatedAt": "2025-12-21T15:35:20.812Z",
  "utcExpiresAt": "2025-12-21T15:35:20.812Z",
  "utcRedeemedAt": "2025-12-21T15:35:20.812Z",
  "utcConfirmedAt": "2025-12-21T15:35:20.812Z",
  "productId": "66d9cda3026dcae628481e4b",
  "product": {
    "id": "66d9cda3026dcae628481e4b",
    "internalName": "Arrival transfer From Naples to Sorrento with 2 h stops on Pompei",
    "description": "<p><span style=\"color: rgb(0, 0, 0);\">Discover the hidden gems of Naples, Italy with the transfers to Sorrento with a stop on Pompeii! Enjoy the luxury of a private driver and vehicle to take you to the places you want to go, at the time that suits you. Marvel at the stunning views from the top of Mount Vesuvius or explore the ancient ruins of Pompeii, both just a short drive away. Take a stroll through the picturesque streets of the historic center and indulge in delicious local cuisine. Visit the grand Royal Palace, the iconic Castel dell'Ovo, or the vibrant Piazza del Plebiscito. include 2 h. stop on Pompai </span></p>",
    "category": "LUXURY",
    "currency": "EUR",
    "inclusions": [
      "flight tracking",
      "60-minutes waiting time",
      "bottle of water",
      "tolls and taxes",
      "meet & greet"
    ],
    "exclusions": [
      "food",
      "drinks",
      "gratuity"
    ],
    "images": [
      "https://upcdn.io/FW25b8h/raw/products/Pmpei3-Epdv.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-2rDP.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-75St.jpg",
      "https://upcdn.io/FW25b8h/raw/products/Pompei2-24fJ.jpeg",
      "https://upcdn.io/FW25b8h/raw/products/Pompai1-6Gvh.jpeg"
    ],
    "cancellationPolicy": [
      "To receive a Full Refund, cancellations must be made at least 24 Hours prior to the start time of the experience.",
      "If you cancel less than 24 Hours before the experience's start time, the amount you paid will not be refunded.",
      "Changes made less than 24 Hours before the experience's start time will not be accepted."
    ],
    "meetingPoints": [
      "Naples Airport arrival hall"
    ],
    "createdAt": "2025-12-21T15:35:20.812Z",
    "updatedAt": "2025-12-21T15:35:20.812Z",
    "importantInformation": [
      "2h stop in Pompi include",
      "tickets is not included"
    ],
    "timeZone": "Europe/Rome",
    "type": "PRIVATE_TRANSFER",
    "productCode": "A28-TR-01155",
    "pickupRequired": true,
    "dropoffRequired": false,
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "Audi A8 or similar",
        "reference": "5dca9af9edceaa58fa3e84b3",
        "restrictions": {
          "minUnits": 0,
          "maxUnits": 2
        },
        "units": [
          {}
        ]
      }
    ]
  },
  "optionId": "DEFAULT",
  "option": {
    "id": "DEFAULT",
    "default": true,
    "internalName": "Audi A8 or similar",
    "reference": "5dca9af9edceaa58fa3e84b3",
    "restrictions": {
      "minUnits": 0,
      "maxUnits": 2
    },
    "units": [
      {}
    ]
  },
  "cancellable": true,
  "cancellation": {
    "refund": "FULL_REFUND",
    "reason": "Lorem impsun",
    "utcCancelledAt": "2025-12-21T15:35:20.812Z"
  },
  "availabilityId": "2024-09-30T14:00:00+00:00",
  "availability": {
    "id": "2024-09-30T14:00:00+00:00",
    "openingHours": [],
    "status": "AVAILABLE",
    "available": true,
    "capacity": 2,
    "localDate": "2024-09-30",
    "startTime": "14:00",
    "pricing": {
      "basePrice": 47.03,
      "netPrice": 69.16,
      "fees": [
        {
          "name": "Night Fees",
          "net": 15,
          "description": "Night Fees"
        }
      ],
      "totalPrice": 84.16
    }
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[e-mail]",
    "phoneNumber": "[phone]",
    "postalCode": "80147",
    "country": "Italy",
    "notes": "Lorem impsun"
  },
  "notes": "Lorem impsun"
}

Booking Update

Booking Update

patch

Updates a booking before and after it has been confirmed as long as it hasn''t been redeemed or within the cancellation cutoff window. To know if the booking can be updated check the booking''s cancellable field. If the booking can be cancelled, it can also be updated. It''s generally preferred to update a booking rather than cancelling it and rebooking.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The booking id.

Body

application/json

availabilityIdstringRequired

The availability id for this booking.

Example: 2024-09-30T14:00:00+00:00

emailReceiptstringOptional

Whether you want RhonTrip Cloud to email the guest a copy of their receipt. (defaults to false)

Example: [e-mail]

expirationMinutesnumberOptional

This attribute extends the ON_HOLD status of the reserve and its value is represented in minutes (Min 20 - Max 200).

Example: 344

optionIdstringRequired

The option id for this booking.

Example: DEFAULT

productIdstringRequired

The product id for this booking.

Example: 66d9cda3026dcae628481e4b

resellerReferencestringRequired

Your reference for this booking.

Example: asda343

Responses

200

Object of booking

application/json

patch

/bookings/{id} (Products)

JS

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "resellerReference": "asda343",
  "emailReceipt": "[e-mail]",
  "productId": "65981a24d09fc62f079ed751",
  "optionId": "DEFAULT",
  "availabilityId": "2024-05-26T00:00:00-05:00",
  "expirationMinutes": 344,
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[e-mail]",
    "phoneNumber": "345345355345",
    "postalCode": 2323,
    "country": "US",
    "notes": "Lorem ipsum"
  }
});

const requestOptions = {
  method: "PATCH",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch('/bookings/', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

200

Object of booking

{
  "uuid": "ecdcef4c-462b-400d-9e0e-d48f8871a985",
  "status": "ON_HOLD",
  "utcCreatedAt": "2025-12-21T15:35:20.812Z",
  "utcUpdatedAt": "2025-12-21T15:35:20.812Z",
  "utcExpiresAt": "2025-12-21T15:35:20.812Z",
  "utcRedeemedAt": "2025-12-21T15:35:20.812Z",
  "utcConfirmedAt": "2025-12-21T15:35:20.812Z",
  "productId": "66d9cda3026dcae628481e4b",
  "product": {
    "id": "66d9cda3026dcae628481e4b",
    "internalName": "Arrival transfer From Naples to Sorrento with 2 h stops on Pompei",
    "description": "<p><span style=\"color: rgb(0, 0, 0);\">Discover the hidden gems of Naples, Italy with the transfers to Sorrento with a stop on Pompeii! Enjoy the luxury of a private driver and vehicle to take you to the places you want to go, at the time that suits you. Marvel at the stunning views from the top of Mount Vesuvius or explore the ancient ruins of Pompeii, both just a short drive away. Take a stroll through the picturesque streets of the historic center and indulge in delicious local cuisine. Visit the grand Royal Palace, the iconic Castel dell'Ovo, or the vibrant Piazza del Plebiscito. include 2 h. stop on Pompai </span></p>",
    "category": "LUXURY",
    "currency": "EUR",
    "inclusions": [
      "flight tracking",
      "60-minutes waiting time",
      "bottle of water",
      "tolls and taxes",
      "meet & greet"
    ],
    "exclusions": [
      "food",
      "drinks",
      "gratuity"
    ],
    "images": [
      "https://upcdn.io/FW25b8h/raw/products/Pmpei3-Epdv.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-2rDP.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-75St.jpg",
      "https://upcdn.io/FW25b8h/raw/products/Pompei2-24fJ.jpeg",
      "https://upcdn.io/FW25b8h/raw/products/Pompai1-6Gvh.jpeg"
    ],
    "cancellationPolicy": [
      "To receive a Full Refund, cancellations must be made at least 24 Hours prior to the start time of the experience.",
      "If you cancel less than 24 Hours before the experience's start time, the amount you paid will not be refunded.",
      "Changes made less than 24 Hours before the experience's start time will not be accepted."
    ],
    "meetingPoints": [
      "Naples Airport arrival hall"
    ],
    "createdAt": "2025-12-21T15:35:20.812Z",
    "updatedAt": "2025-12-21T15:35:20.812Z",
    "importantInformation": [
      "2h stop in Pompi include",
      "tickets is not included"
    ],
    "timeZone": "Europe/Rome",
    "type": "PRIVATE_TRANSFER",
    "productCode": "A28-TR-01155",
    "pickupRequired": true,
    "dropoffRequired": false,
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "Audi A8 or similar",
        "reference": "5dca9af9edceaa58fa3e84b3",
        "restrictions": {
          "minUnits": 0,
          "maxUnits": 2
        },
        "units": [
          {}
        ]
      }
    ]
  },
  "optionId": "DEFAULT",
  "option": {
    "id": "DEFAULT",
    "default": true,
    "internalName": "Audi A8 or similar",
    "reference": "5dca9af9edceaa58fa3e84b3",
    "restrictions": {
      "minUnits": 0,
      "maxUnits": 2
    },
    "units": [
      {}
    ]
  },
  "cancellable": true,
  "cancellation": {
    "refund": "FULL_REFUND",
    "reason": "Lorem impsun",
    "utcCancelledAt": "2025-12-21T15:35:20.812Z"
  },
  "availabilityId": "2024-09-30T14:00:00+00:00",
  "availability": {
    "id": "2024-09-30T14:00:00+00:00",
    "openingHours": [],
    "status": "AVAILABLE",
    "available": true,
    "capacity": 2,
    "localDate": "2024-09-30",
    "startTime": "14:00",
    "pricing": {
      "basePrice": 47.03,
      "netPrice": 69.16,
      "fees": [
        {
          "name": "Night Fees",
          "net": 15,
          "description": "Night Fees"
        }
      ],
      "totalPrice": 84.16
    }
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[e-mail]",
    "phoneNumber": "[phone]",
    "postalCode": "80147",
    "country": "Italy",
    "notes": "Lorem impsun"
  },
  "notes": "Lorem impsun"
}

Extend Reservation

Extend Reservation

post

Use this endpoint to hold the availability for a booking longer if the status is ON_HOLD.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The booking id.

Body

application/json

expirationMinutesnumberRequired

This attribute extends the ON_HOLD status of the reserve and its value is represented in minutes (Min 20 - Max 200).

Example: 200

Responses

200

Object of booking

application/json

post

/bookings/{id}/extend (Products)

JS

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "expirationMinutes": 200
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch('/bookings/extend', requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

200

Object of booking

{
  "uuid": "ecdcef4c-462b-400d-9e0e-d48f8871a985",
  "status": "ON_HOLD",
  "utcCreatedAt": "2025-12-21T15:35:20.812Z",
  "utcUpdatedAt": "2025-12-21T15:35:20.812Z",
  "utcExpiresAt": "2025-12-21T15:35:20.812Z",
  "utcRedeemedAt": "2025-12-21T15:35:20.812Z",
  "utcConfirmedAt": "2025-12-21T15:35:20.812Z",
  "productId": "66d9cda3026dcae628481e4b",
  "product": {
    "id": "66d9cda3026dcae628481e4b",
    "internalName": "Arrival transfer From Naples to Sorrento with 2 h stops on Pompei",
    "description": "<p><span style=\"color: rgb(0, 0, 0);\">Discover the hidden gems of Naples, Italy with the transfers to Sorrento with a stop on Pompeii! Enjoy the luxury of a private driver and vehicle to take you to the places you want to go, at the time that suits you. Marvel at the stunning views from the top of Mount Vesuvius or explore the ancient ruins of Pompeii, both just a short drive away. Take a stroll through the picturesque streets of the historic center and indulge in delicious local cuisine. Visit the grand Royal Palace, the iconic Castel dell'Ovo, or the vibrant Piazza del Plebiscito. include 2 h. stop on Pompai </span></p>",
    "category": "LUXURY",
    "currency": "EUR",
    "inclusions": [
      "flight tracking",
      "60-minutes waiting time",
      "bottle of water",
      "tolls and taxes",
      "meet & greet"
    ],
    "exclusions": [
      "food",
      "drinks",
      "gratuity"
    ],
    "images": [
      "https://upcdn.io/FW25b8h/raw/products/Pmpei3-Epdv.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-2rDP.jpg",
      "https://upcdn.io/FW25b8h/raw/vehicles/gallery/minivan/mercedes-benz/vito/mercedes-benz-minivan-vito-75St.jpg",
      "https://upcdn.io/FW25b8h/raw/products/Pompei2-24fJ.jpeg",
      "https://upcdn.io/FW25b8h/raw/products/Pompai1-6Gvh.jpeg"
    ],
    "cancellationPolicy": [
      "To receive a Full Refund, cancellations must be made at least 24 Hours prior to the start time of the experience.",
      "If you cancel less than 24 Hours before the experience's start time, the amount you paid will not be refunded.",
      "Changes made less than 24 Hours before the experience's start time will not be accepted."
    ],
    "meetingPoints": [
      "Naples Airport arrival hall"
    ],
    "createdAt": "2025-12-21T15:35:20.812Z",
    "updatedAt": "2025-12-21T15:35:20.812Z",
    "importantInformation": [
      "2h stop in Pompi include",
      "tickets is not included"
    ],
    "timeZone": "Europe/Rome",
    "type": "PRIVATE_TRANSFER",
    "productCode": "A28-TR-01155",
    "pickupRequired": true,
    "dropoffRequired": false,
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "Audi A8 or similar",
        "reference": "5dca9af9edceaa58fa3e84b3",
        "restrictions": {
          "minUnits": 0,
          "maxUnits": 2
        },
        "units": [
          {}
        ]
      }
    ]
  },
  "optionId": "DEFAULT",
  "option": {
    "id": "DEFAULT",
    "default": true,
    "internalName": "Audi A8 or similar",
    "reference": "5dca9af9edceaa58fa3e84b3",
    "restrictions": {
      "minUnits": 0,
      "maxUnits": 2
    },
    "units": [
      {}
    ]
  },
  "cancellable": true,
  "cancellation": {
    "refund": "FULL_REFUND",
    "reason": "Lorem impsun",
    "utcCancelledAt": "2025-12-21T15:35:20.812Z"
  },
  "availabilityId": "2024-09-30T14:00:00+00:00",
  "availability": {
    "id": "2024-09-30T14:00:00+00:00",
    "openingHours": [],
    "status": "AVAILABLE",
    "available": true,
    "capacity": 2,
    "localDate": "2024-09-30",
    "startTime": "14:00",
    "pricing": {
      "basePrice": 47.03,
      "netPrice": 69.16,
      "fees": [
        {
          "name": "Night Fees",
          "net": 15,
          "description": "Night Fees"
        }
      ],
      "totalPrice": 84.16
    }
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[e-mail]",
    "phoneNumber": "[phone]",
    "postalCode": "80147",
    "country": "Italy",
    "notes": "Lorem impsun"
  },
  "notes": "Lorem impsun"
}