• Register

Promotions Sorted

Description

The Promotions API call allows the users to get Deals and Promotion data set grouped and sorted by FOB to match data rendered on website.

HTTP Method and Request URL

GET

https://api.bloomingdales.com/v3/promotions/sorted?channel=[SITE]
 

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 Detemines output format. Can be application/json or application/xml. Yes

application/json

application/xml

Query Parameters
Parameter Description Mandatory Sample Value
channel Channel for the Promotion
No SITE or MOBILE

back to top

Sample Requests and Responses

Sample Request

Request URL:

GET

https://api.bloomingdales.com/v3/promotions/sorted?channel=SITE

HTTP Header:

x-macys-webservice-client-id: xmj9js4jkdpe1983fmwu98gh

Accept: application/json

 back to top

Sample Response

{
sortedPromotions: [9]
0:  {
fob: "Jewelry & Watches"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.bloomingdales.com/cms/deals/JewelryCoupon"
couponHeading: "15% off necklaces"
couponDescription: "Jewelry Coupon Desc"
couponShortCode: "JEWEL "
couponNumber: "59005 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [5]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "587"
}-
1:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "jewelry seo description"
}-
2:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "jewelry seo keywords"
}-
3:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "jewelry seo title"
}-
4:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
1:  {
fob: "Cosmetics & Fragrances"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.macys.com/cms/deals/BeautyCoupon"
couponHeading: "mildly long 20% off beauty heading"
couponSubHeading: "shop now"
couponDescription: "Beauty Coupon Desc"
couponShortCode: "BEAUTY "
couponNumber: "59007 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [5]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "588"
}-
1:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "beauty seo description"
}-
2:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "beauty seo keywords"
}-
3:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "beauty seo title"
}-
4:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
2:  {
fob: "Sitewide/Featured Offers"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.bloomingdales.com/cms/deals/SitewideCoupon"
couponHeading: "20% off sitewide"
couponDescription: "Sitewide Coupon Desc"
couponMoreDescription: "sitewide desc 2"
couponShortCode: "SITE "
couponNumber: "59000 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [5]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "1000"
}-
1:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "sitewide seo description"
}-
2:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "sitewide seo keywords"
}-
3:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "sitewide seo title"
}-
4:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
3:  {
fob: "Women"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.bloomingdales.com/cms/deals/WomenCoupon"
couponHeading: "sample women coupon"
couponSubHeading: "15% off women"
couponDescription: "Women Coupon Desc"
couponShortCode: "WOMEN "
couponNumber: "59001 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [5]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "1001"
}-
1:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "women seo description"
}-
2:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "women seo keywords"
}-
3:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "women seo title"
}-
4:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
4:  {
fob: "Handbags & Shoes"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.bloomingdales.com/cms/deals/HandbagCoupon"
couponHeading: "buy one handbag get one free"
couponSubHeading: "save now"
couponDescription: "Handbag Coupon Desc"
couponMoreDescription: "handbag desc 2"
couponShortCode: "HAND "
couponNumber: "59002 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [6]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "1002"
}-
1:  {
attributeName: "CPN_PASSBK_URL"
attributeValue: "http://www.qa29creativemacys.fds.com/cms/deals/MORE_CHOICES_Sale_15percent_off_W3030173"
}-
2:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "handbag seo description"
}-
3:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "handbag seo keywords"
}-
4:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "handbag seo title"
}-
5:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
5:  {
fob: "Men"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.bloomingdales.com/cms/deals/MenCoupon"
couponHeading: "epic pants sale"
couponSubHeading: "20% off mens pants"
couponDescription: "Men Coupon Desc"
couponShortCode: "MEN "
couponNumber: "59002 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [5]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "1003"
}-
1:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "men seo description"
}-
2:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "men seo keywords"
}-
3:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "men seo title"
}-
4:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
6:  {
fob: "Home"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.bloomingdales.com/cms/deals/HomeCoupon"
couponHeading: "free home appliance"
couponSubHeading: "with purchase"
couponDescription: "Home Coupon Desc"
couponShortCode: "HOME "
couponNumber: "59004 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [5]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "1004"
}-
1:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "home seo description"
}-
2:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "home seo keywords"
}-
3:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "home seo title"
}-
4:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
7:  {
fob: "Kids"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.bloomingdales.com/cms/deals/KidsCoupon"
couponHeading: "children sale"
couponDescription: "Kids Coupon Desc"
couponShortCode: "KIDS "
couponNumber: "59006 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [5]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "1005"
}-
1:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "kids seo description"
}-
2:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "kids seo keywords"
}-
3:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "kids seo title"
}-
4:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
8:  {
fob: "Registry"
promotions: [1]
0:  {
global: false
promoId: "0"
coupon: {
couponUrl: "http://www1.bloomingdales.com/cms/deals/RegistryCoupon"
couponHeading: "10% off registry really long heading text in the coupon that spans across the page"
couponSubHeading: "this subheading will be really long too because it is a test case for us"
couponDescription: "Registry Coupon Desc"
couponShortCode: "REGIST "
couponNumber: "59008 "
couponType: "INC"
couponEffectiveDay: 30
couponEffectiveMonth: 5
couponEffectiveYear: 2013
couponExpirationDay: 1
couponExpirationMonth: 8
couponExpirationYear: 2013
displayStartDate: "2013-05-30T00:00:00-04:00"
displayEndDate: "2013-08-01T00:00:00-04:00"
couponAttributes: [5]
0:  {
attributeName: "CPN_ASSOCIATED_FOB_ID"
attributeValue: "1006"
}-
1:  {
attributeName: "CPN_SEO_DESCRIPTION"
attributeValue: "registry seo description"
}-
2:  {
attributeName: "CPN_SEO_KEYWORDS"
attributeValue: "registry seo keywords"
}-
3:  {
attributeName: "CPN_SEO_TITLE"
attributeValue: "registry seo title"
}-
4:  {
attributeName: "IS_OFFERS_ELIGIBLE"
attributeValue: "Y"
}-
-
}-
}-
-
}-
-
}

  back to top

Error Codes

Call Specific Error Codes:

NONE

General Error Handling Documentation:

Click Here

back to top

Docs Navigation