Detail

GetStoreDetail

Description

This service allows users to find the closest Bloomingdales' stores. It supports look up by zip code, by city and state, or by latitude and longitude.

back to top

HTTP Method and Request URL

GET

http://api.bloomingdales.com/v2/store/detail?zipcode=zipcode&city=city&state=state&latitude=latitude&longitude=longitude

back to top

Path and Query Parameters

HTTP Header Parameters
Parameter Description Mandatory Sample Value
Accept Detemines output format. Can be application/json or application/xml. Yes

application/json

application/xml

x-macys-webservice-client-id Pass the api key as a header value which is called x-macys-webservice-client-id. The api key is the 24 character alphanumeric string assigned to your application when you registered it. Go to http://developer.bloomingdales.com/apps/mykeys for a list of your API keys.
Yes xmj9js4jkdpe1983fmwu98gh
Query Parameters
Parameter Description Mandatory Sample Value

city
state

Stores look up by combination of state and city. Third in priority if latitude and longitude and/or zipcode also supplied. No  city=Sunnyvale&state=CA
latitude
longitude
Stores look up by global coordinates. First in priority if city and state and/or zipcode also supplied. No  latitude=37.355965&longitude=-122.01318
zipcode Stores look up by zip code. Second in priority if latitude and longitude and/or city and state also supplied. No  zipcode=94086
callback If sent, the format is JSONP (JSON with Padding) with the callback returned with the JSON response. You can put anything in the callback parameter and whatever you send is returned.
No magicofbloomingdalesapi

back to top

Sample Requests and Responses

Sample Request

Request URL:

GET

http://api.bloomingdales.com/v2/store/detail?latitude=37.355965+&longitude=-122.01318

HTTP Headers:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh 

Accept:application/json

back to top

Sample Response

{
    "store": [{
        "storeId": 50014,
        "divisionId": "1",
        "locationNumber": 366,
        "storeNumber": 31,
        "name": "Stanford",
        "storemap": "http://maps.googleapis.com/maps/api/staticmap?format=JPEG&zoom=14&size=400x400&sensor=false&markers=icon:http://assets.bloomingdales.com/navapp/dyn_img/site_ads/pin.png%7C37.44291,%20-122.171266&client=gme-macysinc&signature=YktGWjipMCPKdTyka5Aq7BcBXhk%3D",
        "phone": "650-463-2000",
        "address": {
            "line1": "1 Stanford Shopping Center",
            "line2": "",
            "city": "Palo Alto",
            "state": "CA",
            "countryCode": "USA ",
            "zipCode": "94304"
        },
        "workingHours": [{
            "date": "2014-04-07",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-08",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-09",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-10",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-11",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-12",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-13",
            "storeopenhour": "12:00",
            "storeclosehour": "19:00"
        }, {
            "date": "2014-04-14",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-15",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-16",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-17",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-18",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-19",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }],
        "location": {
            "latitude": 37.44291,
            "longitude": -122.171266
        },
        "distance": 10.553772113639955,
        "units": "mi",
        "order": 1,
        "attributes": [{
            "name": "BOPS_NPD",
            "values": ["20-APR-14", "25-DEC-14", "27-NOV-14"]
        }, {
            "name": "BOPS_STORE_OPEN_BUFFER",
            "values": ["01:00"]
        }, {
            "name": "BOPS_STORE_PHONE",
            "values": ["6504632220"]
        }, {
            "name": "PORTRAIT_IMAGE",
            "values": ["/dyn_img/stores/stanford.jpg"]
        }, {
            "name": "MANAGER_NAME",
            "values": ["Dana Zeldin"]
        }, {
            "name": "STORE_REGION_LOCATION",
            "values": ["West"]
        }, {
            "name": "TIMEZONE",
            "values": ["PST"]
        }, {
            "name": "LATITUDE",
            "values": ["37.44291"]
        }, {
            "name": "BOPS_PICKUP_INSTRUCTIONS",
            "values": ["-"]
        }, {
            "name": "DAYLIGHT_SAVINGS_INDICATOR",
            "values": ["TRUE"]
        }, {
            "name": "SL_BRIDAL",
            "values": ["TRUE"]
        }, {
            "name": "STORE_TYPE_DESC",
            "values": ["NOF"]
        }, {
            "name": "SERVICES",
            "values": ["The Registry
650-463-2126

Credit Customer Service
866-593-3927"]
        }, {
            "name": "STORE_LISTING_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "BOPS_PICKUP_CUTOFF",
            "values": ["01:00"]
        }, {
            "name": "BOPS_SLA_HOURS",
            "values": ["4"]
        }, {
            "name": "LONGITUDE",
            "values": ["-122.171266"]
        }, {
            "name": "GMT_OFFSET",
            "values": ["-8"]
        }, {
            "name": "BOPS_ELIGIBILITY",
            "values": ["FALSE"]
        }, {
            "name": "HAS_EVENTS",
            "values": ["TRUE"]
        }]
    }, {
        "storeId": 110066,
        "divisionId": "1",
        "locationNumber": 6086,
        "storeNumber": 190,
        "name": "Livermore Paragon Outlets",
        "storemap": "http://maps.googleapis.com/maps/api/staticmap?format=JPEG&zoom=14&size=400x400&sensor=false&markers=icon:http://assets.bloomingdales.com/navapp/dyn_img/site_ads/pin.png%7C37.6964111,%20-121.84259&client=gme-macysinc&signature=yNmVHwoPYaVvhAJRbzmTnTJm4BE%3D",
        "phone": "925-273-6190",
        "address": {
            "line1": "NOW OPEN!",
            "line2": "3130 Paragon Outlets Drive",
            "city": "Livermore",
            "state": "CA",
            "countryCode": "USA ",
            "zipCode": "94551"
        },
        "workingHours": [{
            "date": "2014-04-07",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-08",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-09",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-10",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-11",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-12",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-13",
            "storeopenhour": "10:00",
            "storeclosehour": "20:00"
        }, {
            "date": "2014-04-14",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-15",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-16",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-17",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-18",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-19",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }],
        "location": {
            "latitude": 37.6964111,
            "longitude": -121.84259
        },
        "distance": 25.31187308051194,
        "units": "mi",
        "order": 2,
        "attributes": [{
            "name": "SL_BRIDAL",
            "values": ["FALSE"]
        }, {
            "name": "STORE_TYPE_DESC",
            "values": ["OUT"]
        }, {
            "name": "PORTRAIT_IMAGE",
            "values": ["http://assets.bloomingdales.com/dyn_img/stores/banners/110066.jpg"]
        }, {
            "name": "MANAGER_NAME",
            "values": ["Larry Kwan"]
        }, {
            "name": "STORE_REGION_LOCATION",
            "values": ["Mid West"]
        }, {
            "name": "STORE_LISTING_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "LONGITUDE",
            "values": ["-121.84259"]
        }, {
            "name": "LATITUDE",
            "values": ["37.6964111"]
        }, {
            "name": "BOPS_ELIGIBILITY",
            "values": ["FALSE"]
        }, {
            "name": "HAS_EVENTS",
            "values": ["TRUE"]
        }]
    }, {
        "storeId": 110039,
        "divisionId": "1",
        "locationNumber": 2371,
        "storeNumber": 22,
        "name": "San Francisco Centre",
        "storemap": "http://maps.googleapis.com/maps/api/staticmap?format=JPEG&zoom=14&size=400x400&sensor=false&markers=icon:http://assets.bloomingdales.com/navapp/dyn_img/site_ads/pin.png%7C37.7849478,%20-122.4066717&client=gme-macysinc&signature=R7AdZikqJGWQG9gdMD5ni-NJXJY%3D",
        "phone": "415-856-5300",
        "address": {
            "line1": "845 Market Street",
            "line2": "",
            "city": "San Francisco",
            "state": "CA",
            "countryCode": "USA ",
            "zipCode": "94103"
        },
        "workingHours": [{
            "date": "2014-04-07",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-08",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-09",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-10",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-11",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-12",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-13",
            "storeopenhour": "11:00",
            "storeclosehour": "19:00"
        }, {
            "date": "2014-04-14",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-15",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-16",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-17",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-18",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }, {
            "date": "2014-04-19",
            "storeopenhour": "10:00",
            "storeclosehour": "21:00"
        }],
        "location": {
            "latitude": 37.7849478,
            "longitude": -122.4066717
        },
        "distance": 36.645318614634284,
        "units": "mi",
        "order": 3,
        "attributes": [{
            "name": "BOPS_NPD",
            "values": ["20-APR-14", "25-DEC-13", "25-DEC-14", "27-NOV-14", "28-NOV-13"]
        }, {
            "name": "BOPS_STORE_OPEN_BUFFER",
            "values": ["01:00"]
        }, {
            "name": "SL_SHOPPER",
            "values": ["FALSE"]
        }, {
            "name": "PORTRAIT_IMAGE",
            "values": ["/dyn_img/stores/sanfrancisco.jpg"]
        }, {
            "name": "SL_VISITOR",
            "values": ["FALSE"]
        }, {
            "name": "TIMEZONE",
            "values": ["PST"]
        }, {
            "name": "LATITUDE",
            "values": ["37.7849478"]
        }, {
            "name": "BOPS_PICKUP_INSTRUCTIONS",
            "values": ["Concierge on level 1"]
        }, {
            "name": "DAYLIGHT_SAVINGS_INDICATOR",
            "values": ["TRUE"]
        }, {
            "name": "STORE_TYPE_DESC",
            "values": ["NOF"]
        }, {
            "name": "SL_MATTRESS",
            "values": ["FALSE"]
        }, {
            "name": "BOPS_SLA_HOURS",
            "values": ["4"]
        }, {
            "name": "BOPS_PICKUP_CUTOFF",
            "values": ["01:00"]
        }, {
            "name": "SL_MATERNITY",
            "values": ["FALSE"]
        }, {
            "name": "BOPS_STORE_PHONE",
            "values": ["4158565402"]
        }, {
            "name": "MANAGER_NAME",
            "values": ["Alan Svensen"]
        }, {
            "name": "SL_RESTAURANT",
            "values": ["FALSE"]
        }, {
            "name": "STORE_REGION_LOCATION",
            "values": ["West"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Visit our new store in San Francisco, now open!"]
        }, {
            "name": "SL_BRIDAL",
            "values": ["TRUE"]
        }, {
            "name": "SL_FURNITURE",
            "values": ["FALSE"]
        }, {
            "name": "SERVICES",
            "values": ["Online Order Pickup
Concierge on level 1
415-856-5402

Personal Shopping - At Your Service
415-856-5537

The Registry
415-856-5378

Credit Customer Service
866-593-3927

Visitor Services
415-856-5477

WiFi available at this location."]
        }, {
            "name": "STORE_LISTING_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SL_THISIT",
            "values": ["FALSE"]
        }, {
            "name": "LONGITUDE",
            "values": ["-122.4066717"]
        }, {
            "name": "SL_DESIGN",
            "values": ["FALSE"]
        }, {
            "name": "GMT_OFFSET",
            "values": ["-8"]
        }, {
            "name": "BOPS_ELIGIBILITY",
            "values": ["TRUE"]
        }, {
            "name": "HAS_EVENTS",
            "values": ["TRUE"]
        }]
    }],
    "success": true
}

 

back to top

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here

back to top

Docs Navigation