Create booking with quote
POST/v1/bookings
Create booking with quote
Supported roles
- Partner
- Fleet manager
Request
- application/json
Body
Quote ID: Get quotes
Optional number to identify multiple vehicles for the same booking reference. Allows creating multiple bookings with the same bookingReference by providing different vehicleIdentifier values.
Internal notes visible only to dispatchers and operations staff. Used for internal coordination or operator instructions.
booker object
Booker information. Required when passenger is not provided.
Phone number in E.164 format. Required if email is not provided.
Booker’s email address. Required if phone is not provided.
passenger object
Passenger information. Required when booker is not provided.
Phone number in E.164 format
Responses
- 200
- 400
- 401
Create booking successfully
- application/json
- Schema
- Example (from schema)
Schema
APIaccepted- Provider accepted
Booking source:
Booking status:
Vehicle identifier number for multiple vehicles with the same booking reference
booker object
Phone number in E.164 format
passenger object
Phone number in E.164 format
driver object
Phone number in E.164 format
vehicle object
Vehicle license plate number
Vehicle manufacturer/brand
Vehicle model name
Vehicle color
pickup object
Possible values: >= -90 and <= 90
Possible values: >= -180 and <= 180
destination object
Possible values: >= -90 and <= 90
Possible values: >= -180 and <= 180
Pickup time in UTC timezone
Passenger's flight number, if applicable. Useful for airport pickup coordination and flight tracking.
corporate object
Corporate account information. If empty, the booking is considered an individual booking.
Internal notes visible only to dispatchers and operations staff. Used for internal coordination or operator instructions.
Driver note. Additional notes or instructions visible to both the driver and passenger (e.g., passenger preferences, pickup details, or contact instructions).
Number of passengers
Number of luggage
price object
Total trip duration in seconds from pickup to drop-off
Tracking URL of booking
{
"bookId": "93123613947",
"groupId": "G1618",
"source": "API",
"status": "accepted",
"bookingReference": "62549263846",
"vehicleIdentifier": 1,
"booker": {
"title": "Mr",
"firstName": "David",
"lastName": "James",
"phone": "+12051234567",
"email": "passenger@example.com"
},
"passenger": {
"title": "Mr",
"firstName": "David",
"lastName": "James",
"phone": "+12051234567",
"email": "passenger@example.com"
},
"driver": {
"phone": "+12051234567",
"firstName": "Curtis",
"lastName": "Jones",
"avatar": "string"
},
"vehicle": {
"plateNumber": "ABC-1234",
"make": "Toyota",
"model": "Camry",
"color": "Black"
},
"pickup": {
"latitude": 42.94389871922842,
"longitude": -87.90088398474458,
"address": "Milwaukee Mitchell International Airport",
"city": "Milwaukee",
"country": "US",
"postcode": "53207"
},
"destination": {
"latitude": 43.203405744324265,
"longitude": -87.90498301216061,
"address": "225 Trillium Rd, Mequon, WI 53092, USA",
"city": "Mequon",
"country": "US",
"postcode": "53092"
},
"pickupDateTime": "2024-02-19T16:46:45.000Z",
"vehicleType": "Sedan",
"flightNumber": "AA5633",
"corporate": {
"id": "corp_12345",
"name": "Acme Corporation"
},
"internalComment": "VIP client - priority service",
"comment": "Please call upon arrival",
"noPassengers": 3,
"noLuggage": 0,
"price": {
"value": 68.86,
"currency": "USD"
},
"duration": 3600,
"trackLink": "https://track.goodjourney.io/cnsjikf8cdi32"
}
Quote ID not found
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "string"
}