Raw schema
{
"type": "object",
"properties": {
"aircraft_category": {
"description": "Optional preference, e.g. Light Jet / Midsize Jet / Heavy Jet",
"type": "string"
},
"client_reference": {
"description": "Optional opaque reference from YOUR OWN system (e.g. your internal order/booking id) for this request. Stored against the trip and echoed back unchanged in the response. Pass it here, then use get_confirmation_status with the returned trip_id to check the outcome later — no webhook needed. Never shown to the client or operator. (optional)",
"type": "string"
},
"departure_date": {
"description": "Departure date, YYYY-MM-DD (REQUIRED)",
"type": "string"
},
"destination": {
"description": "Destination airport — IATA or ICAO code",
"type": "string"
},
"email": {
"description": "Email address to send the confirmed options to (REQUIRED)",
"type": "string"
},
"first_name": {
"description": "Passenger first name (optional)",
"type": "string"
},
"flexible_dates": {
"description": "Are the dates flexible? (optional)",
"type": "boolean"
},
"last_name": {
"description": "Passenger last name (optional)",
"type": "string"
},
"luggage": {
"description": "Extra or outsized luggage? (optional)",
"type": "boolean"
},
"origin": {
"description": "Origin airport — IATA or ICAO code",
"type": "string"
},
"passengers": {
"description": "Number of passengers (default 4)",
"type": "integer"
},
"pets": {
"description": "Travelling with pets? (optional)",
"type": "boolean"
},
"phone": {
"description": "Contact phone number (optional)",
"type": "string"
},
"return_date": {
"description": "Return date YYYY-MM-DD (for round trips)",
"type": "string"
},
"round_trip": {
"description": "Round trip? Default false",
"type": "boolean"
},
"special_requests": {
"description": "Free-text special requests: catering, accessibility, timing, occasion, etc. (optional)",
"type": "string"
},
"wheelchair": {
"description": "Wheelchair access required? (optional)",
"type": "boolean"
}
},
"required": [
"origin",
"destination",
"email",
"departure_date"
]
}