Skip to main content

Find stores offering delivery

POST /v2/fulfillment/stores/delivery

Returns an array of stores that offer delivery for the customer's location. A store is eligible delivery orders when the pickup_only flag is set to false.

If a store offers alcohol, the alcohol flag is set to true. For more information, see Alcohol compliance.

After a store is selected, save the store location_code. You specify the location when retrieving the list of available time slots and creating an order.

Security#

NameInDescription
AuthorizationheaderThe Authorization header with the bearer token acquired during authentication.

Request#

FieldTypeRequiredDescription
find_byFind_byโœ…The location to use for finding the stores.

Find_by Object#

One of the following:

FieldTypeRequiredDescription
latitudenumberโœ…The latitude coordinate.
longitudenumberโœ…The longitude coordinate.

or

FieldTypeRequiredDescription
address_line_1stringโœ…The first address line.
address_line_2stringThe second address line.
address_typestringThe type of address, e.g., "residential".
postal_codestringโœ…The postal/zip code of the address.

Request Examples#

curl --request POST \  --url https://connect.instacart.com/v2/fulfillment/stores/delivery \  --header 'Accept: application/json' \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{  "find_by": {    "latitude": 1,    "longitude": 1  }}'

Response#

FieldTypeRequiredDescription
storesArray(Stores)The returned stores.
is_partialbooleanIf the zip code has partial coverage.

Stores Object#

FieldTypeRequiredDescription
namestringโœ…The name of the store.
location_codestringโœ…The store code, which is used in other requests to identify the store.
flagsFlagsโœ…Properties of the store.

Flags Object#

FieldTypeRequiredDescription
alcoholbooleanโœ…Whether the store supports alcoholic orders.
pickupbooleanโœ…Whether the store supports pickup orders.
pickup_onlybooleanโœ…Whether the store only supports pickup orders (no delivery).

Response Examples#

{  "stores": [    {      "name": "Test Warehouse Location",      "location_code": "000-314",      "flags": {        "alcohol": false,        "pickup": true,        "pickup_only": false      }    },    {      "name": "Test Warehouse Location",      "location_code": "000-314",      "flags": {        "alcohol": true,        "pickup": true,        "pickup_only": false      }    }  ],  "is_partial": false}