Gozem Developer DocsDocs
Back to siteGo to consoleConsoleGet beta accessGet access
Courier API › Trip

Get Trip Details

gethttps://sandbox-api.gozem.co/courier/v1/trips/{trip_id}

Fetch current status and details for a specific trip.

Path parameters

stringrequired

Trip ID (TRP_xxx format or numeric ID)

min 1 charspattern ^(TRP_\d+|\d+)$

Response 200

dataobjectrequired

The trip and its current state

assigned_atstring

Driver assigned timestamp

date-time
canceled_atstring

Trip canceled timestamp

date-time
completed_atstring

Delivery completed timestamp

date-time
created_atstringrequired

Trip creation timestamp

date-time
distance_kmnumber

Total distance in kilometers

min 0
driverobject

Driver handling the trip. Absent until one is assigned.

namestringrequired

Driver name

phonestringrequired

Driver phone number

vehicle_platestringrequired

Vehicle plate number

vehicle_typestringrequired

Vehicle type and details

dropoffsarray of objectrequired

Delivery stops, in the order they are serviced

object
completed_atstring

Dropoff completed timestamp

date-time
contact_namestring

Contact name

contact_phonestring

Contact phone number

labelstringrequired

Dropoff location name

latnumberrequired

Dropoff latitude

lonnumberrequired

Dropoff longitude

notestring

Note for the dropoff location

max 280 chars
duration_minutesnumber

Total duration in minutes

min 0
fareobject

Fare charged for the trip

amountnumberrequired

Total fare amount

breakdownarray of objectrequired

Fare components, adding up to `amount`

object
amountnumberrequired

Component amount

labelstringrequired

Fare component label

sub_labelstring

Extra detail about the component

currency_codestringrequired

Currency code

guidstringrequired

Unique trip identifier

pickupobjectrequired

Where the package was collected

completed_atstring

Pickup completed timestamp

date-time
contact_namestring

Contact name

contact_phonestring

Contact phone number

labelstringrequired

Pickup location name

latnumberrequired

Pickup latitude

lonnumberrequired

Pickup longitude

notestring

Note for the pickup location

max 280 chars
started_atstring

Package picked up timestamp

date-time
statusstringrequired

Current status of the trip

pendingexpiredassignedat_pickupstartedcanceledcompleted
titlestring

Title of the trip

tracking_urlstring

Public tracking URL that can be shared with the recipient. Contains a signed, short-lived JWT valid for the duration of the delivery.

uri
updated_atstringrequired

Last update timestamp

date-time
messagestringrequired

Human-readable outcome. Defaults to `Ok`.

successbooleanrequired

Always `true` on a success response.

true

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.

400401403404405409413415429500502