• Register

Events

Description

Provides a list of events in store for a given Store ID and date range.

The search can be made by the storeID or storeNumber. storeNumber is the MST store number.

back to top

HTTP Method and Request URL

GET

http://api.bloomingdales.com/v2/store/event?storeId=[storeid]&eventFrom=[date]&eventTo=[date]

back to top

Path and Query Parameters

HTTP Header Parameters
Parameter Description Mandatory Sample Value
x-macys-webservice-client-id Pass the apikey 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
Accept Specifies the output format. Can be application/json or application/xml. Yes

application/json
application/xml

Query Parameters
Parameter Description Mandatory Sample Value
storeId Store number. Yes(not neeeded if searching by storeNumber) 50014 (You can return events for multiple stores by separating them by a comma. Ex. 50014, 110039)
storeNumber MST Store number Yes (not neeeded if searching by storeId) 31(You can return events for multiple stores by separating them by a comma. Ex. 31, 21)

eventFrom

Starting date of events. No Jan 1, 2014
eventTo Ending date of events. No Dec 31, 2014
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/event?storeId=50014&eventFrom=Jan 1, 2014&eventTo=Dec 31, 2014

HTTP Header:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh

Accept: application/json

back to top

Sample Response

{
    "storeEvents": [{
        "eventId": 583312,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Radiant Skin With Guerlain",
        "shortDesc": "Enjoy a personalized skincare consultation and learn the latest tips and tricks to getting georgeous skin at any age. Please call 650-463-2036 for more information.",
        "startDate": "04/11/2014 12:00AM",
        "finishDate": "04/12/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Enjoy a personalized skincare consultation and learn the latest tips and tricks to getting georgeous skin at any age. Please call 650-463-2036 for more information."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "START_TIME",
            "values": ["By Appointment"]
        }]
    }, {
        "eventId": 583314,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Serum Saturday",
        "shortDesc": "Stop by your favorite skincare counter and find the perfect serum to compliment your personalized beauty routine.",
        "startDate": "04/12/2014 12:00AM",
        "finishDate": "04/12/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Stop by your favorite skincare counter and find the perfect serum to compliment your personalized beauty routine."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "END_TIME",
            "values": ["7PM"]
        }, {
            "name": "START_TIME",
            "values": ["10AM"]
        }]
    }, {
        "eventId": 583313,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Clarins Happy Hour",
        "shortDesc": "Join us and learn how to achieve a flawless look with the latest and greatest from Clarins. Plus, receive an exclusive gift with your purchase of two of your favorite Clarins products.* \n\n*One per customer, while supplies last.\n",
        "startDate": "04/16/2014 12:00AM",
        "finishDate": "04/19/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Join us and learn how to achieve a flawless look with the latest and greatest from Clarins. Plus, receive an exclusive gift with your purchase of two of your favorite Clarins products.* 

*One per customer, while supplies last.
"]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "START_TIME",
            "values": ["By Appointment"]
        }]
    }, {
        "eventId": 583316,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Chanel National Artistry With Marc Bertaud",
        "shortDesc": "Join Chanel National Aritst Marc Bertaud for a personalized color and skincare consultation. Space is limited. Please call 650-463-2020 for more information or to book your appointment today.",
        "startDate": "04/16/2014 12:00AM",
        "finishDate": "04/16/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Join Chanel National Aritst Marc Bertaud for a personalized color and skincare consultation. Space is limited. Please call 650-463-2020 for more information or to book your appointment today."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "END_TIME",
            "values": ["6PM"]
        }, {
            "name": "START_TIME",
            "values": ["11AM"]
        }]
    }, {
        "eventId": 583336,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Meet DiorshowArtist Rita Brown",
        "shortDesc": "The Diorshow Artists are known for their insider's take on the hottest trends worn on the runway. Join us for an exclusive opportunity to learn the must have makeup looks of the season. We guarantee heads will turn! Please call 650-463-2003 to make your appointment.",
        "startDate": "04/17/2014 12:00AM",
        "finishDate": "04/17/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["The Diorshow Artists are known for their insider's take on the hottest trends worn on the runway. Join us for an exclusive opportunity to learn the must have makeup looks of the season. We guarantee heads will turn! Please call 650-463-2003 to make your appointment."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "END_TIME",
            "values": ["6PM"]
        }, {
            "name": "START_TIME",
            "values": ["11AM"]
        }]
    }, {
        "eventId": 583315,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Guerlain Spa",
        "shortDesc": "Rejuvinate your skin with a relaxing Guerlain facial using the Orchidee Imperiale collection. Space is limited. Please call 650-463-2036 to book your appointment today.",
        "startDate": "04/18/2014 12:00AM",
        "finishDate": "04/18/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Rejuvinate your skin with a relaxing Guerlain facial using the Orchidee Imperiale collection. Space is limited. Please call 650-463-2036 to book your appointment today."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "END_TIME",
            "values": ["6PM"]
        }, {
            "name": "START_TIME",
            "values": ["11AM"]
        }]
    }, {
        "eventId": 583319,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Lancome Absolue Eye",
        "shortDesc": "Join us and experience the amazing effects of Lancome's Absolue Eye Serum. Please call 650-463-2018 for more information.",
        "startDate": "04/18/2014 12:00AM",
        "finishDate": "04/18/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Join us and experience the amazing effects of Lancome's Absolue Eye Serum. Please call 650-463-2018 for more information."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "END_TIME",
            "values": ["7PM"]
        }, {
            "name": "START_TIME",
            "values": ["10AM"]
        }]
    }, {
        "eventId": 583328,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "New Look With Laura Mercier",
        "shortDesc": "Join our Laura Mercier experts for a lesson on getting a flawless face. Please call 650-463-2016 for more information.",
        "startDate": "04/19/2014 12:00AM",
        "finishDate": "04/19/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Join our Laura Mercier experts for a lesson on getting a flawless face. Please call 650-463-2016 for more information."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "START_TIME",
            "values": ["By Appointment"]
        }]
    }, {
        "eventId": 583329,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Shiseido Spa",
        "shortDesc": "Get healthy, radiant skin with Shiseido's Future Solution LX premium skincare. Please call 650-463-2069 to book your appointment today. Space is limited.",
        "startDate": "04/25/2014 12:00AM",
        "finishDate": "04/25/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Get healthy, radiant skin with Shiseido's Future Solution LX premium skincare. Please call 650-463-2069 to book your appointment today. Space is limited."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "START_TIME",
            "values": ["By Appointment"]
        }]
    }, {
        "eventId": 583330,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "La Prairie Skincare Focus",
        "shortDesc": "Discover the wonders of La Prairie. Enjoy a personalized skincare consultation from the experts. Please call 650-463-2156 for more information.",
        "startDate": "04/26/2014 12:00AM",
        "finishDate": "04/26/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Discover the wonders of La Prairie. Enjoy a personalized skincare consultation from the experts. Please call 650-463-2156 for more information."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "END_TIME",
            "values": ["7PM"]
        }, {
            "name": "START_TIME",
            "values": ["10AM"]
        }]
    }, {
        "eventId": 583331,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "SK-II Facil Bar",
        "shortDesc": "Experience SK-II's signature mini-facial, complimentary with any SK-II purchase. Space is limited. To make an appointment with an SK-II skincare specialist call 650-463-2070.",
        "startDate": "04/26/2014 12:00AM",
        "finishDate": "04/26/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Experience SK-II's signature mini-facial, complimentary with any SK-II purchase. Space is limited. To make an appointment with an SK-II skincare specialist call 650-463-2070."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "END_TIME",
            "values": ["7PM"]
        }, {
            "name": "START_TIME",
            "values": ["10AM"]
        }]
    }, {
        "eventId": 583332,
        "storeId": 50014,
        "storeNumber": 31,
        "name": "Beauty Trend Show Hosted By Harvey Helms",
        "shortDesc": "Join beauty culturist and author Harvey Helms for a fun-filled beauty presentation featuring experts from our favorite beauty brands. Plus, take home a special gift with your $125.00 beauty purchase.*\n\nYour $25 reservation fee will be credited toward the beauty purchase of your choice. \n\n*One per customer, while supplies last.",
        "startDate": "04/26/2014 12:00AM",
        "finishDate": "04/26/2014 11:59PM",
        "attributes": [{
            "name": "EVENT_DETAIL_ENABLED",
            "values": ["FALSE"]
        }, {
            "name": "SHORT_DESC",
            "values": ["Join beauty culturist and author Harvey Helms for a fun-filled beauty presentation featuring experts from our favorite beauty brands. Plus, take home a special gift with your $125.00 beauty purchase.*

Your $25 reservation fee will be credited toward the beauty purchase of your choice. 

*One per customer, while supplies last."]
        }, {
            "name": "STORE_EVENT_TYPE",
            "values": ["Beauty"]
        }, {
            "name": "WC_EVENT",
            "values": ["FALSE"]
        }, {
            "name": "END_TIME",
            "values": ["11AM"]
        }, {
            "name": "START_TIME",
            "values": ["10"]
        }]
    }],
    "success": true
}

 

back to top

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here

back to top

Docs Navigation