Create Quote

POSThttps://api.uber.com/v1/customers/{customer_id}/delivery_quotes

Access to These APIs May Require Written Approval From Uber

Uber’s APIs are always under development and as such are subject to changes according to our Versioning & Upgrade policy. As part of Uber’s ongoing privacy improvements, we’ve updated our Developer API program with new scope access policies for third party applications. For further information, please refer to our Getting Started guides.

Create a quote to check deliverability, validity and cost for delivery between two addresses.

Request Path Parameters

Name Type Description
customer_id string Unique identifier for the organization. Either UUID or starts with `cus_`.

Request Body Parameters

Name Type Description
dropoff_address string - Structured Address (required) For single string, format is : “Street Address, City, State, Zip”
dropoff_latitude double Dropoff latitude coordinate
dropoff_longitude double Dropoff longitude coordinate
dropoff_phone_number string Phone number of recipient. Should be in e164 format (eg. “+13235550000”).
pickup_address string - Structured Address (required) For single string, format is : “Street Address, City, State, Zip”
pickup_latitude double Pickup latitude coordinate
pickup_longitude double Pickup longitude coordinate
pickup_phone_number string Phone number of sender/store. Should be in e164 format (eg. “+13235550000”).
pickup_ready_dt timestamp (RFC 3339) Beginning of the window when an order must be picked up. Must be less than 30 days in the future.
pickup_deadline_dt timestamp (RFC 3339) End of the window when an order may be picked up. Must be at least 10 mins later than pickup_ready_dt and at least 20 minutes in the future from now.
dropoff_ready_dt timestamp (RFC 3339) Beginning of the window when an order must be dropped off. Must be less than or equal to pickup_deadline_dt
dropoff_deadline_dt timestamp (RFC 3339) End of the window when an order must be dropped off. Must be at least 20 mins later than dropoff_ready_dt and must be greater than or equal to pickup_deadline_dt.
manifest_total_value integer Value in cents ( ¹/₁₀₀ of currency unit ) of the items in the delivery. i.e.: $10.99 => 1099.
external_store_id string (Optional) Unique identifier used by our Partners to reference a Store or Location
Request Body Parameters - Structured Address
Name Type Description
street_address array[string] Array of street address elements. For example: [“2000 Ocean Ave", “Floor 2” ]
city string
state string
zip_code string
country string (optional)

Response Body Parameters

Name Type Description
created timestamp (RFC 3339) Date/Time at which the quote was created.
currency string [DEPRECATED] Three-letter ISO currency code, in lowercase.
currency_type string Three-letter ISO currency code, in uppercase.
dropoff_deadline timestamp (RFC 3339) When a delivery must be dropped off. This is the end of the dropoff window.
dropoff_eta timestamp (RFC 3339) Estimated drop-off time.
duration integer Estimated minutes for this delivery to reach dropoff
expires timestamp (RFC 3339) Date/Time after which the quote will no longer be accepted.
fee integer Amount in cents ( ¹/₁₀₀ of currency unit ) that will be charged if this delivery is created.
id string Unique identifier for the quote (always starts with `dqt_`)
kind string The type of object being described. Always “delivery_quote”
pickup_duration integer Estimated minutes until a courier will arrive at the pickup.
external_store_id string Unique identifier used by our Partners to reference a Store or Location

Endpoint Specific Errors

Http Status Code Code Message
400 invalid_params The parameters of your request were invalid.
400 unknown_location The specified location was not understood.
400 address_undeliverable The specified location is not in a deliverable area.
400 address_undeliverable_limited_couriers The specified location is not in a deliverable area at this time because all couriers are currently busy.
400 pickup_window_too_small The pickup window needs to be at least 10 minutes long.
400 dropoff_deadline_too_early The dropoff deadline needs to be at least 20 minutes after the dropoff ready time.
400 dropoff_deadline_before_pickup_deadline The dropoff deadline needs to be after the pickup deadline.
400 dropoff_ready_after_pickup_deadline The dropoff ready time needs to be at or before the pickup deadline.
400 pickup_ready_too_early The pickup ready time cannot be in the past.
400 pickup_deadline_too_early The pickup deadline time needs to be at least 20 minutes from now.
400 pickup_ready_too_late The pickup ready time needs to be within the next 30 days.
404 customer_not_found Customer does not exist.
408 request_timeout The request timed out…
402 customer_suspended Your account is passed due. Payment is required.
403 customer_blocked Your account is not allowed to create deliveries.
429 customer_limited Your account’s limits have been exceeded.
500 unknown_error An unknown error happened.

© 2023 Uber Technologies Inc.