Uber Developers

Get Guest Trip Receipt

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

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 the receipt for a given trip.

If the request is from a third party (3P) app, please add x-uber-organizationuuid header and the Organization UUID as the value or the request will be denied.

¶ Authorization

OAuth 2.0 Bearer token with the guests.trips scope.

¶ Request

¶ Example request

curl -X GET \
  -H 'authorization: Bearer <access_token>' \
  -H 'content-type: application/json' \
  'https://api.uber.com/v1/guests/trips/<request_id>/receipt'

¶ Request URL path parameters

Name	Type	Description
request_id	string	The unique ID of the ride request.

¶ Response

¶ Example response

{
  "guest": {
    "first_name": "Jane",
    "last_name": "Doe",
    "phone_number": "+14155550000",
    "email": "jane@example.com"
  },
  "request_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "charges": [
    {
      "name": "Base Fare",
      "amount": 2.2
    },
    {
      "name": "Distance",
      "amount": 2.75
    },
    {
      "name": "Time",
      "amount": 3.57
    }
  ],
  "surge_charge": {
    "name": "Surge x1.5",
    "amount": 4.26
  },
  "home_currency_total_fare": {
    "currency_code": "USD",
    "amount": 13.97
  },
  "normal_fare": "$8.52",
  "subtotal": "$12.78",
  "total_fare": "$5.92",
  "total_owed": null,
  "currency_code": "USD",
  "duration": "00:11:35",
  "distance": "1.49",
  "distance_label": "miles"
}

¶ Response body parameters

Field	Type	Description
`request_id`	string	The unique ID of the ride request.
`guest`	object	Object containing all the information about the rider.
`guest.first_name`	string	The first name of the rider.
`guest.last_name`	string	The last name of the rider.
`guest.phone_number`	string	Phone number of rider E.164 (international) format.
`guest.email`	string	Email address of the rider.
`charges`	array	Enumerated charges.
`charges.name`	string	The name of the charge.
`charges.amount`	float	The amount of the charge.
`charge_adjustments`	array	Adjustments made to the charges.
`charge_adjustments\[].name`	string	The name of the charge adjustment.
`charge_adjustments\[].amount`	float	The amount of the charge adjustment.
`charge_adjustments\[].type`	string	The type of charge adjustment.
`surge_charge`	object	Object containing information about increased fares.
`surge_charge.name`	string	The name of the surge charge (includes multiplier).
`surge_charge.amount`	float	The amount of the surge charge.
`normal_fare`	string	The summation of the charges.
`subtotal`	string	The summation of the normal_fare and surge_charge[amount].
`total_fare`	string	The fare after credits and refunds have been applied.
`total_owed`	float	The total amount still owed after attempting to charge the user. May be null if amount was paid in full.
`currency_code`	string	The currency of the amounts in the response, in ISO 4217 format.
`duration`	string	Time duration of the trip in ISO 8601 HH:MM:SS format.
`distance`	string	Distance of the trip.
`distance_label`	string	The localized unit of distance.
`home_currency_total_fare`	object	Total fare in the currency of the U4B Organization.
`home_currency_total_fare.currency_code`	string	Currency of the U4B Organization in ISO 4217 format.
`home_currency_total_fare.amount`	float	Total Amount of the trip displayed in U4B Organization’s default currency.