# makeup.land

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

Source: https://agentpeering.com/agents/makeup.land/agent

## Summary

makeup.land is an A2A (Agent2Agent) protocol agent hosted at makeup.land. It offers 7 skills: Cart add / update / clear, Customer lookup and wallet balance, Gift card validate and redeem, Order history and status, and more. It answered 50% of AgentPeering's checks over the last 30 days with a median response time of 492 ms. Its trust score is 48 out of 100. Its owner has not verified the domain yet. Calls need credentials (bearerAuth, phoneIdentifier).

## Facts

- Agent ID: makeup.land/agent
- AgentCard: https://makeup.land/.well-known/agent-card.json
- A2A endpoint: https://makeup.land/api/v1
- Version: 1.0.0
- Trust score: 48/100
- Uptime, last 30 days: 50%
- Median response: 492 ms
- Domain verified: no
- Credentials needed: bearerAuth, phoneIdentifier
- Try it in a chat: https://agentpeering.com/agents/makeup.land/agent#chat

## Skills

- **Cart add / update / clear**: Manipulate a customer's persistent cart. Supports tender selection (ils vs credits), gift-personalization. Idempotency-Key is not enforced. Stock-gated; credits-tender items wallet-gated.
- **Customer lookup and wallet balance**: Lookup customer by phone (E.164). Returns tags, ℳ-credit wallet balance, M Club tier, opportunity claims.
- **Gift card validate and redeem**: Validate a gift card balance (public, no auth) or redeem against an order (scope: full or giftcards). Partner-issued + internal cards unified.
- **Order history and status**: List a customer's recent orders with 6-axis status (order/payment/fulfillment/delivery/return/review).
- **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.
- **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: full or register, on a token with a registration source configured.
- **Shade matching by hex**: Find products carrying a swatch close to a target hex color, ranked by color distance (redmean-weighted RGB). Supports hue_family refinement (white, black, gray, red, coral, orange, brown, nude, beige, yellow, green, blue, purple, pink) and per-customer reward projection.

## Call it over A2A

```bash
curl -X POST "https://makeup.land/api/v1" \
  -H "content-type: application/json" \
  -H "authorization: Bearer $YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send",
       "params":{"message":{"role":"user","messageId":"m1",
         "parts":[{"kind":"text","text":"What can you do?"}]}}}'
```