Interactive API Console

• Ad Media Services

  • List Methods
  • Expand Methods

  • GET Category Ad Media v2/admedia/category

    This service allows you to retrieve ad media specific to a product category ID. Please click here for the static documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON.
    categoryId		string	Specify one or more category Id's separated by comma. (Required) Ex. 27058
    channel	SITE REGISTRY	string	Channel can be either SITE, REGISTRY (Required) Ex. SITE
    secure	false true	string	By default this is set to false. If set to true links in response will be https NOT http. (Optional) Ex. true
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Global Ad Media :version/admedia/global

    This service allows you to retrieve global ad media, that is Ad's that are not for a specific Product Category ID. You must know what the Media Pool Name of the Ad is to retrieve the Ad using this call. Please click here for the static documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :version	v3 v2	string	API Version (New customers should use v3)(Required) Ex. v3
    poolName		string	Media Pool Name. Specify one or more pool names separated by comma Ex. GLOBALFOOTER,ABOVE_NAV_POOL.(Required) Ex. GLOBALFOOTER
    secure	false true	string	By default this is set to false. If set to true links in response will be https NOT http (Optional) Ex. true
    callback		string	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.(Optional) Ex. magicofmacysapi

• Catalog Services

  • List Methods
  • Expand Methods

  • GET Category Index v3/catalog/category/index

    This API provides an option to obtain all the categoryIDs in a hierarchical structure by making a call with the ‘index’ parameter. Then you can use the CategoryBrowse call (Below) to make subsequent calls to get the more detailed category info. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    category		string	Use this parameter to narrow the response returned by category ID. (Optional) Ex. 118
    depth		string	Number between 1-5. This allows you to return additional layers of subcategories. (Optional) Ex. 2
    callback		string	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.(Optional) Ex. magicofmacysapi

  • GET Category Browse v3/catalog/category/:categoryId

    The CategoryBrowse service can retrieve information on the hierarchy of product categories as on Macys.com. In addition to the hierarchy details such as category description, Product IDs within the category & facets that can appear for those products can be retrieved.The API enables users to obtain category details by specifying a category ID. All of these category ID's can be pulled from the CategoryIndex call (above). Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :categoryId		int	Multiple Category ID's can be sent by seperating them by Comma's: Maximum of 250 (Optional). Ex. 118
    show	product facet attribute	string	Every show parameter specified would enable users to restrict the service response to contain only the desired details about the category. By default all details of a category are shown. (Optional) Ex. product, facet, attribute.
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Category Brand Index v4/catalog/category/brandindex/:categoryId

    This API allows users to specify Category(s) and retrieve the complete list of Brands for that Category(s). This is called the Brand Index. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :categoryId		int	Unique ID for each category. Multiple Category ID's can be sent in one call by comma separating them. (Required) Ex. 3111
    refcatid		string	Reference Category ID. This is an higher level category ID for the category you are trying to get brand index information for. For instance your higher level Category would be Womens (refcatid=118) and your nested category ID would be Jeans (3111). (Optional) Ex. 118
    callback		int	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.(Optional) Ex. magicofmacysapi

  • GET Category Browse Product v3/catalog/category/:categoryId/browseproducts

    The GetCategoryBrowse API call retrieves a list of products from a given category allowing you to browse the products. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :categoryId		int	Category ID (Required) Ex. 118
    resultsperpage		string	Results per page (Number 1-100). Default is 12. (Optional) Ex. 20
    currentpage		string	Current page number requested. Default: 1 (Optional) Ex. 3
    show	facet product	string	You can use this parameter to show only products or only facets . We return both facets and products by default.(Optional) Ex. product, facet.
    sortby	customerrating name bestseller newarrival price	string	Sort By (Optional) Ex. customerrating
    sortorder	asc desc	string	Sort Order(Optional) Ex. asc
    imagewidth		string	Image Width(Optional) Ex.100 (Pixels)
    imagequality		string	Image Quality (Optional) Ex. 90
    upcimagewidth		string	UPC Image Width (Optional) Ex.100 (Pixels)
    swatchimagewidth		string	Swatch Image Width (Optional) Ex.100 (Pixels)
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Product Index v3/catalog/product/index

    Get all products in our database using Product ID. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    category		string	Use this parameter to narrow the products returned by category ID. (Optional) Ex. 118
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Product Detail V3 (Using Product ID) v3/catalog/product/:productId

    Get product details in our database using Product ID. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :productId		int	Product ID(s). Multiple products can be returned if you separate the Product ID's with commas. (Required) Ex. 77589,166725
    show		string	You can specify which values are returned. By default we return each attribute except Reviews and Promotion. To return this data you will need to be specified using the 'show' query parameter. You can specify multiple values by comma separating them. Available values: summary, price, attribute, promotion, image, category, availability, rebate, upc, review (Optional) Ex. summary or summary,price,rebate
    imagewidth		string	Image Width (Optional) Ex.100 (Pixels)
    imagequality		string	Imager Quality (Optional) Ex.90
    upcimagewidth		string	UPC Image Width (Optional) Ex.100 (Pixels)
    swatchimagewidth		string	Swatch Image Width (Optional) Ex.100 (Pixels)
    numOfReviews		string	Number of Reviews (Optional) Ex. 3
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Product Detail V3 (Using UPC) v3/catalog/product

    Get product details in our database using UPC. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    upc		int	UPC of the product. Multiple products can be returned if you separate the UPC's with commas. (Required) Ex. 50946872827,4003683257743
    show		string	You can specify which values are returned. By default we return each attribute except Reviews and Promotions. To return this data you will need to use the 'show' query parameter. You can specify multiple values by comma separating them. Available values: summary, price, attribute, promotion, image, category, availability, rebate, upc, review (Optional) Ex. summary or summary,price,rebate
    imagewidth		string	Image Width (Optional) Ex.100 (Pixels)
    upcimagewidth		string	UPC Image Width (Optional) Ex.100 (Pixels)
    swatchimagewidth		string	Swatch Image Width (Optional) Ex.100 (Pixels)
    numOfReviews		string	Number of Reviews (Optional) Ex. 3
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Product Detail V4 (Using Product ID) v4/catalog/product/:productId

    Get product details in our database using Product ID. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :productId		int	Product ID(s). Multiple products can be returned if you separate the Product ID's with commas. (Required) Ex. 77589,166725 You can also specify what objects are returned here. Please visit the static documentation to view details
    retrieveallupcs		string	The parameter retrieveallupcs can be set to true or false. When set to true all upcs including inactive or unavailable upcs are returned. By default it is set to false. (Optional) Ex.false
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Product Detail V4 (Using UPC ID) v4/catalog/product/upc/:upcId

    Get product details in our database using Product ID. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :upcId		int	Multiple UPCs can be returned if you separate the UPC ID's with commas. (Required) Ex. 50946872827. You can also specify what objects are returned here. Please visit the static documentation to view details
    retrieveallupcs		string	The parameter retrieveallupcs can be set to true or false. When set to true all upcs including inactive or unavailable upcs are returned. By default it is set to false. (Optional) Ex.false
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Product Recommendations V4 v4/recommendations/product/:productId

    The Product recommendations service allows you to specify a product and return related products that are recommended just as is done on Macys.com. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :productId		int	Product ID of the product you would like to return recommendations for (Required) Ex. 77589.
    visitorid		string	Visitor ID is a unique ID that captures a person's session. (Required) Ex.123456789
    maxprods		string	Max product returned. Default is 10. This number should be between 1 and 9.(Optional) Ex.5
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET BOPS Product Availability (Using Product ID) V4 v4/catalog/bops/product/:productId

    The V4 BOPS (Buy Online Pick-up in Store) Product Availability service allows you specify a Product ID and return the products BOPS availability at a nearby store using zipcode, city-state, or locationnumber. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :productId		int	Product ID of the product you would like to return BOPS availability for. Multiple Product ID's can be specified here by comma separating. (Required) Ex. 77589. You can also specify what objects are returned here. Please visit the static documentation to view details
    locationNumber		int	Location number of the area you are trying to locate a BOPS product. Required if you do not specify latitude/longitude, zipcode or city/state. (Optional) Ex.5459
    latitude		int	BOPS look up by global coordinates. You must specify longitude parameter if you specify the latitude parameter. Required if you do not specify locationNumber, zipcode or city/state. (Required if also using longitude parameter) Ex. 37.355965
    longitude		int	BOPS look up by global coordinates. You must specify latitude parameter if you specify the longitude parameter. First in priority if city and state and/or zipcode also supplied.(Required if also using latitude parameter) Ex. -122.01318
    zipCode		int	Zip code of area you are trying to locate a BOPS product. Required if you do not specify locationNumber or city/state. (Optional) Ex.94105
    city		string	Zip code of area you are trying to locate a BOPS product. You must specify state parameter if you specify the city parameter. Required if you do not specify locationNumber, latitude/longitude, or zipcode. (Optional) Ex.San Francisco
    state		string	Zip code of area you are trying to locate a BOPS product. You must specify city parameter if you specify the state parameter. Required if you do not specify locationNumber, latitude/longitude, or zipcode. (Optional) Ex.CA
    distance		string	Distance from location specified above using the locationNumber, zipcode, or city/state parameter. Default is 200 (miles). Can be a number between 1-200. (Optional) Ex.50
    numberOfStores		string	Distance from location specified above using the locationNumber, zipcode, or city/state parameter. Default is 15. Can be a number between 1-15. (Optional) Ex.5
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET BOPS Product Availability (Using UPC ID) V4 v4/catalog/bops/upc/:upcId

    The V4 BOPS (Buy Online Pick-up in Store) Product Availability service allows you specify a Product ID and return the products BOPS availability at a nearby store using zipcode, city-state, or locationnumber. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :upcId		int	Product ID of the product you would like to return BOPS availability for. Multiple Product ID's can be specified here by comma separating. (Required) Ex. 50946872827,96018254016 . You can also specify what objects are returned here. Please visit the static documentation to view details
    locationNumber		int	Location number of the area you are trying to locate a BOPS product. Required if you do not specify latitude/longitude, zipcode or city/state. (Optional) Ex.5459
    latitude		int	BOPS look up by global coordinates. You must specify longitude parameter if you specify the latitude parameter. Required if you do not specify locationNumber, zipcode or city/state. (Required if also using longitude parameter) Ex. 37.355965
    longitude		int	BOPS look up by global coordinates. You must specify latitude parameter if you specify the longitude parameter. First in priority if city and state and/or zipcode also supplied.(Required if also using latitude parameter) Ex. -122.01318
    zipCode		int	Zip code of area you are trying to locate a BOPS product. Required if you do not specify latitude/longitude, locationNumber or city/state. (Optional) Ex.94105
    city		string	Zip code of area you are trying to locate a BOPS product. You must specify state parameter if you specify the city parameter. Required if you do not specify latitude/longitude, locationNumber or zipcode. (Optional) Ex.San Francisco
    state		string	Zip code of area you are trying to locate a BOPS product. You must specify city parameter if you specify the state parameter. Required if you do not specify latitude/longitude, locationNumber or zipcode. (Optional) Ex.CA
    distance		string	Distance from location specified above using the locationNumber, zipcode, or city/state parameter. Default is 200 (miles). Can be a number between 1-200. (Optional) Ex.50
    numberOfStores		string	Distance from location specified above using the locationNumber, zipcode, or city/state parameter. Default is 15. Can be a number between 1-15. (Optional) Ex.5
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Search Phrase v4/catalog/search

    Search for a product using string. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    searchphrase		int	Search for a product using string (Required) Ex. red dress
    show	product facet	string	Shows products or facets only. If neither product or facet requested, shows BOTH products AND facets (Optional) Ex. product
    sortorderby	PRICE_ASCENDING PRICE_DESCENDING CUSTOMER_RATING NEWNESS BEST_SELLERS	string	Sorts order of response by PRICE_ASCENDING, PRICE_DESCENDING, CUSTOMER_RATING, NEWNESS, BEST_SELLERS (Optional)Ex. BEST_SELLERS
    perpage		string	Default 12. not more than 24 per page (Optional) Ex. 4
    page		string	What is current page number requested. Default 1 (Optional) Ex. 2
    imagewidth		string	Image Width (Optional) Ex.100 (Pixels)
    imagequality		string	Imager Quality (Optional) Ex.90
    upcimagewidth		string	UPC Image Width (Optional) Ex.100 (Pixels)
    swatchimagewidth		string	Swatch Image Width (Optional) Ex.100 (Pixels)
    include		string	This parameter allows you to return additional information about products such as promotions and product description. NOTE: Can only be used if the show=product also. Multiple values can be sent by separating them by Comma's. Currently promo and proddesc are the only two available. (Optional) Ex. promo,proddesc
    avoidredirects	true false	string	When a search input includes the name of a Macy's category we return the category ID in the response as a redirect instead of the products and facets that would normally be delivered. (Ex. Search phrase: chanel) You can avoid this by seeing this parameter to true. Default is false. (Optional) Ex.true
    facetexpandall	true false	string	When a user wants to see ALL facet values listed for the search. Default will show only first 10 values for each facet. Default is false. (Optional) Ex.true
    invassort	SITE STORE JEWELRY WEDDING_REGISTRY SEARCH_AND_SEND SHOES	string	Pass Inventory Assortment value to retreive Context specifc to return customized search results. Default is SITE (Optional)Ex. STORE
    appl	ASSOCIATE SITE MOBILE SEO_LINK_MODULE SEARCH_AND_SEND MEW	string	Pass Application value to retreive Context specifc to return customized search results. Default is ASSOCIATE (Optional)Ex. SITE
    device	TABLET PHONE PC POS	string	Pass Device value to retreive Context specifc to return customized search results. Default is TABLET (Optional)Ex. PHONE
    country	US	string	Pass Country value to retreive Context specifc to return customized search results. Default is US (Optional)Ex. US
    callback		string	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. (Optional) Ex. magicofmacysapi
    zip		string	Zip code of area you are trying to search for a product. Required if you do not specify locationNumber or city/state. (Optional) Ex.94105
    city		string	You must specify state parameter if you specify the city parameter. (Optional) Ex.San Francisco
    state		string	You must specify city parameter if you specify the state parameter. (Optional) Ex.CA
    latitude		string	Search by global coordinates. You must specify longitude parameter if you specify the latitude parameter. (Required if also using longitude parameter) Ex. 37.355965
    longitude		string	Search by global coordinates. You must specify latitude parameter if you specify the longitude parameter.(Required if also using latitude parameter) Ex. -122.01318

  • GET Reviews v3/catalog/reviews

    GetCatalogReviews retrieves information about macys.com customer reviews. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    productId		string	Product id from the website - Web Id. (Required) Ex. 199462
    numOfReviews		string	Must be number. Defaults to 10 if not sent in this parameter. (Optional) Ex. 3
    pageNumber		string	You can specify which page you return. For instance if there are 20 reviews and you are returning 10 reviews per page then you could specify page 2 to get the second page of reviews. Default is 1 (Optional) Ex. 2
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Refresh Status v3/job/refreshjobstatus

    The refreshstatus Service is a read only resource that returns the status and time of last data refresh. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    callback		string	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. (Optional) Ex. magicofmacysapi

• Store Services

  • List Methods
  • Expand Methods

  • GET Events v2/store/event

    GetStoreEvents 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. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    storeId		string	Store ID. You can return events for multiple stores by separating them by a comma. (Required if NOT searching by storeNumber) Ex. 212, 70
    storeNumber		string	MST Store Number. You can return events for multiple stores by separating them by a comma. (Required if NOT searching by storeId) Ex. 428,49
    eventFrom		string	Start Search Date (Optional) Ex. Jan 1, 2014
    eventTo		string	End Search Date (Optional) Ex. Dec 31, 2014
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Detail v2/store/detail?

    This service allows users to find the closest Macy's stores. It supports look up by zip code, by city and state, or by latitude and longitude. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    latitude		int	Stores look up by global coordinates. First in priority if city and state and/or zipcode also supplied. (Required if also using longitude parameter) Ex. 37.355965
    longitude		int	Stores look up by global coordinates. First in priority if city and state and/or zipcode also supplied.(Required if also using latitude parameter) Ex. -122.01318
    zipcode		string	Stores look up by zip code. Second in priority if latitude and longitude and/or city and state also supplied. (Required if no other parameter's are specified) Ex. 94086
    city		string	Stores look up by combination of state and city. Third in priority if latitude and longitude and/or zipcode also supplied. (Required if no other parameter's are specified. City and State parameters must be used together) Ex. Sunnyvale
    state		string	Stores look up by combination of state and city. Third in priority if latitude and longitude and/or zipcode also supplied. (Required if no other parameter's are specified. City and State parameters must be used together) Ex. CA
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Focus Detail (Using Store Number) v2/store/focusdetail/:storeNumber

    This service allows users to look up Macy's stores . It supports look up by storeNumber or state code or gives details for all stores. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :storeNumber		int	Required only if statecode is not provided or not specifying to include=all. (MST Store Number) Ex. 428
    statecode		string	Stores look up by state.(Optional) Ex. CA. Required if storeNumber param not requested
    include		string	All stores returned. (Optional) Ex. all. Required if statecode or specific store number not requested
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Focus Detail (Using Location Number) v2/store/focusdetail

    This service allows users to look up Macy's stores . It supports look up by storeNumber or state code or gives details for all stores. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    locnbr		int	Required only if statecode is not provided or not specifying to include=all. Ex. 5045
    statecode		string	Stores look up by state.(Optional) Ex. CA. Required if storeNumber param not requested
    include		string	All stores returned. (Optional) Ex. all. Required if statecode or specific store number not requested
    show	map events map,events	string	You can send one or both of the values. If you send both, separate with a comma. (Optional) Ex. map,events.
    callback		string	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. (Optional) Ex. magicofmacysapi

• Promotions and Coupon Services

  • List Methods
  • Expand Methods

  • GET Promotions v2/promotions

    This service allows to retrieve promotions. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    promoid		string	Promotional ID (Optional) Ex. 402902
    global	N Y	string	Specifies if the promotion global or not (Optional) Ex. Y
    sourcecode		string	sourcecode (Optional) Ex. D
    type		string	Promotion Type (Optional) Ex. Bundled GWP
    promo_code		string	Promotion Code (Optional) Ex. VETDAY
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Promotions and Coupons v3/promotions

    This service allows to retrieve promotions, coupons, or both using one call. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    show	promotions coupons promotions,coupons	string	Specifies if you would like to return promotions, coupons, or promotions AND coupons (Required) Ex. promotions,coupons
    promoid		string	Promotional ID (Optional) Ex. 402902
    global	N Y	string	Specifies if the promotion global or not (Optional) Ex. Y
    promotionsourcecode		string	Promotion Sourcecode (Optional) Ex. D
    promotype		string	Promotion Type (Optional) Ex. Bundled GWP
    promocode		string	Promotion Code (Optional) Ex. VETDAY
    channel		string	Channel for Promotion or Coupon (Optional) Ex. MOBILE
    coupontype		string	Coupon Type (Optional) Ex. Other
    couponnumber		string	Coupon filter Number(Optional) Ex. 00030492100318133415
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Promotions Sorted v3/promotions/sorted

    The Promotions Sorted API call allows the users to get Deals and Promotion data set grouped and sorted by FOB to match data rendered on website. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    channel	SITE MOBILE	string	Channel for the Promotion (Optional) Ex. SITE

  • POST Promotions Share v3/promotions/share

    The Promotions Share API allows users to use a POST call to send automated emails to recipient(s) about MACY's Promotions or Coupons. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    Content-Type	application/json application/xml	string	Content type of the payload body as JSON or XML

    Request Body

    { "channel": "SITE", "promoCode": "VETDAY", "promoId": "431690", "recipientEmailAddress": "linda.macysapi@macys.com", "senderEmailAddress": "daniel.macysapi@macys.com", "senderName": "Daniel", "message": "Hey honey check out this promotion at Macy.com - Love Dad" }

    { "channel": "SITE", "promoCode": "VETDAY", "promoId": "431690", "recipientEmailAddress": "linda.macysapi@macys.com", "senderEmailAddress": "daniel.macysapi@macys.com", "senderName": "Daniel", "message": "Hey honey check out this promotion at Macy.com - Love Dad" }
  • GET Coupons v2/promotions/coupons

    This service allows to retrieve coupons. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    callback		string	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. (Optional) Ex. magicofmacysapi

• Registry Services

  • List Methods
  • Expand Methods

  • GET Registry by Name (GVR) v2/registry/by-name

    This service returns the Guest View Registry (GVR) Registry ID based on Name. You can narrow your results by specifying month and year of event. Once you have the correct Registry ID you can use the Get Registry by Registry ID (GVR) (below) to return the products of that specific registry. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    firstName		string	Enter First name of Bride, Groom, or Guest of Honor (Required) Ex. David
    lastName		string	Enter Last name of Bride, Groom, or Guest of Honor (Required) Ex. Smith
    eventYear		string	Year of Registry Event. (Required only if you choose to also query by eventMonth parameter.) Ex. 2013
    eventMonth	1 2 3 4 5 6 7 8 9 10 11 12	string	Month of event: 1-12. (Optional: However, you must use the eventYear parameter to specify this parameter of registry specified.) Ex. For May use 5
    registryType		string	Default to WEDDING. Currently WEDDING is the only registry supported through this service (Optional) Ex. WEDDING
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Registry by Registry ID (GVR) v2/registry/by-id/:registryID

    This service returns products shown in the Guest View Registry (GVR) when a request is made by Registry ID. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :registryID		string	The unique identifier of this registry assigned when the registry was created. (Required) Ex. 2055190
    type	GVR	string	This specifies this is a Guest View Registry (GVR) request (Required) Ex. GVR Note: a BVR (Bridal View Registry) is also available. This is a protected Services call
    callback		string	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. (Optional) Ex. magicofmacysapi

• Shopping Bag Services

  • List Methods
  • Expand Methods

  • GET Retrieve Bag :version/shoppingbag

    This service allows to retrieve bag. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :version	v2	string	API Version
    bagid		string	Bag ID is displayed on the website Shopping Bag page. If userid is not provided bagid must be provided
    userid		string	This will be returned once you retrieve bag using the bagid. If bagid is not provided userid must be provided.
    promocode		string	A list of promocodes to be added. Multiple codes can passed by separating them by commas. Ex. MEMMOB or MEMMOB, SAVE
    show		string	A list of promocodes to be added. Multiple attributes can passed by separating them by commas. Ex. product or product,promotion
    include	storedetails	string	If items in the shopping bag are going to be pick up at a local store and this parameter is set then the store information will be returned. (BOPS: Buy online and pick up in store) Ex. storedetails
    callback		string	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. (Optional) Ex. magicofmacysapi

  • GET Retrieve Bag Item Count :version/shoppingbag/bagItemCount

    This service retrieves the shopping bag item count using a userid of a bagid Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :version	v2	string	API Version
    bagid		string	Bag ID is displayed on the website Shopping Bag page. If userid is not provided bagid must be provided
    userid		string	This will be returned once you retrieve bag using the bagid.
    callback		string	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. (Optional) Ex. magicofmacysapi

  • POST Add to Bag :version/shoppingbag/item

    This service allows to add items to shopping bag. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :version	v2	string	API Version
    Content-Type	application/json application/xml	string	Content type of the payload body as JSON or XML

    Request Body

    { "additemsrequest": { "quantity": 1, "upcid": 185213, "userid": 2150911673 } }

    { "additemsrequest": { "quantity": 1, "upcid": 185213, "userid": 2150911673 } }
  • PUT Update Bag :version/shoppingbag/item

    This service enables users update quantity of items that is already added to a shopping bag. It enables users edit multiple items with each request. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :version	v2	string	API Version
    Content-Type	application/json application/xml	string	Content type of the payload body as JSON or XML

    Request Body

    { "userid" : 2150911673, "updateitemsrequest": { "itemseq":12, "upcid": 185213, "quantity": 1 } }

    { "userid" : 2150911673, "updateitemsrequest": { "itemseq":12, "upcid": 185213, "quantity": 1 } }
  • POST Delete Item from Bag :version/shoppingbag/item/delete

    This service allows you to delete an item from the shopping bag. Please click here for the additional documentation.

    Parameter	Value	Type	Description
    accept	application/json application/xml	string	Output format as JSON or XML (Required) Ex. JSON
    :version	v2	string	API Version
    Content-Type	application/json application/xml	string	Content type of the payload body as JSON or XML

    Request Body

    { "userid" : 2150911673, "deleteitemsrequest" : { "itemseq":24, "upcid":185213 } }

    { "userid" : 2150911673, "deleteitemsrequest" : { "itemseq":24, "upcid":185213 } }