Three lines

Uber

Developers

GET /history

Access to this API endpoint requires approval from Uber.

As part of Uber’s ongoing privacy improvements, we’re changing our Developer API program with new access policies for third party applications.

Please contact your Uber Business Development representative or Uber point of contact to get access to this API.

This API will be deprecated on December 30th, 2020. Please contact your Uber Business Development representative or Uber point of contact for any questions.

User Activity

The User Activity endpoint returns a limited amount of data about a user’s lifetime activity with Uber. The response will include pickup and dropoff times, the city the trips took place in, the distance of past requests, and information about which products were requested.

The history array in the response will have a maximum length based on the limit parameter. The response value count may exceed limit, therefore subsequent API requests may be necessary.

Resource

GET /v1.2/history

Authorization

OAuth 2.0 user access token with the history or history_lite scope.

Query Parameters
Name Type Description
offset (optional) integer Offset the list of returned results by this amount. Default is zero.
limit (optional) integer Number of items to retrieve. Default is 5, maximum is 50.

Example Request

curl -H 'Authorization: Bearer <TOKEN>' \
     -H 'Accept-Language: en_US' \
     -H 'Content-Type: application/json' \
     'https://api.uber.com/v1.2/history'
Response

Status-Code: 200 OK

{
  "count": 15,
  "history": [
    {
      "status": "completed",
      "distance": 1.4780860317,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1475545183,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1475545808,
      "request_id": "fb0a7c1f-2cf7-4310-bd27-8ba7737362fe",
      "request_time": 1475545095
    },
    {
      "status": "completed",
      "distance": 1.2792152568,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1475513472,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1475513898,
      "request_id": "d72338b0-394d-4f0e-a73c-78d469fa0c6d",
      "request_time": 1475513393
    },
    {
      "status": "completed",
      "distance": 1.5084526246,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1475170251,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1475171154,
      "request_id": "2b61e340-27bd-4937-8304-122009e4a393",
      "request_time": 1475170088
    },
    {
      "status": "completed",
      "distance": 1.4705337758,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1475027766,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1475028387,
      "request_id": "58cb7b3c-fe22-47b4-94c0-2cf08b34f4be",
      "request_time": 1475027705
    },
    {
      "status": "completed",
      "distance": 0.6489455763,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1475002745,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1475003150,
      "request_id": "57be6f97-e10f-411e-a87e-670011c46b55",
      "request_time": 1475002656
    },
    {
      "status": "completed",
      "distance": 0.6632030652,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1475001862,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1475002218,
      "request_id": "0ca65d53-3351-4f3b-b07f-55e4fe4c1ad9",
      "request_time": 1475001534
    },
    {
      "status": "completed",
      "distance": 1.3935675129,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1474995527,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1474995943,
      "request_id": "c0453d97-4330-4ec2-88ab-38678101cc0b",
      "request_time": 1474995056
    },
    {
      "status": "completed",
      "distance": 1.5046201975,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1474909791,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1474910341,
      "request_id": "35822455-e4f5-4339-b763-6fc3ea16dc61",
      "request_time": 1474909743
    },
    {
      "status": "completed",
      "distance": 2.4445998557,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1474685017,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1474685568,
      "request_id": "81a0ffda-a879-4443-beb8-e253f4d19ecc",
      "request_time": 1474684872
    },
    {
      "status": "completed",
      "distance": 1.3603866105,
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
      "start_time": 1474651767,
      "start_city": {
        "latitude": 37.7749,
        "display_name": "San Francisco",
        "longitude": -122.4194
      },
      "end_time": 1474652253,
      "request_id": "97736867-41ca-432a-b7e9-909e66d833ba",
      "request_time": 1474651636
    }
  ],
  "limit": 10,
  "offset": 0
}
Name Type Description
offset integer Position in pagination.
limit integer Number of items to retrieve (50 max).
count integer Total number of items available.
history array An array of this user’s trip history.
history[].request_id string Unique activity identifier.
history[].request_time integer [Unix timestamp] of activity request time.
history[].product_id string Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles.
history[].status string Status of the activity. Only returns completed for now.
history[].distance float Length of activity in miles.
history[].start_time integer Unix timestamp of activity start time.
history[].end_time object Unix timestamp of activity end time.
history[].start_city object The city in which this trip initiated.
history[].start_city.display_name string The name of the city.
history[].start_city.latitude float The latitude of the approximate city center.
history[].start_city.longitude float The longitude of the approximate city center

Uber

Developers
© 2023 Uber Technologies Inc.