v1

latestOpenAPI 3.0.0Cabify Api support2026-07-264588127.9 KB

Journeys

Get Journey details

Returns the booking-level details of a journey: stops, pricing, timestamps, and lifecycle status.

Use this endpoint to check whether a journey is finished, retrieve its cost breakdown, or read the stops that were requested. The response is stable once the journey is created and only changes when the journey ends (populating end_state, end_at, and totals).

Typical use cases:

Display a journey's origin/destination and scheduled time.
Check if a journey has finished and why (end_state).
Retrieve the price summary after a journey is terminated.

📘 Looking for real-time tracking data?

To get the driver's current location, vehicle details, or route waypoints while a journey is in progress, use the Get Journey State endpoint instead.

get/api/v4/journey/{journey_id}

Path parameters

journey_idstring required

UUID of the journey

Response

Success

created_atstring date-time

ISO 8601 datetime when the journey was created.

current_statestring

Current lifecycle state of the journey (e.g. hire, hired, arrived, pick up, terminated).

end_atstring nullable

ISO 8601 datetime when the journey ended. Null while still active.

end_state'drop off' | 'driver cancel' | 'not found' | 'no show' | 'rider cancel' nullable

The reason the journey ended. Null while the journey is still active.

finishedboolean

Whether the journey has reached an end state (drop off, cancel, no show, or not found).

idstring required

UUID of the journey.

label_slugstring

Slug of the label (cost center, project code) associated with this journey for expense reporting.

product_idstring

ID of the vehicle category/product used for this journey, as returned by the estimates endpoint.

public_urlstring nullable

Shareable URL that allows anyone to track the journey in real time without authentication.

region_idstring

Identifier of the city/region where the journey takes place.

start_atstring nullable

ISO 8601 datetime when the journey started (driver began moving toward pickup). Null for journeys still in hire state.

start_type'asap' | 'reserved'

Whether the journey was requested immediately or scheduled for a future time.

user_idstring

ID of the user who requested the journey.

Example response

{
  "created_at": "2022-08-04T19:28:18.375Z",
  "current_state": "terminated",
  "end_at": "2022-02-17T09:30:34.831Z",
  "end_state": "drop off",
  "finished": true,
  "id": "96fc6f24-142b-11ed-bba7-56a6f40ef0bf",
  "label_slug": "apiV4",
  "product_id": "75dd566797369d1f0927102e5356ce59",
  "public_url": "/j/5ceg7v77qm8x28c9",
  "region_id": "madrid",
  "start_at": "2022-02-17T09:30:34.831Z",
  "start_type": "asap",
  "stops": [
    {
      "addr": "Calle de la cruz",
      "city": "Madrid",
      "contact": {
        "mobile_cc": "34",
        "mobile_num": "123456789",
        "name": "Jhon Doe",
        "stop_action": "pickup"
      },
      "country": "ES",
      "id": "123",
      "loc": [
        40.4169335,
        -3.7061872
      ],
      "name": "Work",
      "num": "1428"
    }
  ],
  "totals": {
    "discount": {
      "amount": 0,
      "currency": "EUR"
    },
    "price": {
      "amount": 100,
      "currency": "EUR"
    },
    "price_total": {
      "amount": 100,
      "currency": "EUR"
    }
  },
  "user_id": "0dfc7c0bbbd300e6f9212827106e8911"
}