Returns the real-time operational state of an active journey: assigned driver, vehicle, and
the route waypoints collected so far.

Use this endpoint for live tracking while a journey is in progress. It provides the data
needed to show the driver's position on a map and display vehicle/driver details to the rider.

Typical use cases:

• Show the assigned driver's name, phone number, and avatar.
• Display the vehicle plate, model, and color so the rider can identify it.
• Plot the driver's route on a map using the waypoints array.

Availability:

• Returns data once a driver is assigned (hired state onward).
• Returns empty waypoints for journeys in terminated state (route data is archived).
• Returns 404 if the journey does not exist or does not belong to the authenticated client.

⚠️

Stop polling once you receive an end state

End states are terminal, the journey will never transition to another state. Once you receive an
end state (via this endpoint or a webhook), stop polling. Continued polling returns 200 with
state: terminated indefinitely but carries no new information.

For reliable state delivery without polling, configure
Journey State Updates webhooks.

📘

Looking for booking details or pricing?

To retrieve stops, cost breakdown, or lifecycle status, use the
Get Journey Details endpoint instead.

To receive state changes in real time without polling, configure
Webhooks.