Book a Trip
https://sandbox-api.gozem.co/courier/v1/tripsCreate a new delivery trip.
Body parameters
Send either quote_id, or the full itinerary: dropoffs, optimize_route, pickup, title, vehicle. Not both.
Quote ID (TQT_xxx format)
Delivery stops, at least one. Serviced in the order given unless `optimize_route` is set.
Contact name
Contact phone number
Dropoff location name
Dropoff latitude
Dropoff longitude
Note for the dropoff location
If true, dropoffs will be reordered to optimize route
Where the package is collected
Contact name
Contact phone number
Pickup location name
Pickup latitude
Pickup longitude
Note for the pickup location
Title of the trip
Unique ID or name of the selected vehicle/service type
Response 200
The newly booked trip
Trip creation timestamp
Fare charged for the trip
Total fare amount
Fare components, adding up to `amount`
Component amount
Fare component label
Extra detail about the component
Currency code
Unique trip identifier
Current status of the trip
Title of the trip
Public tracking URL that can be shared with the recipient. Contains a signed, short-lived JWT valid for the duration of the delivery.
Last update timestamp
Human-readable outcome. Defaults to `Ok`.
Always `true` on a success response.
Errors
Every failure returns the same envelope. Branch on code — it is the stable contract; message is human-facing and may be reworded or localized. See the error reference for what each code means.