Welcome to the Macy's API Documentation Portal

This is the place to find the technical documentation you need to build powerful applications against our robust APIs! Using our APIs, you can query store directions, events, and details; perform catalog category, product, and keyword searches; create and find registered users.

Available API's



Address Services Performs Address validation
Ad Media Services Includes information about Category and Global Ad Media calls.
Catalog Services

Catalog: Includes information about various versions of the category, product, search, reviews, and refreshstatus calls.

Customer Services Customer: Includes information about various customer lists, user profile services, loyalty services, etc.
Mobile Utility Services Includes opt in/out, logging and app config services for mobile applications.
Order Services

Includes information about Bag, Checkout, and VGC services.

Promotion and Coupon Services Includes services for promotions and for store coupons.
Protected Services

OAuth Protected Services require OAuth2.0 authorization and a token to be accessed. Services provide access to macys.com user and registry details as well as merging a shopping bag.

Registry Services
Includes information about how to view a registry as a guest by name or by registry id
Review Services Includes information about the reviews and questions asked on a specified product.
Store Services Store: Includes information about various versions of the events  and store detail information.
User Services Includes services to reset a password


Useful info about Macy's API



Common API Characteristics Describes characteristics that are common across all Macy's APIs, such as the need for an API key, HTTP headers, implementing OAuth, and the available output formats.
Error Handling Lists the common errors encountered when using Macy's API
Deprecated Services            Lists the no longer supported Macy's API services.
Macy's API FAQ

Frequently asked questions about Macy's API and their respective answers.

BOPS Stores

A full this of participating BOPS stores

What's New New API being developed

Docs Navigation