Three lines

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"
}

Uber

Developers
© 2023 Uber Technologies Inc.