Uber Developers

Get Trip Receipt

GEThttps://api.uber.com/v1/business/trips/{trip_id}/receipt

¶ Use

The Business Receipt endpoint gives get up-to-date data on trip details after its completion.

NOTE: At this time, Business Receipts can only be generated for Uber Travel trips, not for Uber Central. If you would like to get receipt data for Uber Central, please reach out to your account manager or our team for more information.

¶ Authorization

OAuth 2.0 bearer token with the business.receipts scope.

¶ Path Parameters

Name	Type	Description
`trip_id`	`string`	Unique identifier representing a trip.

¶ Example Request

curl -H 'Authorization: Bearer <TOKEN>' \
     -H 'Accept-Language: en_US' \
     -H 'Content-Type: application/json' \
     'https://api.uber.com/v1/business/trips/<TRIP_ID>/receipt'

¶ Response

Status-Code: 200 OK

{
  "given_name": "Uber",
  "family_name": "Developer",
  "employee_id": "UUID-01-JD",
  "trip_uuid": "5152dcc5-b88d-4754-8b33-975f4067c943",
  "transaction_history": [
    {
      "amount": 6.61,
      "short_reference": "GYYTK",
      "currency_code": "USD",
      "utc_timestamp": "2017-05-07T01:32:39.740Z",
      "transaction_type": "SALE",
      "taxes": [
        {
          "amount": 2.71,
          "name": "transport.tax.vat",
          "rate": "0.1",
          "rate_type": "GST",
          "authority": {
            "country": "US"
          }
        }
      ],
      "network_transaction_id": "MDS6D28IM   0628",
      "net_fare": 6.61,
      "transaction_type_detail": "FARE"
    }
  ],
  "vat_amount": null,
  "distance": 1.65,
  "expense_memo": "Jam on life",
  "distance_unit": "miles",
  "dropoff": {
    "location": {
      "city": "San Francisco",
      "country": "US",
      "longitude": -122.4203,
      "state": "CA",
      "address": "1255 Polk St, San Francisco, CA 94109, USA",
      "latitude": 37.7886
    },
    "time": {
      "unix_timestamp": 1494120748,
      "utc_offset": "-07:00",
      "utc_timestamp": "2017-05-07T01:32:28.000Z"
    }
  },
  "total_owed": 0,
  "email": "uber.developer@example.com",
  "organization_uuid": "d715e84c-72ea-490e-a060-823f14532632",
  "organization_name": "Organization Example",
  "program_name": "Default",
  "pickup": {
    "location": {
      "city": "San Francisco",
      "country": "US",
      "longitude": -122.3994,
      "state": "CA",
      "address": "131-141 New Montgomery St, San Francisco, CA 94105, USA",
      "latitude": 37.7865
    },
    "time": {
      "unix_timestamp": 1494120043,
      "utc_offset": "-07:00",
      "utc_timestamp": "2017-05-07T01:20:43.000Z"
    }
  },
  "expense_code": "JAM",
  "total_charged": 6.61,
  "duration": "00:11:46",
  "product_name": "uberX",
  "currency_code": "USD",
  "taxes": [
    {
      "amount": 2.71,
      "name": "transport.tax.vat",
      "rate": "0.1",
      "rate_type": "GST",
      "authority": {
        "country": "US"
      }
    }
  ],
  "promotion_amount": 0,
  "receipt_pdf_url": "https://<url>",
  "user_receipt_pdf_url": "https://<url>",
  "invoices": [
    {
      "invoice_number": "KOKESHNJ21010225",
      "invoice_date": "Fri, 05 Jul 2017 02:47:50 UTC",
      "resource_url": "https://<url>"
    }
  ]
}

¶ Response Body Parameters

Name	Type	Description
`trip_uuid`	`string`	The unique UUID of the trip.
`organization_uuid`	`string`	Unique identifier of the organization.
`organization_name`	`string`	Name of the Uber for Business account.
`program_name`	`string`	Name of the program applied to the trip.
`given_name`	`string`	Given or first name of the employee set in the Uber for Business dashboard.
`family_name`	`string`	Family or last name of the employee set in the Uber for Business dashboard.
`email`	`string`	Email of the employee, as set in the Uber for Business dashboard.
`employee_id`	`string`	ID of the employee, as set in the Uber for Business dashboard.
`product_name`	`string`	The product type that was ordered, ex. UberX, UberPOOL.
`duration`	`string`	The duration in format HH:MM:SS.
`distance`	`float`	The distance of the trip.
`distance_unit`	`string`	The unit of the distance (ex. miles, km)
`expense_code`	`string`	The expense code selected by employee for the trip. Note: Only entered when required in the Uber for
`expense_memo`	`string`	The description of the expense code. Note: Only entered when required in the Uber for Business
`invoices`	`object`	The object containing details about the trip invoices
`invoices.invoice_number`	`string`	The unique invoice identifier for the invoice
`invoices.invoice_date`	`string`	The UTC timestamp for the date the invoice was generated.
`invoices.resource_url`	`string`	The URL of the invoice
`pickup`	`object`	The object containing the information about the pickup for the trip.
`pickup.location`	`object`	The object containing the information about the location of pickup.
`pickup.location.latitude`	`float`	The latitude of the pickup.
`pickup.location.longitude`	`float`	The longitude of the pickup.
`pickup.location.address`	`string`	The full address of the pickup.
`pickup.location.city`	`string`	The city of the pickup address.
`pickup.location.state`	`string`	The state or province of the pickup address.
`pickup.location.country`	`string`	The country code of the pickup address.
`pickup.time`	`object`	The object containing details about the time of the pickup.
`pickup.time.unix_timestamp`	`integer`	The unix timestamp for pickup.
`pickup.time.utc_timestamp`	`string`	The UTC timestamp for pickup.
`pickup.time.utc_offset`	`string`	The UTC offset for pickup.
`promotionAmount`	`float`	The promotion amount applied in the trip.
`dropoff`	`object`	The object containing the information about the dropoff for the trip.
`dropoff.location`	`object`	The object containing the information about the location of dropoff.
`dropoff.location.latitude`	`float`	The latitude of the dropoff.
`dropoff.location.longitude`	`float`	The longitude of the dropoff.
`dropoff.location.address`	`string`	The full address of the dropoff.
`dropoff.location.city`	`string`	The city of the dropoff address.
`dropoff.location.state`	`string`	The state or province of the dropoff address.
`dropoff.location.country`	`string`	The country code of the dropoff address.
`dropoff.time`	`object`	The object containing details about the time of the dropoff.
`dropoff.time.unix_timestamp`	`integer`	The unix timestamp for dropoff.
`dropoff.time.utc_timestamp`	`string`	The UTC timestamp for dropoff.
`dropoff.time.utc_offset`	`string`	The UTC offset for dropoff.
`total_charged`	`float`	The total amount due for the trip.
`total_owed`	`float`	The total uncollected for the trip.
`vat_amount (deprecated)`	`float`	The VAT amount for the trip. No longer used – will always return NULL.
`currency_code`	`string`	The currency for which the total_charged was transacted in ISO 4217 format.
`transaction_history`	`object`	The object containing transaction history of the trip, including updates or revisions to payment.
`transaction_history.transaction_uuid`	`string`	The unique ID of the transaction.
`transaction_history.transaction_type`	`string`	The type of transaction, possible options are `DISBURSEMENT`, `DISPUTE`, `REFUND`, `SALE`.
`transaction_history.utc_timestamp`	`string`	The UTC timestamp of the transaction.
`transaction_history.amount`	`float`	The total amount paid for the transaction.
`transaction_history.currency_code`	`string`	The currency code for the transaction.
`transaction_history.short_reference`	`string`	The short code for the transaction.
`transaction_history.taxes`	`object`	The object contains a list of taxes on the transaction.
`transaction_history.taxes.amount`	`float`	The amount paid in tax.
`transaction_history.taxes.name`	`string`	The name of the tax classification.
`transaction_history.taxes.rate`	`string`	The rate at which the tax is charged.
`transaction_history.taxes.rate_type`	`string`	The rate type of the tax, also known as tax label. For example, GST, VAT, etc.
`transaction_history.taxes.authority`	`object`	The object contains the authority that charged the tax.
`transaction_history.taxes.authority.country`	`string`	The country ISO2 of the authority that charged the tax.
`transaction_history.network_transaction_id`	`string`	The network transaction id for the transaction.
`transaction_history.net_fare`	`float`	The netFare of the transaction
`transaction_history.transaction_type_detail`	`string`	The detail of transaction type. For example FARE AND TIP , TIP, FARE, ADJUSTMENT, etc.
`taxes`	`object`	The object contains a list of taxes on the trip.
`taxes.amount`	`float`	The amount paid in tax.
`taxes.name`	`string`	The name of the tax classification.
`taxes.rate`	`string`	The rate at which the tax is charged.
`taxes.rate_type`	`string`	The rate type of the tax, also known as tax label. For example, GST, VAT, etc.
`taxes.authority`	`object`	The object contains the authority that charged the tax.
`taxes.authority.country`	`string`	The country ISO2 of the authority that charged the tax.
`receipt_pdf_url`	`string`	The URL for U4B receipt PDF. Returns `null` if receipt PDF is not available.
`user_receipt_pdf_url`	`string`	The URL for User receipt PDF. Returns `null` if receipt PDF is not available.

¶ Error Responses

HTTP Status	Code	Description
400	`bad_request`	Request specific message
401	`not_authenticated`	Request made without authentication
403	`not_authorized`	Caller not authorized to make this request
404	`not_found`	Entity being fetched not found
429	`rate_limited`	Rate limit exceeded
500	`server_error`	We have experienced a problem