Available Stores

GET
/v1beta/retailers

Returns list of available stores for a specified location.

To get available retailers for US or DE country you need to specify zip code so we will be able to verify available stores in the specified region.

You can use retailer identifiers for store transfering API and for cart API

If a country code was not specified, will be returned retailers available around the world.

Parameters

ATTRIBUTETYPEDESCRIPTION
country

Country code in ISO 3166-1 alpha-2 format. E.g. GB, US, AU...

zipcode

Postal code

language

Language supported by retailer in ISO 639-1 format e.g. en, it, de ...

Default value: en

Sample Request

curl "https://graph.whisk.com/v1beta/retailers?region=GB" \ -H "Accept: application/json" \ -H "Authorization: Token <Access-Token>"

Response

ATTRIBUTETYPEDESCRIPTION
retailers*array [Retailer]

Retailer

ATTRIBUTETYPEDESCRIPTION
id*string
name*string
displayNamestring
countrystring
currencystring
logoImageContainer

Sample Response

{ "retailers": [ { "id": "9dd9f254f3a3476a9801f7d9e236a0e3", "name": "Tesco", "displayName": "Tesco", "country": "GB", "currency": "GBP", "logo": { "url": "https://res.cloudinary.com/whisk/image/upload/whisk3/supermarket_select_dropdown/tesco-logo.png", "width": 134, "height": 36 }, "urls": { "signupUrl": "https://secure.tesco.com/account/en-GB/register", "forgotPasswordUrl": "https://secure.tesco.com/account/en-GB/forgotten-password", "trolleyUrl": "https://www.tesco.com/groceries/en-GB/slots" } }, { "id": "6b79b815531d45e1aac461fad43fb9c6", "name": "Asda", "displayName": "Asda", "country": "GB", "currency": "GBP", "logo": { "url": "https://res.cloudinary.com/whisk/image/upload/v1498669609/whisk3/supermarket_select_dropdown/asda-logo.png", "width": 123, "height": 36 }, "urls": { "signupUrl": "http://www.awin1.com/cread.php?awinmid=2834&awinaffid=137043&clickref=signup&p=https://groceries.asda.com/registration?cmpid=otc-good-_-ghs-_-whisk-_-online-checkout-_-sign-up", "forgotPasswordUrl": "http://www.awin1.com/cread.php?awinmid=2834&awinaffid=137043&clickref=forgotten&p=https://groceries.asda.com/asda-webstore/account/password.shtml#/forgotten_password", "trolleyUrl": "http://www.awin1.com/cread.php?awinmid=2834&awinaffid=137043&clickref=checkoutstore&p=http://groceries.asda.com/asda-webstore/landing/home.shtml?cmpid=otc-good-_-ghs-_-whisk-_-online-checkout-_-checkout" } }, { "id": "58d2d7b499e04a0aa8823bf2afc1f582", "name": "Ocado", "displayName": "Ocado", "country": "GB", "currency": "GBP", "logo": { "url": "https://res.cloudinary.com/whisk/image/upload/whisk3/supermarket_select_dropdown/ocado-logo.png", "width": 169, "height": 36 }, "urls": { "signupUrl": "http://www.dpbolvw.net/click-7163739-11439256", "forgotPasswordUrl": "http://www.ocado.com/webshop/requestForgottenPassword.do", "trolleyUrl": "http://www.dpbolvw.net/click-7163739-11439256" } }, { "id": "d2cda0acd2c74e71a2f389daa2ff2cec", "name": "Waitrose", "displayName": "Waitrose", "country": "GB", "currency": "GBP", "logo": { "url": "https://res.cloudinary.com/whisk/image/upload/whisk3/supermarket_select_dropdown/waitrose-logo.png", "width": 176, "height": 36 }, "urls": { "signupUrl": "http://www.waitrose.com/", "forgotPasswordUrl": "https://www.waitrose.com/webapp/wcs/stores/servlet/ResetPasswordForm", "trolleyUrl": "http://www.awin1.com/cread.php?awinmid=3691&awinaffid=137043&p=https://www.waitrose.com/webapp/wcs/stores/servlet/LogonForm?URL=ViewTrolley" } }, { "id": "0d01dd723f484801bf0b7c26dc4f7985", "name": "AmazonFresh", "displayName": "Amazon Fresh", "country": "GB", "currency": "GBP", "logo": { "url": "https://whisk-res.cloudinary.com/image/upload/v1515760703/whisk3/supermarket_select_dropdown/amazon-fresh-2.png", "width": 174, "height": 36 } } ] }