Uber Developers

Find Deliverable Stores

GEThttps://api.uber.com/v1/eats/deliveries/stores

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 guide in the navigation panel.

For merchants with multiple locations, this endpoint provides the merchant the ability to retrieve the best store to fulfill the order.

¶ Authorization

OAuth 2.0 Bearer token with the eats.deliveries scope. For more information, see Authentication.

¶ Query Parameters

Name	Type	Required	Description
`place_id`	`string`	No	Google Place ID, a unique identifier from Google’s system, representing a specific place. Either this or `latitude` and `longitude` should be specified.
`place_provider`	`string`	No	Provider for this id. This currently needs to be “google_places”. Either this or `latitude` and `longitude` should be specified.
`pickup_at`	`long`	No	Unix timestamp in milliseconds that represents when the order will be ready for pickup. A value of `0` indicates that Uber should fulfill this order ASAP.
`latitude`	`double`	No	Latitude coordinate. Either this or `place_id` and `place_provider` should be specified.
`longitude`	`double`	No	Longitude coordinate. Either this or `place_id` and `place_provider` should be specified.

¶ Response Body Parameters

Name	Type	Required	Description
`stores`	`array`	Yes	An array of stores that can deliver to the provided dropoff address. This is sorted by ‘etd’ in ascending order.
`stores[].store_id`	`string`	Yes	Uber’s globally unique private identifier for the merchant’s Uber Direct store.
`stores[].external_store_id`	`string`	Yes	The merchant’s store identifier provided during onboarding.
`stores[].etd`	`long`	Yes	The estimated time of delivery calculated using the estimated drive time and the store’s default preparation time. This is a Unix timestamp in milliseconds.

¶ Response Body Example

Status-Code: 200

{
    "stores": [
        {
            "external_store_id": "2",
            "store_id": "4rtf2e50-ef96-4851-bf0c-983caf45b5ad",
            "etd": 1596493991392
        },
        {
            "external_store_id": "1",
            "store_id": "b98e40ee-4a96-44de-aa3f-8c0610ab6316",
            "etd": 1596494291392
        },
        {
            "external_store_id": "3",
            "store_id": "b3dd9330-8cba-90df-82d2-ef06a8a973c3",
            "etd": 1596494591392
        }
    ]
}