---
title: "Get Journey details"
method: GET
path: "/api/v4/journey/{journey_id}"
tags: ["Journeys"]
---

# Get Journey details

`GET /api/v4/journey/{journey_id}`

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](#operation/getJourneyState) endpoint instead.

## Path parameters

- `journey_id` string, required

## Response `200`

Success

- Journey — Booking-level details of a journey including stops, pricing, timestamps, and lifecycle status.
  - `created_at` string, date-time — ISO 8601 datetime when the journey was created.
  - `current_state` string — Current lifecycle state of the journey (e.g. hire, hired, arrived, pick up, terminated).
  - `end_at` string, 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.
  - `finished` boolean — Whether the journey has reached an end state (drop off, cancel, no show, or not found).
  - `id` string, required — UUID of the journey.
  - `label_slug` string — Slug of the label (cost center, project code) associated with this journey for expense reporting.
  - `product_id` string — ID of the vehicle category/product used for this journey, as returned by the estimates endpoint.
  - `public_url` string, nullable — Shareable URL that allows anyone to track the journey in real time without authentication.
  - `region_id` string — Identifier of the city/region where the journey takes place.
  - `start_at` string, 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.
  - `stops` StopResponse[]
    - `addr` string — If an address was provided when creating the journey this field will have its value.
    - `city` string — City name where the address is located, e.g. Madrid.
    - `contact` Contact — Contact details on each Stop. Include this object if you want the Driver to see additional Contact details on each Stop.
      - `mobile_cc` string — Mobile Country Code of the Contact of the Stop passed when creating the Journey.
      - `mobile_num` string — Mobile Number of the Contact of the Stop passed when creating the Journey.
      - `name` string — Name of the Contact of the Stop passed when creating the Journey.
      - `stop_action` 'pickup' | 'dropoff' — Action to be performed on the Stop. Possible values: 'pickup', 'dropoff'. Ignored when it is included in the `contact` field (`stop/contact`), i.e. only taken into account when specific for the contacts within `stop/contacts`.
    - `contacts` Contact[] — List of contacts for the stop, in case of multiple contacts.
      - `mobile_cc` string — Mobile Country Code of the Contact of the Stop passed when creating the Journey.
      - `mobile_num` string — Mobile Number of the Contact of the Stop passed when creating the Journey.
      - `name` string — Name of the Contact of the Stop passed when creating the Journey.
      - `stop_action` 'pickup' | 'dropoff' — Action to be performed on the Stop. Possible values: 'pickup', 'dropoff'. Ignored when it is included in the `contact` field (`stop/contact`), i.e. only taken into account when specific for the contacts within `stop/contacts`.
    - `country` string — Country name where the address is located, e.g. España.
    - `hit_at` string, date-time — DateTime when the driver arrived at the indicated point.
    - `id` string — Id of the stop.
    - `instr` string — Set of instructions for the Driver.
    - `loc` number[], required — The actual coordinates of the address. Required floats per location latitude and longitude.
    - `meeting_point` MeetingPoint — A specific meeting point within a hub location (e.g. a terminal at an airport). Obtained from the hub data returned in the estimates response.
      - `id` string, required — Unique identifier of the meeting point.
      - `loc` number[], required — Coordinates of the meeting point as [latitude, longitude].
      - `name` string, required — Display name of the meeting point.
    - `name` string — A short name for previously stored addresses. These can be viewed in places.
    - `num` string — Street number.
    - `postal_code` string — Postal code of the address.
  - `totals` Totals, nullable — Price breakdown for the journey. Only populated after the journey reaches `terminated` state.
    - `discount` Price — Price information for the parcel, used in cash-on-delivery scenarios.
      - `declared_value` integer — Declared value of the parcel's contents, in the smallest currency unit following the ISO 4217 standard (e.g. €6.30 → `630`).
      - `collected_value` integer — Amount to be collected from the recipient upon delivery, in the smallest currency unit following the ISO 4217 standard (e.g. €6.30 → `630`).
      - `currency` string — ISO 4217 currency code.
    - `price` Price — Price information for the parcel, used in cash-on-delivery scenarios.
      - `declared_value` integer — Declared value of the parcel's contents, in the smallest currency unit following the ISO 4217 standard (e.g. €6.30 → `630`).
      - `collected_value` integer — Amount to be collected from the recipient upon delivery, in the smallest currency unit following the ISO 4217 standard (e.g. €6.30 → `630`).
      - `currency` string — ISO 4217 currency code.
    - `price_total` Price — Price information for the parcel, used in cash-on-delivery scenarios.
      - `declared_value` integer — Declared value of the parcel's contents, in the smallest currency unit following the ISO 4217 standard (e.g. €6.30 → `630`).
      - `collected_value` integer — Amount to be collected from the recipient upon delivery, in the smallest currency unit following the ISO 4217 standard (e.g. €6.30 → `630`).
      - `currency` string — ISO 4217 currency code.
  - `user_id` string — ID of the user who requested the journey.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/cabify/apis/ride-hailing-api.md) · [All operations](https://skmtc.dev/cabify/apis/ride-hailing-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cabify/ride-hailing-api/revisions/8da1cb1270df/schema)