Products (In Progress)

These endpoints enable listing all products, filtering by specific criteria, and retrieving detailed information about individual products.

Get Products

Get Products

get

Get full product details for all products

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

Responses

200

An object

application/json

get

/products

JS

const requestOptions = {
  method: 'GET',
  headers: {
    "Content-Type": "application/json"
  },
  redirect: 'follow'
};

fetch('/products?page=1&limit=100&sort=PRICE&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,
  "products": [
    {
      "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-19T22:52:18.380Z",
      "updatedAt": "2025-12-19T22:52:18.380Z",
      "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": [
            {}
          ]
        }
      ]
    }
  ]
}

Search Products

Get Products By Search Criteria

post

Returns a list of filtered, ordered and sorted product summaries for products that match the given search criteria.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

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: 2

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

countriesstring[]Optional

List of country codes in ISO 3166-1 alpha-2 format where the product is available

Example: ["CO"]

destinationsstring[]Optional

List of internal slugs for cities where the product is available.

Example: ["CO"]

productTypestringOptional

Type of the product. Possible values are PRIVATE_TRANSFER Exclusive transportation service for individual or group transfers, TOURS Organized excursions or trips to various destinations or attractions, EVENT Specific activities or occasions, such as concerts, conferences, or festivals and ATTRACTION Places of interest or activities designed for entertainment, education, or cultural experiences

Example: PRIVATE_TRANSFER

currencystringOptional

Currency in which the product is priced, in ISO 4217 format

Example: USD

maxRatingnumberOptional

Maximum rating for the product, typically between 1 and 5

Example: 5

minRatingnumberOptional

Minimum rating for the product, typically between 1 and 5

Example: 1

Responses

200

An object

application/json

post

/products/search

JS

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

const raw = JSON.stringify({
  "order": "DESCENDING",
  "limit": 100,
  "page": 1
});

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

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

200

An object

[
  {
    "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-19T22:52:18.380Z",
    "updatedAt": "2025-12-19T22:52:18.380Z",
    "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": [
          {}
        ]
      }
    ]
  }
]

Get Product

Get Product by id

get

Get full product details for a single product.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

product id

Responses

200

A product object

application/json

get

/products/{id}

JS

const requestOptions = {
  method: 'GET',
  headers: {
    "Content-Type": "application/json"
  },
  redirect: 'follow'
};

const response = await fetch('/products/{productId}', requestOptions);
const result = await response.json();
console.log(result);

200

A product object

{
  "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-19T22:52:18.380Z",
  "updatedAt": "2025-12-19T22:52:18.380Z",
  "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": [
        {}
      ]
    }
  ]
}