Skip to main content

Find stores offering pickup

POST /v2/fulfillment/stores/pickup

Returns an array of stores that offer pickup for the customer's location. A store is eligible for pickup when the pickup flag or the pickup_only flag is set to true.

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
postal_codestringโœ…The postal/zip code, should have only uppercase letters and no spaces, e.g., "90210" or "M6K3L5".

Request Examples#

curl --request POST \  --url https://connect.instacart.com/v2/fulfillment/stores/pickup \  --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.

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": true,        "pickup": true,        "pickup_only": false      }    },    {      "name": "Test Warehouse Location",      "location_code": "000-314",      "flags": {        "alcohol": true,        "pickup": true,        "pickup_only": true      }    }  ]}