Uber Developers

GET /estimates/time

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.

¶ Time Estimates

The Time Estimates endpoint returns ETAs for all products currently available at a given location, with the ETA for each product expressed as integers in seconds. If a product returned from GET /v1.2/products is not returned from this endpoint for a given latitude/longitude pair then there are currently none of that product available to request. We recommend that this endpoint be called every minute to provide the most accurate, up-to-date ETAs.

In some markets, the list of products returned from this endpoint may vary by the time of day due to time restrictions on when that product may be utilized.

¶ Resource

GET /v1.2/estimates/time

¶ Authorization

OAuth 2.0 user access token with any valid scope.

¶ Query Parameters

Name	Type	Description
`start_latitude`	`float`	Latitude component.
`start_longitude`	`float`	Longitude component.
`product_id` (optional)	`string`	Unique identifier representing a specific product for a given latitude & longitude.

¶ Example Request

To use a bearer token:

curl -H 'Authorization: Bearer <TOKEN>' \
     -H 'Accept-Language: en_US' \
     -H 'Content-Type: application/json' \
     'https://api.uber.com/v1.2/estimates/time?start_latitude=37.7752315&start_longitude=-122.418075'

¶ Response

Status-Code: 200 OK

{
  "times": [
    {
      "localized_display_name": "POOL",
      "estimate": 60,
      "display_name": "POOL",
      "product_id": "26546650-e557-4a7b-86e7-6a3942445247"
    },
    {
      "localized_display_name": "uberX",
      "estimate": 60,
      "display_name": "uberX",
      "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d"
    },
    {
      "localized_display_name": "uberXL",
      "estimate": 240,
      "display_name": "uberXL",
      "product_id": "821415d8-3bd5-4e27-9604-194e4359a449"
    },
    {
      "localized_display_name": "SELECT",
      "estimate": 240,
      "display_name": "SELECT",
      "product_id": "57c0ff4e-1493-4ef9-a4df-6b961525cf92"
    },
    {
      "localized_display_name": "BLACK",
      "estimate": 240,
      "display_name": "BLACK",
      "product_id": "d4abaae7-f4d6-4152-91cc-77523e8165a4"
    },
    {
      "localized_display_name": "SUV",
      "estimate": 240,
      "display_name": "SUV",
      "product_id": "8920cb5e-51a4-4fa4-acdf-dd86c5e18ae0"
    },
    {
      "localized_display_name": "ASSIST",
      "estimate": 300,
      "display_name": "ASSIST",
      "product_id": "ff5ed8fe-6585-4803-be13-3ca541235de3"
    },
    {
      "localized_display_name": "TAXI",
      "estimate": 480,
      "display_name": "TAXI",
      "product_id": "3ab64887-4842-4c8e-9780-ccecd3a0391d"
    }
  ]
}

Name	Type	Description
`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.
`localized_display_name`	`string`	Localized display name of product.
`display_name`	`string`	Display name of product.
`estimate`	`int`	ETA for the product (in seconds). Always show estimate in minutes.

¶ Error Responses

Status-Code: 422 Unprocessable Entity

{
  "fields": {
    "start_longitude": "Required",
    "start_latitude": "Required"
  },
  "message": "Invalid request",
  "code": "validation_failed"
}