# BergdorfBio Storefront API

Machine-readable description: https://bergdorfbio.com/openapi.json
API catalog: https://bergdorfbio.com/.well-known/api-catalog

Public API. Purchases are completed on the website checkout.

## GET /api/search/index

Product search index

Lightweight index of all purchasable products in a channel, including localized names and prices. Product detail pages live at `/{locale}/{channel}/products/{slug}`. Successful responses are fresh at the shared edge for 60 seconds and require browser revalidation (`max-age=0`).

## POST /api/back-in-stock

Request a notification when a product is back in stock

Idempotent per (email, productSlug). Rate limit: 5 per minute per IP.

Search results use channel settlement currency: EUR for eu, USD for us. Prices and availability may change; the checkout remains authoritative.

Stock notifications require the user's consent to receive an email. Sending a notification request is not a purchase. Never submit another person's email without their permission.

Use the OpenAPI description for parameters, response schemas, validation and error handling. Respect Retry-After when present.