Uber Developers

Get Guest Trip

GEThttps://api.uber.com/v1/guests/trips/{request_id}

Privileged and Confidential This endpoint design has been confidentially shared with you. It is still under development and is subject to change without notice. Please do not share this document or API endpoint details with anyone who is not authorized to have access. For more information read about scopes.

¶ Use case

Use this endpoint to retrieve information for a specific trip.

¶ Authorization

OAuth 2.0 Bearer token with the guests.trips scope.

¶ Request

¶ Example request

curl -X GET \
  -H "authorization: Bearer $UBER_TOKEN" \
  'https://api.uber.com/v1/guests/trips/<request_id>'

¶ Request URL path parameters

URL path parameter	Type	Description
`request_id`	`string`	A unique identifier of a trips request returned when creating a trip (required)

Header name	Description
`x-uber-organizationuuid`	An U4B organization UUID under which you need to obtain estimate information.
`Accept-Language`	If translation for vehicle color fields are needed in the response of this call, please add the header `Accept-Language` and specify the value (for example, to translate to French, use “FR” as the value for this header) Defaults to ‘en’.

¶ Request Query parameters

URL path parameter	Type	Description
`include_editable_fields`	`bool`	When set to true, this option includes editable fields in the response. If omitted or set to false, editable fields are excluded. (optional)

¶ `trips` item parameters

Name	Type	Description
`request_id`	`string`	The unique ID of the trip request.
`status`	`string`	The status of the trip request indicating state.
`status_detail`	`string`	More detail about the status, this field is only populated for rider_canceled status, and it helps to differentiate when trip was canceled by the Coordinator (coordinator_canceled) or the Rider (guest_rider_canceled).
`guest`	`object`	Object containing all the information about the rider.
`pickup`	`object`	Object containing the location and ETA of the trip’s pickup point. See below for more details.
`destination`	`object`	Object containing the location and ETA of the trip’s destination. See below for more details.
`driver`	`object`	Root object of the driver of the trip. Available only when the trip is in accepted, arriving, in_progress and completed status.
`product`	`object`	Object containing the product info such as ID and name.
`vehicle`	`object`	The root vehicle object of the trip. Not available before a driver is dispatched.
`location`	`object`	Location of the driver. It is only available if request status is accepted or arriving.
`begin_trip_time`	`int`	The epoch time in milliseconds when the driver starts the trip. Will be null unless the trip has begun.
`dropoff_time`	`int`	The epoch time in milliseconds when the rider is dropped off and the trip is complete. Only available when the trip is completed.
`request_time`	`int`	The Epoch time in milliseconds the request was made.
`scheduling.pickup_time`	`int`	A timestamp in milliseconds of when the trip is scheduled. Populated only for scheduled rides.
`can_tip`	`bool`	Whether or not the trip is eligible for a tip. Populated only after a trip reaches one of the terminal states.
`client_fare`	`string`	The formatted price of the trip. Populated only after a trip reaches one of the terminal states.
`client_fare_numeric`	`float`	The price of the trip as a float value. Populated only after a trip reaches one of the terminal states.
`client_fare_without_tip`	`string`	The formatted price of the trip excluding the tip. Populated only after a trip reaches one of the terminal states.
`currency_code`	`string`	The currency code for the currency of the trip price. Populated only after a trip reaches one of the terminal states.
`deferred_ride_options.pickup_day`	`string`	The deferred ride pickup day in format YYYY-MM-DD. This is only available for flexible rides.
`expense_memo`	`string`	A free text field to describe the purpose of the trip for expense reporting.
`hourly`	`object`	Populated only for Hourly trips. Object containing the hourly information such as tier booking parameters and overage information.
`waypoints`	`array`	An array of waypoints objects (either “pickup or dropoff”) for the trip. Populated only for the trip in terminal state.
`stops`	`array`	An array of objects containing the location of the trip’s intermediate stops. See below for more details.
`trip_end_location`	`object`	The location of the driver when they ended the trip. Populated only for the trips in completed status.
`is_reserve`	`bool`	Denotes whether the trip is an Uber Reserve trip. Populated only for Uber Reserve trips.
`linked_trip_details`	`object`	Specifies trip details of a return trip. This field is populated only when trip was requested as a Round trip.
`linked_trip_details.request_id`	`string`	Unique identifier of a linked trip.
`location_uuid`	`string`	The UUID of the Uber for Business organization that requested the ride.
`note_for_driver`	`string`	A free text field to enter a message that will be sent to the driver once the driver gets assigned to a trip.
`policy_uuid`	`string`	ID of object that contains permission and product type.
`requester_name`	`string`	The name of the user that requested the trip. This will be the owner of the developer application in case of API trip bookings.
`requester_uuid`	`string`	The UUID of the user that requested the trip. This will be the owner of the developer application in case of API trip bookings.
`scheduling`	`object`	The root scheduling object of the trip. Populated only for scheduled trips.
`scheduling.pickup_time`	`int`	A timestamp in milliseconds of when the trip is scheduled. Populated only for scheduled rides.
`surge_multiplier`	`float`	The surge pricing multiplier used to calculate the increased price of a trip request. A multiplier of 1.0 means surge pricing is not in effect.
`trip_distance_miles`	`float`	The actual distance traveled on the trip, in miles.
`trip_duration_seconds`	`int`	The trip duration, in seconds.
`trip_leg_number`	`int`	The number of leg of the trip. This field is populated only when trip was requested as a Round trip.
`total_trip_legs`	`int`	The total number of legs of the trip. This field is populated only when trip was requested as a Round trip.
`rider_tracking_url`	`string`	The URL to track ride when the trip is in accepted and in progress state. This allows the rider to track their trip in Uber app or web browser. This link can not be embedded in other websites or apps.
`editable_fields`	`object`	Object containing list of editable objects such as PICKUP, DROPOFF and STOPS. Specifies the fields in a trip that can be updated.
`directed_dispatch_info`	`object`	Object containing the dispatch pin

¶ `Guest` object parameters Back to top

Name	Type	Description
`guest.guest_id`	`string`	Unique identifier of a rider.
`guest.first_name`	`string`	Rider’s first name.
`guest.last_name`	`string`	Rider’s last name.
`guest.email`	`string`	Rider’s email address.
`guest.phone_number`	`string`	Phone number of a rider in E.164 (international) format.
`guest.locale`	`string`	The locale the rider was created in. Defaults to en.

¶ `Pickup` object parameters Back to top

Name	Type	Description
`pickup.latitude`	`float`	The latitude of the pickup.
`pickup.longitude`	`float`	The longitude of the pickup.
`pickup.eta`	`int`	Estimated time until arrival at the pickup. Populated only when the trip is in accepted or arriving status.
`pickup.address`	`string`	The pickup location’s complete address.
`pickup.place.place_id`	`string`	The place ID in provider’s name space. Referred from zones endpoint response.
`pickup.place.provider`	`string`	The provider name. Referred from zones endpoint response.
`pickup.subtitle`	`string`	The pickup location city and state, where applicable.
`pickup.timezone`	`string`	The timezone at the pickup address.
`pickup.title`	`string`	The pickup location street address.
`pickup.is_refined`	`bool`	Binary flag whether the pickup is refined/auto snapped.
`pickup.update_details`	`string`	Message for the coordinators used to communicate when pickup has updates.
`pickup.rider_wayfinding_note`	`string`	A note to help the rider find the pickup point.

¶ `Destination` object parameters Back to top

Name	Type	Description
`destination.latitude`	`float`	The latitude of the destination.
`destination.longitude`	`float`	The longitude of the destination.
`destination.eta`	`int`	Estimated time until arrival at the destination. Populated only when trip status is accepted, arriving and in_progress.
`destination.address`	`string`	The destination location’s complete address.
`destination.place.place_id`	`string`	The place ID in provider’s name space. Referred from zones endpoint response.
`destination.place.provider`	`string`	The provider name. Referred from zones endpoint response.
`destination.subtitle`	`string`	The destination location city and state, where applicable.
`destination.timezone`	`string`	The timezone at the destination address.
`destination.title`	`string`	The destination location street address.

¶ `Driver` object parameters Back to top

Name	Type	Description
`driver.id`	`string`	The unique ID of the driver.
`driver.name`	`string`	The first name of the driver.
`driver.phone_number`	`string`	The formatted phone number for calling a driver in E.164 (international) format. Note, this may be different from driver.sms_number. This phone number can be used to call the driver when the trip status is “ACCEPTED”, “ARRIVING” and “IN_PROGRESS”. For trip status “COMPLETED” use Initiate Driver/Recipient Phone Call
`driver.sms_number`	`string`	The formatted phone number in E.164 (international) format for sending an SMS message to a driver. Note, this may be different from driver.phone_number. This phone number can be used to text the driver when the trip status is “ACCEPTED” ,“ARRIVING” and “IN_PROGRESS”. For trip status “COMPLETED” use Send message to driver
`driver.rating`	`float`	The driver’s star rating out of 5 stars.
`driver.picture_url`	`string`	The URL to the photo of the driver.
`driver.pin_based_phone_number.phone_number`	`string`	The formatted phone number for calling a driver using the pin. This phone number can be used to call the driver when the trip status is “ACCEPTED”, “ARRIVING” and “IN_PROGRESS”. For trip status “COMPLETED” use Initiate Driver/Recipient Phone Call
`driver.pin_based_phone_number.pin`	`string`	The pin for calling a driver on the phone number provided.
`driver.regulatory_info`	`string`	Regulatory and compliance information related to the driver (only available in some regions)

¶ `Product` object parameters Back to top

Name	Type	Description
`product.product_id`	`string`	The ID returned from the products endpoint.
`product.display_name`	`string`	The type of Uber product (ex: UberX).

¶ `Vehicle` object parameters Back to top

Name	Type	Description
`vehicle.vehicle_color_name`	`string`	The color of the driver’s vehicle.
`vehicle.license_plate`	`string`	The vehicle’s license plate number.
`vehicle.make`	`string`	The make of the driver’s vehicle.
`vehicle.model`	`string`	The model of the driver’s vehicle.
`vehicle.picture_url`	`string`	The URL to the photo of the vehicle.

¶ `Location` object parameters Back to top

Name	Type	Description
`bearing`	`float`	The current bearing of the vehicle in degrees, ranging from negative to 360. North is represented by 0 degrees, east is 90 degrees, south is 180 degrees, west 270 degrees, and so on. Values may not be available at all times since it depends on device capabilities, network, and location. A negative value indicates that the information is invalid.
`latitude`	`float`	The current latitude of the vehicle. Values may not be available at all times since it depends on device capabilities, network, and location.
`longitude`	`float`	The current longitude of the vehicle. Values may not be available at all times since it depends on device capabilities, network, and location.

¶ `Hourly` object parameters Back to top

Name	Type	Description
`hourly.tier`	`object`	This is used for hourly products. Object containing hourly tier booking parameters. See below for more details.
`hourly.tier.time_in_mins`	`int`	Booked time in minutes.
`hourly.tier.distance`	`int`	Booked distance.
`hourly.tier.distance_unit`	`string`	Unit of distance used in `distance`. Possible values are `mile` and `km`.
`hourly.overage`	`object`	This is used for hourly products. Object containing hourly overage information. Only present when the trip is in progress and in an overage condition. See below for more details.
`hourly.overage.overage_status`	`string`	Possible values are `TIME_EXCEEDED`, `MILEAGE_EXCEEDED` and `TIME_AND_MILEAGE_EXCEEDED`.
`hourly.overage.time_overage_in_mins`	`int`	Time overage in minutes.
`hourly.overage.distance_overage`	`int`	Distance overage.
`hourly.overage.distance_unit`	`string`	Unit of distance used in `distance_overage`. Possible values are `mile` and `km`.

¶ `Waypoints` object parameters Back to top

Name	Type	Description
`waypoints.latitude`	`float`	The latitude in the waypoint being referenced.
`waypoints.longitude`	`float`	The longitude in the waypoint being referenced.
`waypoints.type`	`string`	The type of waypoint, either “pickup” or “dropoff”.

¶ `Stops` object parameters Back to top

Name	Type	Description
`stops.latitude`	`float`	The latitude of the intermediate stop.
`stops.longitude`	`float`	The longitude of the intermediate stop.
`stops.address`	`string`	The intermediate stop complete address.
`stops.place.place_id`	`string`	The place id in provider’s namespace.
`stops.place.provider`	`string`	The name of a provider of a location data.
`stops.timezone`	`string`	The timezone at intermediate stop.
`stops.title`	`string`	The intermediate stop street address.

¶ `Trip_end_location` object parameters Back to top

Name	Type	Description
`trip_end_location.latitude`	`float`	The latitude of the trip’s end location.
`trip_end_location.longitude`	`float`	The longitude of the trip’s end location.
`trip_end_location.address`	`string`	The end location’s complete address.
`trip_end_location.place.place_id`	`string`	The place ID in provider’s namespace.
`trip_end_location.place.provider`	`string`	The name of a provider of location data, e.g. google_places.
`trip_end_location.place.subtitle`	`string`	The end location city and state, where applicable.
`trip_end_location.place.title`	`string`	The end location street address.

¶ `Editable_fields` details Back to top

Name	Type	Description
`editable_fields.PICKUP.editable`	`boolean`	Specifies if the PICKUP is editable in the current trip status.
`editable_fields.PICKUP.max_radius_meters`	`boolean`	Maximum radius distance from the original pickup point within which a location field can be updated
`editable_fields.DROPOFF.editable`	`boolean`	Specifies if the DROPOFF is editable in the current trip status.
`editable_fields.STOPS.editable`	`boolean`	Specifies if the Stops is editable in the current trip status.

¶ `Directed_dispatch_info` details Back to top

Name	Type	Description
`directed_dispatch_info.dispatch_pin`	`string`	Used in the matching process between riders and drivers, particularly in high-volume scenarios like some airport pickups, only available in the `processing` status of the trip. When a coordinator requests a ride, instead of being matched directly to a driver, they are given this dispatch pin (which also will be sent to the rider via SMS text) that will be informed to the rider. The rider needs to give it to the driver to complete the match and begin the trip.

¶ Response

¶ Example `accepted` trip response with `editable_fields`

{
    "destination": {
        "address": "Bryant Park, New York, NY 10018",
        "eta": 18,
        "latitude": 40.7535965,
        "longitude": -73.9832326,
        "place": {
            "place_id": "ChIJvbGg56pZwokRp_E3JbivnLQ",
            "provider": "google_places"
        },
        "subtitle": "New York, NY 10018",
        "timezone": "America/New_York",
        "title": "Bryant Park"
    },
    "driver": {
        "id": "42d53206-d8ba-5d5e-9f9b-c9e4a33d3a4c",
        "name": "Joe",
        "phone_number": "+11234567891",
        "picture_url": "https://d1w2poirtb3as9.cloudfront.net/exampleurl",
        "rating": 4.9,
        "sms_number": "+11234567891",
        "pin_based_phone_number": {
            "phone_number": "+11234567890",
            "pin": "12345678"
        },
        "regulatory_info": "Licensed by TfL, PHL 123456789"
    },
    "expense_memo": "Memo note example",
    "guest": {
        "first_name": "Tom",
        "guest_id": "b7c5e97e-eb5a-5997-a95d-977a5c50d98a",
        "last_name": "Example",
        "locale": "en",
        "phone_number": "+11234567890"
    },
    "location": {
        "bearing": 0,
        "latitude": 40.775573965137674,
        "longitude": -73.98604690473967
    },
    "location_uuid": "a18860d5-ffee-429f-acb3-2f74641a0bf9",
    "note_for_driver": "Example note to driver",
    "pickup": {
        "address": "Lincoln Square, New York, NY",
        "eta": 1,
        "latitude": 40.77417690000001,
        "longitude": -73.98491179999999,
        "place": {
            "place_id": "ChIJYWvLK15YwokR9nuSX-MHTZA",
            "provider": "google_places"
        },
        "subtitle": "New York, NY",
        "timezone": "America/New_York",
        "title": "Lincoln Square"
    },
    "product": {
        "display_name": "UberX",
        "product_id": "b8e5c464-5de2-4539-a35a-986d6e58f186"
    },
    "request_id": "da790cea-31b4-4131-8cd9-7adb1c06db99",
    "request_time": 1564758590788,
    "requester_name": "David Example",
    "requester_uuid": "f3a604eb-8b90-4068-932c-13d6a5002f86",
    "status": "accepted",
    "surge_multiplier": 1,
    "vehicle": {
        "license_plate": "ABC1234",
        "make": "Oldsmobile",
        "model": "Intrigue",
        "vehicle_color_name": "white"
    },
    "rider_tracking_url": "https://trip.uber.com/d8lVg6Sx9H",
    "editable_fields": {
        "PICKUP": {
            "editable": false,
            "max_radius_meters": 200
        },
        "STOPS": {
            "editable": false
        },
        "DROPOFF": {
              "editable": false
        }
    }
}

¶ Example `processing` trip response with `directed_dispatch_info`

{
    "destination": {
        "address": "Bryant Park, New York, NY 10018",
        "eta": 18,
        "latitude": 40.7535965,
        "longitude": -73.9832326,
        "place": {
            "place_id": "ChIJvbGg56pZwokRp_E3JbivnLQ",
            "provider": "google_places"
        },
        "subtitle": "New York, NY 10018",
        "timezone": "America/New_York",
        "title": "Bryant Park"
    },
    "directed_dispatch_info": {
      "dispatch_pin": "123456"
    },
    "expense_memo": "Memo note example",
    "guest": {
        "first_name": "Tom",
        "guest_id": "b7c5e97e-eb5a-5997-a95d-977a5c50d98a",
        "last_name": "Example",
        "locale": "en",
        "phone_number": "+11234567890"
    },
    "location": {
        "bearing": 0,
        "latitude": 40.775573965137674,
        "longitude": -73.98604690473967
    },
    "location_uuid": "a18860d5-ffee-429f-acb3-2f74641a0bf9",
    "note_for_driver": "Example note to driver",
    "pickup": {
        "address": "Lincoln Square, New York, NY",
        "eta": 1,
        "latitude": 40.77417690000001,
        "longitude": -73.98491179999999,
        "place": {
            "place_id": "ChIJYWvLK15YwokR9nuSX-MHTZA",
            "provider": "google_places"
        },
        "subtitle": "New York, NY",
        "timezone": "America/New_York",
        "title": "Lincoln Square"
    },
    "product": {
        "display_name": "UberX",
        "product_id": "b8e5c464-5de2-4539-a35a-986d6e58f186"
    },
    "request_id": "da790cea-31b4-4131-8cd9-7adb1c06db99",
    "request_time": 1564758590788,
    "requester_name": "David Example",
    "requester_uuid": "f3a604eb-8b90-4068-932c-13d6a5002f86",
    "status": "processing",
    "surge_multiplier": 1,
    "rider_tracking_url": "https://trip.uber.com/d8lVg6Sx9H",
}

¶ Example `in_progress` trip response

{
    "begin_trip_time": 1564758770223,
    "destination": {
        "address": "Bryant Park, New York, NY 10018",
        "eta": 17,
        "latitude": 40.7535965,
        "longitude": -73.9832326,
        "place": {
            "place_id": "ChIJvbGg56pZwokRp_E3JbivnLQ",
            "provider": "google_places"
        },
        "subtitle": "New York, NY 10018",
        "timezone": "America/New_York",
        "title": "Bryant Park"
    },
    "driver": {
        "id": "42d53206-d8ba-5d5e-9f9b-c9e4a33d3a4c",
        "name": "Example",
        "phone_number": "+11234567891",
        "picture_url": "https://d1w2poirtb3as9.cloudfront.net/exampleurl",
        "rating": 4.9,
        "sms_number": "+11234567891",
        "pin_based_phone_number": {
            "phone_number": "+11234567890",
            "pin": "12345678"
        },
    },
    "expense_memo": "Memo note example",
    "guest": {
        "first_name": "Tom",
        "guest_id": "b7c5e97e-eb5a-5997-a95d-977a5c50d98a",
        "last_name": "Example",
        "locale": "en",
        "phone_number": "+11234567890"
    },
    "location_uuid": "a18860d5-ffee-429f-acb3-2f74641a0bf9",
    "note_for_driver": "Example note to driver",
    "pickup": {
        "address": "Lincoln Square, New York, NY",
        "latitude": 40.77417690000001,
        "longitude": -73.98491179999999,
        "place": {
            "place_id": "ChIJYWvLK15YwokR9nuSX-MHTZA",
            "provider": "google_places"
        },
        "subtitle": "New York, NY",
        "timezone": "America/New_York",
        "title": "Lincoln Square"
    },
    "product": {
        "display_name": "UberX",
        "product_id": "b8e5c464-5de2-4539-a35a-986d6e58f186"
    },
    "request_id": "da790cea-31b4-4131-8cd9-7adb1c06db99",
    "request_time": 1564758590788,
    "requester_name": "David Example",
    "requester_uuid": "f3a604eb-8b90-4068-932c-13d6a5002f86",
    "status": "in_progress",
    "surge_multiplier": 1,
    "vehicle": {
        "license_plate": "ABC1234",
        "make": "Oldsmobile",
        "model": "Intrigue",
        "vehicle_color_name": "white"
    }
}

¶ Example `completed` trip response

{
    "begin_trip_time": 1564758770000,
    "can_tip": true,
    "client_fare": "$10.41",
    "client_fare_without_tip": "$10.41",
    "currency_code": "USD",
    "destination": {
        "address": "Bryant Park, New York, NY 10018",
        "latitude": 40.7535965,
        "longitude": -73.9832326,
        "place": {
            "place_id": "ChIJvbGg56pZwokRp_E3JbivnLQ",
            "provider": "google_places"
        },
        "subtitle": "New York, NY 10018",
        "timezone": "America/New_York",
        "title": "Bryant Park"
    },
    "driver": {
        "id": "42d53206-d8ba-5d5e-9f9b-c9e4a33d3a4c",
        "name": "Joe",
        "picture_url": "https://d1w2poirtb3as9.cloudfront.net/exampleurl",
        "rating": 4.9,
        "pin_based_phone_number": {
            "phone_number": "+11234567891",
            "pin": "12345678"
        }
    },
    "dropoff_time": 1564758815000,
    "expense_memo": "Memo note example",
    "guest": {
        "first_name": "Tom",
        "guest_id": "b7c5e97e-eb5a-5997-a95d-977a5c50d98a",
        "last_name": "Example",
        "locale": "en",
        "phone_number": "+11234567890"
    },
    "location_uuid": "a18860d5-ffee-429f-acb3-2f74641a0bf9",
    "note_for_driver": "Example note to driver",
    "pickup": {
        "address": "Lincoln Square, New York, NY",
        "latitude": 40.77417690000001,
        "longitude": -73.98491179999999,
        "place": {
            "place_id": "ChIJYWvLK15YwokR9nuSX-MHTZA",
            "provider": "google_places"
        },
        "subtitle": "New York, NY",
        "timezone": "America/New_York",
        "title": "Lincoln Square"
    },
    "product": {
        "display_name": "UberX",
        "product_id": "b8e5c464-5de2-4539-a35a-986d6e58f186"
    },
    "request_id": "da790cea-31b4-4131-8cd9-7adb1c06db99",
    "request_time": 1564758590000,
    "requester_name": "David Example",
    "requester_uuid": "f3a604eb-8b90-4068-932c-13d6a5002f86",
    "status": "completed",
    "surge_multiplier": 1,
    "trip_distance_miles": 0.01770572790936,
    "trip_duration_seconds": 900,
    "trip_end_location": {
        "latitude": 40.7530483614,
        "longitude": -73.9837700287
    },
    "vehicle": {
        "make": "Oldsmobile",
        "model": "Intrigue",
        "vehicle_color_name": "white",
        "license_plate": "ABC1234"
    },
    "waypoints": [
        {
            "latitude": 40.7741769,
            "longitude": -73.9849118,
            "type": "pickup"
        },
        {
            "latitude": 40.7535965,
            "longitude": -73.9832326,
            "type": "dropoff"
        }
    ]
}

¶ Example Canceled Trip Response

{
    "call_enabled": false,
    "can_tip": false,
    "city_id": "5",
    "client_fare": "$6.00",
    "client_fare_numeric": 6,
    "client_fare_without_tip": "$6.00",
    "currency_code": "USD",
    "destination": {
        "address": "Bryant Park, New York, NY 10018",
        "latitude": 40.7535965,
        "longitude": -73.9832326,
        "place": {
            "place_id": "ChIJvbGg56pZwokRp_E3JbivnLQ",
            "provider": "google_places"
        },
        "subtitle": "New York, NY 10018",
        "timezone": "America/New_York",
        "title": "Bryant Park"
    },
    "driver": {
        "id": "42d53206-d8ba-5d5e-9f9b-c9e4a33d3a4c",
        "name": "Joe",
        "picture_url": "https://d1w2poirtb3as9.cloudfront.net/exampleurl",
        "rating": 4.9,
        "pin_based_phone_number": {
            "phone_number": "+11234567890",
            "pin": "12345678"
        },
    },
    "expense_memo": "TEST",
    "fare": {
        "currency_code": "USD",
        "value": 6
    },
    "guest": {
        "first_name": "Tom",
        "guest_id": "b7c5e97e-eb5a-5997-a95d-977a5c50d98a",
        "last_name": "Example",
        "locale": "en",
        "phone_number": "+11234567890"
    },
    "is_downloadable_invoice_enabled": false,
    "is_eligible_for_refund": false,
    "location_uuid": "1b00a3a0-c19d-45f5-ab96-10d250fda991",
    "pickup": {
        "address": "Lincoln Square, New York, NY",
        "latitude": 40.77417690000001,
        "longitude": -73.98491179999999,
        "place": {
            "place_id": "ChIJYWvLK15YwokR9nuSX-MHTZA",
            "provider": "google_places"
        },
        "subtitle": "New York, NY",
        "timezone": "America/New_York",
        "title": "Lincoln Square"
    },
    "product": {
        "display_name": "UberX",
        "product_id": "b8e5c464-5de2-4539-a35a-986d6e58f186"
    },
    "request_id": "3ff3d2e8-9b83-4c92-94e5-3b432498c9bb",
    "request_time": 1694673860315,
    "requester_name": "David Example",
    "requester_uuid": "f3a604eb-8b90-4068-932c-13d6a5002f86",
    "scheduling": {
        "pickup_time": 1694674200000
    },
    "status": "driver_canceled",
    "surge_multiplier": 1,
    "total_trip_legs": 1,
    "trip_distance_miles": 0,
    "trip_duration_seconds": 0,
    "trip_end_location": {
        "latitude": 40.7530483614,
        "longitude": -73.9837700287
    },
    "trip_leg_number": 0,
    "vehicle": {
        "make": "Oldsmobile",
        "model": "Intrigue",
        "vehicle_color_name": "white",
        "license_plate": "ABC1234"
    },
    "waypoints": [
        {
            "latitude": 40.7741769,
            "longitude": -73.9849118,
            "type": "pickup"
        },
        {
            "latitude": 40.7535965,
            "longitude": -73.9832326,
            "type": "dropoff"
        }
    ]
}

¶ Example Canceled with a follow-up rebooked trip (`follow_up_trip_details`)

{
    "request_id": "afdb6d61-80eb-4425-b5b2-516a750697b9",
    "status": "driver_canceled",
    "surge_multiplier": 1,
    "guest": {
        "guest_id": "a74e20d1-83f0-40d0-9b91-5b39f6b81b50",
        "first_name": "Peter",
        "last_name": "Parker",
        "phone_number": "+1122334455",
        "locale": "en"
    },
    "driver": {
        "id": "01543370-86e6-489c-adda-1043a1284f16",
        "name": "Norman",
        "rating": 4.98,
    },
    "vehicle": {
        "make": "Honda",
        "model": "Civic",
        "license_plate": "BRZ5351",
        "vehicle_color_name": "Black"
    },
    "pickup": {
        "latitude": 45.4577,
        "longitude": -73.7513929,
        "address": "Curbside Terminal Aéroport International Pierre-Elliott-Trudeau de Montréal (YUL), Dorval, QC H4Y 1H1, CA",
        "place": {
            "place_id": "46e51b4a-7ef3-4186-8d00-26b0a4c1e6df",
            "provider": "uber_geofences",
            "zone_id": "25c19143-eae9-4531-a072-64d3d45568e8"
        },
        "timezone": "America/Toronto",
        "title": "Door 7 (Faster Pickup) - Departure",
        "subtitle": "YUL Terminal"
    },
    "destination": {
        "latitude": 45.50400661709105,
        "longitude": -73.62522599934351,
        "address": "3175 ch de la Côte-Sainte-Catherine, Montréal, QC H3T 1C5, CA",
        "place": {
            "place_id": "bc3ae611-e9a4-3337-1cc0-8358e5e712d0",
            "provider": "uber_places"
        },
        "timezone": "America/Toronto",
        "title": "Centre Hospitalier Universitaire Sainte-Justine",
        "subtitle": "3175 ch de la Côte-Sainte-Catherine, Montréal, QC H3T 1C5"
    },
    "request_time": 1727197493000,
    "client_fare": "CA$0.00",
    "requester_uuid": "953b1aaf-d6a5-4d15-abc1-abbeeff6b821",
    "requester_name": "Gabriel Diniz",
    "trip_distance_miles": 0,
    "trip_duration_seconds": 0,
    "waypoints": [
        {
            "latitude": 45.4577,
            "longitude": -73.751396,
            "type": "pickup"
        },
        {
            "latitude": 45.504005,
            "longitude": -73.62523,
            "type": "dropoff"
        }
    ],
    "location_uuid": "5d7363a4-5b1a-4c2b-ac58-1fba1af7f21a",
    "product": {
        "product_id": "d34e8e9e-5e71-484a-bda3-15fd5540d2c5",
        "display_name": "UberX"
    },
    "currency_code": "CAD",
    "can_tip": false,
    "client_fare_without_tip": "CA$0.00",
    "trip_end_location": {
        "latitude": 45.4577,
        "longitude": -73.751396
    },
    "client_fare_numeric": 0,
    "stops": null,
    "trip_leg_number": 0,
    "total_trip_legs": 1,
    "follow_up_trip_details": {
      "trip_uuid": "15f5f1ac-f799-4539-8e36-bd51e07231b5"
    }
}

¶ Example `scheduled` hourly trip response

{
  "request_id": "436610b9-27ff-4c80-8cb4-c388a417f641",
  "status": "scheduled",
  "surge_multiplier": 1,
  "guest": {
    "guest_id": "d83361b1-5715-5eed-9d7f-cc9e327d68db",
    "first_name": "Sample",
    "last_name": "Guest",
    "phone_number": "+11234567890",
    "locale": "en"
  },
  "driver": {
    "name": "Driver",
    "rating": 5,
    "picture_url": "https://d1w2poirtb3as9.cloudfront.net/exampleurl"
  },
  "pickup": {
    "latitude": 37.7693926,
    "longitude": -122.388946,
    "address": "1515 3rd St, San Francisco, CA 94158, US",
    "place": {
      "place_id": "5c8db4b8-ecb8-4610-933e-4499742406ed",
      "provider": "uber_places"
    },
    "timezone": "America/Los_Angeles",
    "title": "Uber Mission Bay 2",
    "subtitle": "1515 3rd St, San Francisco, CA"
  },
  "destination": {
    "latitude": 37.80083,
    "longitude": -122.41001,
    "address": "Washington Square, Filbert St, San Francisco, CA",
    "place": {
      "place_id": "160a5155-7ed2-a267-20c2-6849f11a9c70",
      "provider": "uber_places"
    },
    "timezone": "America/Los_Angeles",
    "title": "Washington Square",
    "subtitle": "Filbert St, San Francisco, CA"
  },
  "scheduling": {
    "pickup_time": 1698098551000
  },
  "request_time": 1698091256795,
  "client_fare": "$165.32",
  "requester_uuid": "b25602c2-53ed-4005-8cb8-cabb58a7f0d5",
  "requester_name": "Sample Guest",
  "location_uuid": "8a276334-df63-46f3-a906-2cf8ea1fd817",
  "product": {
    "product_id": "ff4fe398-6cc6-4931-9076-d5bfdde928b6",
    "display_name": "Black SUV Hourly"
  },
  "is_reserve": true,
  "rider_tracking_url": "https://trip.uber.com/HHGeI00x",
  "trip_leg_number": 0,
  "total_trip_legs": 1,
  "stops": [
    {
      "latitude": 37.751507,
      "longitude": -122.433136,
      "address": "4054 24th St, San Francisco, CA 94114, US",
      "place": {
        "place_id": "877fbdb7-358e-5aa4-a061-cc6b14b682fd",
        "provider": "uber_places"
      },
      "timezone": "America/Los_Angeles",
      "title": "The Valley Tavern",
      "subtitle": "4054 24th St, San Francisco, CA"
    },
    {
      "latitude": 37.75976,
      "longitude": -122.42711,
      "address": "Mission Dolores Park",
      "place": {
        "place_id": "5ef9f628-c8d6-3d70-bb10-7503f23165bf",
        "provider": "uber_places"
      },
      "timezone": "America/Los_Angeles",
      "title": "Mission Dolores Park",
      "subtitle": "566 Dolores St, San Francisco, CA"
    }
  ],
  "hourly": {
    "tier": {
      "time_in_mins": 120,
      "distance": 30,
      "distance_unit": "MILE"
    }
  }
}

¶ Example `in_progress` hourly trip response with overage

{
  "request_id": "9ee23829-7e28-439a-b9c9-cdfc62eee632",
  "status": "in_progress",
  "surge_multiplier": 1,
  "guest": {
    "guest_id": "d83361b1-5715-5eed-9d7f-cc9e327d68db",
    "first_name": "Sample",
    "last_name": "Guest",
    "phone_number": "+11234567890",
    "locale": "en"
  },
  "driver": {
    "name": "Driver",
    "rating": 5,
    "picture_url": "https://d1w2poirtb3as9.cloudfront.net/exampleurl"
  },
  "vehicle": {
    "make": "Ford",
    "model": "Expedition",
    "license_plate": "",
    "picture_url": "https://d3a74cgiihgn4m.cloudfront.net/2021/ford/expedition/14931_FCFCFC_3.png",
    "vehicle_color_name": "White"
  },
  "location": {
    "latitude": -22.915508,
    "longitude": -47.055683,
    "bearing": 0
  },
  "pickup": {
    "latitude": 37.7693926,
    "longitude": -122.388946,
    "address": "1515 3rd St, San Francisco, CA 94158, US",
    "place": {
      "place_id": "5c8db4b8-ecb8-4610-933e-4499742406ed",
      "provider": "uber_places"
    },
    "timezone": "America/Los_Angeles",
    "title": "Uber Mission Bay 2",
    "subtitle": "1515 3rd St, San Francisco, CA"
  },
  "destination": {
    "latitude": 37.80083,
    "longitude": -122.41001,
    "eta": 26,
    "address": "Washington Square, Filbert St, San Francisco, CA",
    "place": {
      "place_id": "160a5155-7ed2-a267-20c2-6849f11a9c70",
      "provider": "uber_places"
    },
    "timezone": "America/Los_Angeles",
    "title": "Washington Square",
    "subtitle": "Filbert St, San Francisco, CA"
  },
  "scheduling": {
    "pickup_time": 1698439444000
  },
  "request_time": 1698432207781,
  "begin_trip_time": 1698436825269,
  "client_fare": "$165.32",
  "requester_uuid": "b25602c2-53ed-4005-8cb8-cabb58a7f0d5",
  "requester_name": "Sample Guest",
  "location_uuid": "8a276334-df63-46f3-a906-2cf8ea1fd817",
  "product": {
    "product_id": "ff4fe398-6cc6-4931-9076-d5bfdde928b6",
    "display_name": "Black SUV Hourly"
  },
  "is_reserve": true,
  "rider_tracking_url": "https://trip.uber.com/tvaobiiwP7",
  "trip_leg_number": 0,
  "total_trip_legs": 1,
  "stops": [
    {
      "latitude": 37.751507,
      "longitude": -122.433136,
      "address": "4054 24th St, San Francisco, CA 94114, US",
      "place": {
        "place_id": "877fbdb7-358e-5aa4-a061-cc6b14b682fd",
        "provider": "uber_places"
      },
      "timezone": "America/Los_Angeles",
      "title": "4054 24th St"
    },
    {
      "latitude": 37.75976,
      "longitude": -122.42711,
      "address": "Mission Dolores Park",
      "place": {
        "place_id": "5ef9f628-c8d6-3d70-bb10-7503f23165bf",
        "provider": "uber_places"
      },
      "timezone": "America/Los_Angeles",
      "title": "Mission Dolores Park"
    }
  ],
  "hourly": {
    "overage": {
      "overage_status": "TIME_EXCEEDED",
      "time_overage_in_mins": 52
    },
    "tier": {
      "time_in_mins": 120,
      "distance": 30,
      "distance_unit": "MILE"
    }
  }
}

¶ Example `completed` hourly trip response

{
  "request_id": "711b2b85-6fb9-4185-9bbe-aa983ad90851",
  "status": "completed",
  "surge_multiplier": 1,
  "guest": {
    "guest_id": "d83361b1-5715-5eed-9d7f-cc9e327d68db",
    "first_name": "Sample",
    "last_name": "Guest",
    "phone_number": "+11234567890",
    "locale": "en"
  },
  "driver": {
    "name": "Driver",
    "rating": 5,
    "picture_url": "https://d1w2poirtb3as9.cloudfront.net/exampleurl"
  },
  "vehicle": {
    "make": "Ford",
    "model": "Expedition",
    "picture_url": "https://d3a74cgiihgn4m.cloudfront.net/2021/ford/expedition/14931_FCFCFC_3.png",
    "vehicle_color_name": "White"
  },
  "pickup": {
    "latitude": 37.7693926,
    "longitude": -122.388946,
    "address": "1515 3rd St, San Francisco, CA 94158, US",
    "place": {
      "place_id": "5c8db4b8-ecb8-4610-933e-4499742406ed",
      "provider": "uber_places"
    },
    "timezone": "America/Los_Angeles",
    "title": "Uber Mission Bay 2",
    "subtitle": "1515 3rd St, San Francisco, CA"
  },
  "destination": {
    "latitude": 37.7515078,
    "longitude": -122.4331331,
    "address": "4054 24th St, San Francisco, CA 94114, US",
    "place": {
      "place_id": "877fbdb7-358e-5aa4-a061-cc6b14b682fd",
      "provider": "uber_places"
    },
    "timezone": "America/Los_Angeles",
    "title": "The Valley Tavern",
    "subtitle": "4054 24th St, San Francisco, CA"
  },
  "scheduling": {
    "pickup_time": 1698075957000
  },
  "request_time": 1698073317624,
  "begin_trip_time": 1698073331000,
  "dropoff_time": 1698089299000,
  "client_fare": "$459.98",
  "requester_uuid": "b25602c2-53ed-4005-8cb8-cabb58a7f0d5",
  "requester_name": "Sample Guest",
  "trip_distance_miles": 49.056548123799296,
  "trip_duration_seconds": 15968,
  "waypoints": [
    {
      "latitude": 37.769394,
      "longitude": -122.38895,
      "type": "pickup"
    },
    {
      "latitude": 36.73259,
      "longitude": -119.78406,
      "type": "via"
    },
    {
      "latitude": 37.761,
      "longitude": -121.9676,
      "type": "via"
    },
    {
      "latitude": 36.85821,
      "longitude": -121.40019,
      "type": "via"
    },
    {
      "latitude": 37.751507,
      "longitude": -122.433136,
      "type": "dropoff"
    }
  ],
  "location_uuid": "8a276334-df63-46f3-a906-2cf8ea1fd817",
  "product": {
    "product_id": "ff4fe398-6cc6-4931-9076-d5bfdde928b6",
    "display_name": "Black SUV Hourly"
  },
  "currency_code": "USD",
  "can_tip": true,
  "client_fare_without_tip": "$459.98",
  "trip_end_location": {
    "latitude": 37.751373,
    "longitude": -122.4331
  },
  "client_fare_numeric": 459.98,
  "is_reserve": true,
  "trip_leg_number": 0,
  "total_trip_legs": 1,
  "stops": [
    {
      "latitude": 36.73259,
      "longitude": -119.78406,
      "place": {
        "place_id": "18857baa-dd93-37bd-87a1-43acdb372e0c",
        "provider": "uber_places"
      },
      "timezone": "America/Los_Angeles",
      "title": "DoubleTree by Hilton Hotel Fresno Convention Center",
      "subtitle": "2233 Ventura St, Fresno, CA"
    },
    {
      "latitude": 37.761,
      "longitude": -121.9676,
      "place": {
        "place_id": "93e7fc21-f65b-cfe8-cd88-e9534b39d02a",
        "provider": "uber_places"
      },
      "timezone": "America/Los_Angeles",
      "title": "Extended Stay America - San Ramon - Bishop Ranch - West",
      "subtitle": "18000 San Ramon Valley Blvd, San Ramon, CA"
    },
    {
      "latitude": 36.85821,
      "longitude": -121.40019,
      "place": {
        "place_id": "1847644a-21ce-76cd-6103-46b23ba74862",
        "provider": "uber_places"
      },
      "timezone": "America/Los_Angeles",
      "title": "Hollister DMV Office",
      "subtitle": "80 N Sally St, Hollister, CA"
    }
  ],
  "hourly": {
    "tier": {
      "time_in_mins": 120,
      "distance": 30,
      "distance_unit": "MILE"
    }
  }
}

¶ Trip request `status` values

All possible status values of Request life cycle.

`status`	Description
processing	The request is matching to the most efficient available driver.
no_drivers_available	The request was unfulfilled because no drivers were available. This is a terminal state.
accepted	The request has been accepted by a driver and is “en route” to the start location (i.e. start_latitude and start_longitude).
arriving	The driver has arrived or will be shortly at the pickup location.
in_progress	The rider has been picked up and is en route to the destination.
driver_canceled	The request has been canceled by the driver after waiting for a grace period in pickup location. This is a terminal state.
rider_canceled	The request was canceled by the rider via SMS or via API using the delete trip endpoint. Look at ‘status_detail’ field in the GET guest trip endpoint to verify the cancellation method.
completed	Rider has been dropped off at the destination. This is a terminal state.
scheduled	The request is scheduled to be dispatched at a later time. This is the status of a scheduled or reserved ride until a driver assignment happens.
failed	The request failed.
offered	The deferred ride is actively redeemable by a rider.
expired	The deferred ride has expired and cannot be redeemed by the rider anymore.
driver_redispatched	The previously accepted driver has canceled the trip request, a new driver is re-dispatched and should be arriving shortly.

¶ Trip request `status_detail` values

All possible status_detail values for a request with rider_canceled status.

Status	Description
coordinator_canceled	The request was canceled by the Coordinator.
guest_rider_canceled	The request was canceled by the Rider.

Uber

Developers

Get Guest Trip

¶ Use case

¶ Authorization

¶ Request

¶ Example request

¶ Request URL path parameters

¶ Request Query parameters

¶ trips item parameters

¶ Guest object parameters Back to top

¶ Pickup object parameters Back to top

¶ Destination object parameters Back to top

¶ Driver object parameters Back to top

¶ Product object parameters Back to top

¶ Vehicle object parameters Back to top

¶ Location object parameters Back to top

¶ Hourly object parameters Back to top

¶ Waypoints object parameters Back to top

¶ Stops object parameters Back to top

¶ Trip_end_location object parameters Back to top

¶ Editable_fields details Back to top

¶ Directed_dispatch_info details Back to top