Uber Developers

Models

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.

Models used by get_estimates_between_two_locations. Models for payment methods, booking and cancellation are coming soon.

¶ LocationSpecification

Input type for origin and destination. Provide at least one of text_query, point, location_id, or formatted_address.

Field	Type	Description
`text_query`	string	Natural language query (e.g. `"SFO Airport"`, `"Times Square"`) — recommended
`point`	`Point`	Lat/lng coordinate with confidence level
`location_id`	string	Uber location identifier
`location_provider`	string	Provider for `location_id` (e.g. `"uber_places"`, `"google_places"`)
`formatted_address`	`FormattedAddress`	Structured street address

¶ Point

Field	Type	Description
`latitude`	float	Latitude in decimal degrees
`longitude`	float	Longitude in decimal degrees
`altitude`	float	Altitude in metres above sea level (optional)
`confidence`	string	`"high"` — specific, well-known place with accurate coordinates; `"low"` — vague or approximate (default to `"low"` when in doubt)

¶ FormattedAddress

Field	Type	Description
`address_line_1`	string	Street address or building number
`address_line_2`	string	Apartment, suite, or floor (optional)
`city`	string	City name
`postal_code`	string	Postal or ZIP code
`state_code`	string	State or province code (e.g. `"CA"`)
`country_code`	string	ISO 3166-1 alpha-2 country code (e.g. `"US"`)
`locale`	string	Locale string (e.g. `"en_US"`)

¶ ProductEstimate

One ride option returned per available product by get_estimates_between_two_locations.

Field	Type	Description
`display_name`	string	Human-readable product name (e.g. `"UberX"`) — use for display
`capacity`	int	Maximum passenger capacity
`long_description`	string	Additional product description
`eta`	`ETA`	Pickup time estimate
`fare`	`FareSummary`	Fare estimate
`distance_in_meters`	int	Trip distance
`duration_in_seconds`	int	Estimated trip duration
`deep_link`	string	Fallback URL to open Uber directly for this product

¶ ETA

Field	Type	Description
`eta_in_seconds`	int	Seconds until driver arrives at pickup
`estimated_at`	string	Timestamp when this ETA was calculated (optional)

¶ FareSummary

Field	Type	Description
`currency_code`	string	ISO 4217 currency code (e.g. `"USD"`, `"EUR"`)
`point_fare`	string	Fixed fare as a decimal string (e.g. `"25.34"`) — present when price is fixed
`range_fare`	`RangeFare`	Fare range — present when dynamic pricing is active

Always pair point_fare or range_fare with currency_code to format the display string correctly. Do not hard-code a currency symbol.

¶ RangeFare

Present on FareSummary when dynamic pricing is active.

Field	Type	Description
`lower`	string	Low end of the range as a decimal string
`upper`	string	High end of the range as a decimal string

¶ StructuredErrorResponse

Returned when a tool call cannot be completed.

Field	Type	Description
`success`	bool	`false` on error
`errorData`	`ErrorData`	Structured error details

¶ ErrorData

Field	Type	Description
`error_code`	string	Machine-readable error identifier — see Error Codes
`error_message`	string	Internal description — do not display to riders
`title`	string	User-friendly error title
`subtitle`	string	Additional error context
`is_retryable`	bool	Whether the request can be retried
`uber_deeplink`	string	Fallback URL to open Uber directly
`support_deeplink`	string	Uber support page URL