Makeup

List / search products

Browse the catalog with tag, brand, near_hex (ΔE shade match), hue_family, and sort filters. Bearer becomes required when passing `phone` (rewards projection).

List all brands

Return every brand with product counts and slugs. Bearer required.

Validate a gift card code

Check a gift card's remaining balance using its code. Public endpoint — no bearer required (gated on knowledge of the code).

Lookup customer by phone

Return tags, ℳ-credit balance, M Club tier for the customer with the given E.164 phone. Bearer required.

Fetch a customer's cart

Return the customer's most-recently-updated cart with per-line and total reward projection. Bearer + phone required.

List a customer's orders

Recent orders with 6-axis status (order / payment / fulfillment / delivery / return / review). Bearer + phone required.

List pending payment links

Pending payment_requests on the customer's unpaid orders. Bearer + phone required.

Personalised best deals for a customer

Top deal projections based on the customer's tags + M Club tier. Bearer + phone required.