Raw schema
{
"type": "object",
"properties": {
"pickup": {
"type": "string",
"minLength": 4,
"maxLength": 180,
"description": "Required for custom rides and tours: agreed pickup address or hotel, preserved in review and confirmations."
},
"dropoff": {
"type": "string",
"minLength": 4,
"maxLength": 180,
"description": "Required for custom rides: drop-off address."
},
"tourIds": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"amsterdam-city-tour",
"countryside-tour",
"keukenhof-tour",
"aalsmeer-flower-auction",
"dutch-water-defence-line",
"giethoorn-day-trip",
"south-holland-tour",
"rotterdam-kinderdijk",
"kroller-muller",
"efteling-day-trip",
"bruges-day-trip",
"roermond-outlet",
"mall-of-the-netherlands",
"batavia-stad",
"style-outlet-amsterdam"
]
},
"minItems": 1,
"maxItems": 5,
"description": "Tours only; ids from /data/tours.json."
},
"type": {
"type": "string",
"enum": [
"fixed",
"custom",
"tour"
]
},
"car": {
"type": "string",
"enum": [
"eclass",
"sclass",
"vclass"
],
"description": "E-Class max 4, S-Class max 2, V-Class max 7 passengers."
},
"date": {
"type": "string",
"format": "date",
"description": "Local date in Europe/Amsterdam."
},
"time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Local time in Europe/Amsterdam, between 04:00 and 20:00."
},
"passengers": {
"type": "integer",
"minimum": 1,
"maximum": 7
},
"luggageLarge": {
"type": "integer",
"minimum": 0,
"maximum": 8,
"default": 0,
"description": "Large check-in suitcases. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
},
"luggageSmall": {
"type": "integer",
"minimum": 0,
"maximum": 8,
"default": 0,
"description": "Pieces of hand luggage. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
},
"returnTrip": {
"type": "object",
"description": "Fixed rides only. Books the return leg as well: the opposite direction between the same address and Schiphol, with the same vehicle, passengers and luggage. It is priced as a second ride (plus the name-card fee when meetGreet is set on a return that starts at Schiphol). It must be at least one hour after the first ride, between 04:00 and 20:00, and not on a blocked date. Error codes: retour_type, retour, retour_datetime, retour_hours, retour_date_blocked, retour_order. The booking is stored as two linked bookings: the request id and `<id>-ret`.",
"properties": {
"date": {
"type": "string",
"format": "date"
},
"time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$"
},
"flight": {
"type": "string",
"maxLength": 24
},
"meetGreet": {
"type": "boolean",
"default": false
}
},
"required": [
"date",
"time"
]
},
"routeId": {
"type": "string",
"description": "Fixed routes only; ids from /data/rates.json. The server reprices to the route the address belongs to.",
"enum": [
"ams-spl",
"noord-spl",
"zaandam-spl",
"aveen-spl",
"haarlem-spl",
"zandvoort-spl",
"dh-spl",
"rtm-spl",
"almere-spl",
"almere-buiten-spl",
"utrecht-spl"
]
},
"direction": {
"type": "string",
"enum": [
"to",
"from"
],
"description": "Fixed routes only: to or from Schiphol."
},
"address": {
"type": "string",
"minLength": 4,
"maxLength": 180,
"description": "Fixed routes only: the non-airport pickup/drop-off address. The fare follows the route zone of the address (postcode first, then town name). An address whose Dutch postcode is in no fixed-route zone is refused with error code address_zone; book it as a custom ride."
},
"meetGreet": {
"type": "boolean",
"description": "Optional €25 arrivals-area name card; only for direction=from."
},
"ticketService": {
"type": "boolean",
"description": "Tours only: attraction ticket purchase assistance, requires 28 days' notice."
},
"driverName": {
"type": "string",
"maxLength": 60
},
"flight": {
"type": "string",
"maxLength": 24
},
"notes": {
"type": "string",
"maxLength": 1000
},
"lang": {
"type": "string",
"enum": [
"en",
"nl",
"de",
"fr",
"es",
"pt",
"ru",
"ar",
"zh-CN"
]
},
"quoteToken": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "Signed token returned by POST /api/quote. Send unchanged only after the customer approves that quote's total and deposit. It binds the normalized journey, vehicle, passengers, 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."
},
"name": {
"type": "string",
"minLength": 2,
"maxLength": 100
},
"email": {
"type": "string",
"format": "email"
},
"phone": {
"type": "string",
"minLength": 7,
"maxLength": 30,
"description": "Customer's phone number, with country code (for example +31 6 1234 5678)."
},
"acceptedTerms": {
"type": "boolean",
"const": true,
"description": "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."
},
"additionalRides": {
"type": "array",
"maxItems": 4,
"description": "Optional: more rides in the same request (up to 5 in total), each with its own ride fields and the quoteToken of its own get_quote call. Tours and custom rides in the request share one 25% prepayment link; fixed rides stay pay-in-car requests.",
"items": {
"type": "object",
"properties": {
"pickup": {
"type": "string",
"minLength": 4,
"maxLength": 180,
"description": "Required for custom rides and tours: agreed pickup address or hotel, preserved in review and confirmations."
},
"dropoff": {
"type": "string",
"minLength": 4,
"maxLength": 180,
"description": "Required for custom rides: drop-off address."
},
"tourIds": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"amsterdam-city-tour",
"countryside-tour",
"keukenhof-tour",
"aalsmeer-flower-auction",
"dutch-water-defence-line",
"giethoorn-day-trip",
"south-holland-tour",
"rotterdam-kinderdijk",
"kroller-muller",
"efteling-day-trip",
"bruges-day-trip",
"roermond-outlet",
"mall-of-the-netherlands",
"batavia-stad",
"style-outlet-amsterdam"
]
},
"minItems": 1,
"maxItems": 5,
"description": "Tours only; ids from /data/tours.json."
},
"type": {
"type": "string",
"enum": [
"fixed",
"custom",
"tour"
]
},
"car": {
"type": "string",
"enum": [
"eclass",
"sclass",
"vclass"
],
"description": "E-Class max 4, S-Class max 2, V-Class max 7 passengers."
},
"date": {
"type": "string",
"format": "date",
"description": "Local date in Europe/Amsterdam."
},
"time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Local time in Europe/Amsterdam, between 04:00 and 20:00."
},
"passengers": {
"type": "integer",
"minimum": 1,
"maximum": 7
},
"luggageLarge": {
"type": "integer",
"minimum": 0,
"maximum": 8,
"default": 0,
"description": "Large check-in suitcases. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
},
"luggageSmall": {
"type": "integer",
"minimum": 0,
"maximum": 8,
"default": 0,
"description": "Pieces of hand luggage. E-Class and S-Class take at most 2; more needs the V-Class (error code luggage)."
},
"returnTrip": {
"type": "object",
"description": "Fixed rides only. Books the return leg as well: the opposite direction between the same address and Schiphol, with the same vehicle, passengers and luggage. It is priced as a second ride (plus the name-card fee when meetGreet is set on a return that starts at Schiphol). It must be at least one hour after the first ride, between 04:00 and 20:00, and not on a blocked date. Error codes: retour_type, retour, retour_datetime, retour_hours, retour_date_blocked, retour_order. The booking is stored as two linked bookings: the request id and `<id>-ret`.",
"properties": {
"date": {
"type": "string",
"format": "date"
},
"time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$"
},
"flight": {
"type": "string",
"maxLength": 24
},
"meetGreet": {
"type": "boolean",
"default": false
}
},
"required": [
"date",
"time"
]
},
"routeId": {
"type": "string",
"description": "Fixed routes only; ids from /data/rates.json. The server reprices to the route the address belongs to.",
"enum": [
"ams-spl",
"noord-spl",
"zaandam-spl",
"aveen-spl",
"haarlem-spl",
"zandvoort-spl",
"dh-spl",
"rtm-spl",
"almere-spl",
"almere-buiten-spl",
"utrecht-spl"
]
},
"direction": {
"type": "string",
"enum": [
"to",
"from"
],
"description": "Fixed routes only: to or from Schiphol."
},
"address": {
"type": "string",
"minLength": 4,
"maxLength": 180,
"description": "Fixed routes only: the non-airport pickup/drop-off address. The fare follows the route zone of the address (postcode first, then town name). An address whose Dutch postcode is in no fixed-route zone is refused with error code address_zone; book it as a custom ride."
},
"meetGreet": {
"type": "boolean",
"description": "Optional €25 arrivals-area name card; only for direction=from."
},
"ticketService": {
"type": "boolean",
"description": "Tours only: attraction ticket purchase assistance, requires 28 days' notice."
},
"driverName": {
"type": "string",
"maxLength": 60
},
"flight": {
"type": "string",
"maxLength": 24
},
"notes": {
"type": "string",
"maxLength": 1000
},
"lang": {
"type": "string",
"enum": [
"en",
"nl",
"de",
"fr",
"es",
"pt",
"ru",
"ar",
"zh-CN"
]
},
"quoteToken": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "Signed token returned by POST /api/quote. Send unchanged only after the customer approves that quote's total and deposit. It binds the normalized journey, vehicle, passengers, 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."
}
},
"required": [
"type",
"car",
"date",
"time",
"passengers",
"quoteToken"
]
}
}
},
"required": [
"type",
"car",
"date",
"time",
"passengers",
"quoteToken",
"name",
"email",
"phone",
"acceptedTerms"
]
}