Send a booking request
request_bookingDestructiveIdempotent
Sends the quoted ride as a booking request. Call ONLY after the customer has seen the quoted total and how they pay, and has explicitly approved it and accepted the Terms (https://www.feminiqrides.nl/terms.html). Send exactly the same ride fields as the get_quote call plus its unchanged quoteToken and the customer's contact details. Nothing is charged now. The customer first gets an email with a Confirm link (valid 24 hours); after that click Feminiq Rides confirms personally and emails a SumUp payment request. Returns groupId and groupToken; pass them as joinGroup {groupId, groupToken} on further rides so they are confirmed and paid together (the result says grouped true or false). Repeating the identical call does not create a second booking.
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>",
"quoteToken": "<quoteToken>",
"name": "<name>",
"email": "<email>",
"phone": "<phone>",
"acceptedTerms": "<acceptedTerms>"
},
"name": "request_booking"
}
}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. | |
| name | Yes | ||
| time | Yes | Local time in Europe/Amsterdam, between 04:00 and 20:00. | |
| type | Yes | ||
| Yes | |||
| notes | No | ||
| phone | Yes | Customer's phone number, with country code (for example +31 6 1234 5678). | |
| 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. | |
| joinGroup | No | Optional. Adds this ride to an earlier request so the customer pays for all of them with ONE payment request. Pass the groupId and groupToken that request_booking returned for the earlier request, as {groupId, groupToken} ({id, token} also works). The result says grouped true or false; false means the ride stands alone (see joinRefused) and gets its own Confirm link and payment request. | |
| 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 | ||
| quoteToken | Yes | Signed token returned by POST /api/quote. Send unchanged only after the customer approves that quote's total and payment. It binds the normalized journey, vehicle, passengers, payment choice, return trip, options, fare, rules version and 15-minute expiry. HTTP 409 reviewRequired=true means obtain a new quote and renewed customer approval before retrying. Never supply your own price. | |
| 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). | |
| acceptedTerms | Yes | Must be an explicit act by the customer after reading the Terms & Conditions. Agents must not set this on a customer's behalf without their consent. | |
| ticketService | No | Tours only: attraction ticket purchase assistance, requires 28 days' notice. |