makeup.land

Israeli professional cosmetics retailer. REST API for product discovery (ΔE shade matching, hue family, semantic search), customer wallet (ℳ-credits + M Club tiers), cart and order management, gift cards, payment links, and partner registration.

Skills

• Shade matching by hex
  Find products carrying a swatch close to a target hex color, ranked by perceptual distance (ΔE 2000). Supports hue_family refinement (warm/cool/neutral) and per-customer reward projection.
  searchcolorproductscosmetics
• Product search and filtering
  Search via `q` (cross-lingual natural-language query — Hebrew, English, transliteration all return semantically-equivalent results), or filter via `tag` (EXACT-string match against Hebrew-stored tags), `brand`, or `sort` (price / popularity / Bayesian-shrunk rating). Returns ILS and ℳ-credit prices side-by-side for tender-aware checkout.
  searchcatalogproducts
• Customer lookup and wallet balance
  Lookup customer by phone (E.164). Returns tags, ℳ-credit wallet balance, M Club tier, opportunity claims.
  customersloyaltywallet
• Cart add / update / clear
  Manipulate a customer's persistent cart. Supports tender selection (ils vs credits), gift-personalization, idempotent POST/PATCH via Idempotency-Key. Stock-gated; credits-tender items wallet-gated.
  cartcheckout
• Order history and status
  List a customer's recent orders with 6-axis status (order/payment/fulfillment/delivery/return/review).
  ordershistory
• Gift card validate and redeem
  Validate a gift card balance (public, no auth) or redeem against an order (scope: giftcards). Partner-issued + internal cards unified.
  gift-cardspayments
• Customer registration
  Generic registration orchestrator — create or look up a customer, compute partner-config-driven tags, fire WhatsApp template and partner webhooks. Designed for inbound WA proof of phone ownership. Scope: register.
  customersonboardingwhatsapp

How to call

https://makeup.land/api/v1