Get a price for a ride
get_quoteRead-onlyIdempotent
Exact price and rule check for one ride (no booking, no email, no payment). Returns the total, any online deposit and a quoteToken valid for 15 minutes. Per type: fixed needs routeId, direction and address; custom needs pickup and dropoff; tour needs tourIds and pickup. Fixed fares only apply inside each route's zone: error address_zone means quote a custom ride instead. Does not check driver availability.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"type": "<type>",
"car": "<car>",
"date": "<date>",
"time": "<time>",
"passengers": "<passengers>"
},
"name": "get_quote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| car | Yes | BMW 5 Series Touring (bmw5) max 4 passengers, Mercedes V-Class (vclass) max 7 passengers. | |
| date | Yes | Local date in Europe/Amsterdam. | |
| lang | No | Language of the emails the customer receives (the Confirm link, status and payment mails) and of the quote card. Use the customer's own language; default en. | |
| time | Yes | Local time in Europe/Amsterdam, between 04:00 and 20:00. | |
| type | Yes | ||
| notes | No | ||
| flight | No | ||
| pickup | No | Required for custom rides and tours: agreed pickup address or hotel, preserved in review and confirmations. | |
| address | No | Fixed routes only: the non-airport pickup/drop-off address. The fare follows the route zone of the address (postcode first, then town name; a hotel or town named without a postcode is placed by a server-side lookup, and the selected route applies if that lookup fails). An address whose Dutch postcode is in no fixed-route zone is refused with error code address_zone; book it as a single ride. | |
| dropoff | No | Required for custom rides: drop-off address. | |
| payment | No | How the customer pays once the ride is confirmed: deposit = a payment request for 25% of the price, rest on the day of the ride; full = a payment request for the full price. With a returnTrip both legs are confirmed together and paid with ONE payment request on these terms (the sum over the legs). | deposit |
| routeId | No | Fixed routes only; ids from /data/rates.json. The server reprices to the route the address belongs to. | |
| tourIds | No | Tours only; ids from /data/tours.json. | |
| direction | No | Fixed routes only: to or from Schiphol. | |
| driverName | No | Optional. Name of a preferred driver, printed as "Driver: ..." in the customer's confirmation and calendar file. Leave it out unless the customer asks for a specific driver; it is not the passenger's name. | |
| passengers | Yes | ||
| returnTrip | No | Airport transfers (fixed) and custom rides only; tours fail with retour_type, and a value that is not an object fails with retour. Books the return leg as well, with the same vehicle, passengers and luggage: on a fixed route the opposite direction between the same address and Schiphol, priced as a second ride at the route price; on a custom ride from the drop-off back to the pickup, where the fare estimate covers both legs and is split evenly over them. The return must be at least one hour after the first ride (retour_order), between 04:00 and 20:00 (retour_hours), not on a blocked date (retour_date_blocked) and at most 2 years ahead (date_range); missing or invalid values fail with retour_date, retour_time or retour_datetime. There is no name card on either leg (meet_greet_unavailable). The request is stored as two linked bookings, bookingId and `<bookingId>-ret` (so bookingId may have at most 51 characters when a returnTrip is sent), confirmed together and paid with one payment request: 25% of the combined price of the legs, or all of it with payment=full. | |
| luggageLarge | No | Large check-in suitcases. The BMW takes at most 3; more needs the V-Class (error code luggage). | |
| luggageSmall | No | Pieces of hand luggage. The BMW takes at most 3; more needs the V-Class (error code luggage). | |
| ticketService | No | Tours only: attraction ticket purchase assistance, requires 28 days' notice. |