Multi-banner retailers

Retailer organizations that operate affiliated stores or subsidiaries under different names, or banners, are referred to as multi-banner retailers. For example, The Garden might fulfill orders under both their grocery chain banner, The Garden Market, and their specialty wine banner, The Garden’s Fine Wines.

Within the Instacart client configuration, each retail banner is assigned a unique identifier, sometimes referred to as a "slug."

Identifying banners in API requests

If you use the Connect APIs to fulfill orders under different retail banners, you are required to specify the banner associated with each API request. You do this by providing the X-Retailer-Id HTTP header with the banner's slug value.

For example, each API request by The Garden's e-commerce platform for The Garden Market must contain the X-Retailer-Id header with the value the-garden-market.

The following example shows the X-Retailer-Id header sent in an API request:

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' \
 --header 'X-Retailer-Id: the-garden-market' \
  --data '{
  "find_by": {
    "latitude": 37.786602288685934,
    "longitude": -122.39080760236017,
  }
}'

Related topics

• Request headers