makeup.land

• Shade matching by hex shade_match

  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.

  search color products cosmetics
  2 examples

  • Find lipsticks close to #C2185B
  • Match a foundation to my skin tone #E8D4B8 with warm undertone

  In: application/json, text/plain · Out: application/json

• Product search and filtering product_search

  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.

  search catalog products
  2 examples

  • List the top 10 most-popular lipsticks under ₪150
  • Show all NYX products with rating above 4.5

  In: application/json · Out: application/json

• Customer lookup and wallet balance customer_lookup

  Lookup customer by phone (E.164). Returns tags, ℳ-credit wallet balance, M Club tier, opportunity claims.

  customers loyalty wallet
  1 example

  • Get balance for +972501234567

  In: application/json · Out: application/json

• Cart add / update / clear cart_management

  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.

  cart checkout
  2 examples

  • Add product prod_x variant var_y quantity 2 for +972501234567
  • Switch line li_abc from ils to credits tender

  In: application/json · Out: application/json

• Order history and status order_history

  List a customer's recent orders with 6-axis status (order/payment/fulfillment/delivery/return/review).

  orders history
  1 example

  • List the 5 most recent orders for +972501234567

  In: application/json · Out: application/json

• Gift card validate and redeem gift_card_redeem

  Validate a gift card balance (public, no auth) or redeem against an order (scope: giftcards). Partner-issued + internal cards unified.

  gift-cards payments
  2 examples

  • Check balance for code XXXX-XXXX-XXXX
  • Redeem code XXXX against order ord_123

  In: application/json · Out: application/json

• Customer registration register_customer

  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.

  customers onboarding whatsapp
  1 example

  • Register +972501234567 with source=wa-inbound and tags=['first-touch']

  In: application/json · Out: application/json

Interfaces

Capabilities

Streaming

No

Push notifications

No

Extended card for signed-in callers

Not declared

Security and formats

Requires

bearerAuth + phoneIdentifier, or bearerAuth

Schemes

bearerAuth (http), phoneIdentifier (api_key)

Accepts

application/json

Returns

application/json