Raw schema
{
"type": "object",
"properties": {
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 80,
"pattern": "^[A-Za-z0-9._:-]+$",
"description": "Unique key for this one intended action. Reuse it only when retrying the same action."
},
"quote_id": {
"type": "string",
"maxLength": 40
},
"hold_id": {
"type": "string",
"maxLength": 40
},
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"phone": {
"type": "string",
"pattern": "^\\+[1-9][0-9 ()/-]{6,22}$",
"description": "Mobile number in international format, e.g. +43 660 1234567."
},
"email": {
"type": "string",
"maxLength": 160
},
"language": {
"type": "string",
"enum": [
"en",
"de"
]
},
"pickup_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD (Europe/Vienna)."
},
"pickup_time": {
"type": "string",
"pattern": "^([01]?\\d|2[0-3]):[0-5]\\d$",
"description": "Requested DRIVER PICKUP time, HH:MM Europe/Vienna. For an airport arrival this is normally the scheduled landing time; the driver monitors the flight."
},
"pickup_address": {
"type": "string",
"minLength": 2,
"maxLength": 200,
"description": "Exact pickup address (street + number + town, hotel, or airport + terminal)."
},
"pickup_instructions": {
"type": "string",
"maxLength": 300
},
"destination_address": {
"type": "string",
"minLength": 2,
"maxLength": 200
},
"passengers": {
"type": "integer",
"minimum": 1,
"maximum": 5
},
"large_suitcases": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"hand_luggage": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"flight_number": {
"type": "string",
"maxLength": 12,
"description": "Required when picking up at an airport."
},
"flight_arrival_time": {
"type": "string",
"pattern": "^([01]?\\d|2[0-3]):[0-5]\\d$",
"description": "Scheduled landing time (local) - required for airport pickups."
},
"flight_departure_time": {
"type": "string",
"pattern": "^([01]?\\d|2[0-3]):[0-5]\\d$",
"description": "Scheduled departure time for rides TO the airport (optional)."
},
"stops": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 0,
"description": "Not bookable online; must be empty."
},
"child_seats": {
"type": "string",
"maxLength": 0,
"description": "Not bookable online; must be empty."
},
"notes": {
"type": "string",
"maxLength": 600
},
"whatsapp_opt_in": {
"type": "boolean",
"description": "True only if the customer agreed to WhatsApp messages about this ride."
},
"accepted_terms": {
"type": "boolean",
"const": true,
"description": "Customer accepted that RIED.TAXI processes their details to carry out the ride (https://ried.taxi/en/privacy/) and the booking terms (https://ried.taxi/en/terms/; cancellation is free of charge)."
},
"customer_confirmed": {
"type": "boolean",
"const": true,
"description": "Customer saw the full booking summary and explicitly said to book it."
}
},
"required": [
"idempotency_key",
"quote_id",
"first_name",
"last_name",
"phone",
"language",
"pickup_date",
"pickup_time",
"pickup_address",
"destination_address",
"passengers",
"large_suitcases",
"whatsapp_opt_in",
"accepted_terms",
"customer_confirmed"
],
"additionalProperties": false
}