API v1.3 to v1.4 Migration Guide

API Versioning Changes

As a reminder, we follow an API Versioning Policy outlining breaking vs. non-breaking changes. Please ensure your clients handle non-breaking changes gracefully (e.g., addition of new keys, modification of display strings).

For full details, refer to the API Versioning Policy.

Item Format Changes

Modified Item Fields

• The properties.material key, previously present on all authentication items, is now optional. It only exists for luxury authentication items and is not present for sneaker or apparel authentications.

New Item Fields

• A new item_type field has been added to the properties dictionary specifically for apparel authentication items. This field identifies the type of apparel (e.g., tops, dresses).
  • Like other property fields, it includes both an id and a display value.
  • The display value is localized based on the Accept-Language header provided in the request.

New Values

• "apparel" has been added as a possible value for the activity.product_category field to support the new apparel authentication category.