# makeup.land V1 API

**Canonical:** https://apis.io/apis/makeup-land/makeup-land-v1-api/  
**Provider:** makeup.land — https://apis.io/providers/makeup-land/  
**Base URL:** https://makeup.land/api/v1  
**Documentation:** https://makeup.land/llms-full.txt

makeup.land V1 API is one of 3 APIs that [makeup.land](https://apis.io/providers/makeup-land/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Cosmetics, Product Search, Shopping Cart, Gift Cards, and Loyalty. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

REST API for the makeup.land storefront under https://makeup.land/api/v1 — 21 operations across Products (cross-lingual q, exact Hebrew tag, brand, ΔE 2000 near_hex shade matching, hue_family, sort), Brands, Customers (lookup, upsert, tags, M Club opportunities, best deals), Cart (get, add, patch, delete, clear — all idempotent), Orders (read-only, six status axes), Gift Cards (public validate, scoped redeem), Payment Links, Register (partner onboarding with webhook + WhatsApp dispatch) and Proposals (catalog enrichment). Bearer ml_ tokens with scopes full / register / giftcards / proposals and a read_only flag; phone (E.164) selects the customer on phone-keyed endpoints.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/brands` | List all brands with product counts |
| GET | `/api/v1/products` | Browse / search the catalog |
| GET | `/api/v1/customers` | Look up a customer by phone or email |
| POST | `/api/v1/customers` | Create or update a customer (bulk-import friendly) |
| PATCH | `/api/v1/customers/{id}/tags` | Add / remove / replace tags on a customer |
| GET | `/api/v1/customers/{id}/opportunities` | Open M-Club opportunities + referral metadata for a customer |
| GET | `/api/v1/customers/best-deals` | Personalised best-deal candidates for a customer |
| GET | `/api/v1/cart` | Read the current cart for a phone-keyed customer |
| DELETE | `/api/v1/cart` | Clear all carts for a customer |
| POST | `/api/v1/cart/items` | Add or increment a cart line item |
| PATCH | `/api/v1/cart/items/{lineItemId}` | Update an existing cart line item |
| DELETE | `/api/v1/cart/items/{lineItemId}` | Remove a cart line item |
| GET | `/api/v1/orders` | List a customer's orders |
| GET | `/api/v1/gift-cards` | List gift cards owned by a customer (as recipient) |
| GET | `/api/v1/gift-cards/validate` | Public gift-card balance / validity check |
| POST | `/api/v1/gift-cards/redeem` | Apply a gift card to an order |
| GET | `/api/v1/payment-links` | Outstanding payment links for a customer |
| POST | `/api/v1/register` | Trusted customer registration intake (WA-inbound + partner) |
| GET | `/api/v1/registrations` | Paginated registration audit log |
| GET | `/api/v1/registrations/{id}` | Single registration with full webhook + WhatsApp audit |
| POST | `/api/v1/proposals` | Batch-submit catalog enrichment proposals |

## Machine-readable artifacts (19)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/openapi/makeup-land-openapi.yml
- **OpenAPI** — https://makeup.land/openapi.json
- **OpenAPI** — https://makeup.land/openapi.yaml
- **Documentation** — https://makeup.land/llms-full.txt
- **APIReference** — https://makeup.land/openapi.json
- **GettingStarted** — https://makeup.land/llms-api.txt
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/authentication/makeup-land-authentication.yml
- **Authentication** — https://makeup.land/auth.md
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/scopes/makeup-land-scopes.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/conventions/makeup-land-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/conventions/makeup-land-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/errors/makeup-land-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/rate-limits/makeup-land-rate-limits.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/lifecycle/makeup-land-lifecycle.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/data-model/makeup-land-data-model.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/overlays/makeup-land-openapi-overlay.yaml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/conformance/makeup-land-conformance.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/asyncapi/makeup-land-webhooks.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/makeup-land/refs/heads/main/apis.yml

## Other makeup.land APIs (2)

- [makeup.land MCP Server](https://apis.io/apis/makeup-land/makeup-land-mcp-server/)
- [makeup.land Merchant & Agentic Commerce Feeds](https://apis.io/apis/makeup-land/makeup-land-merchant-feeds/)

## Tags

Cosmetics, Product Search, Shopping Cart, Gift Cards, Loyalty, Order

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/makeup-land/makeup-land-v1-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/makeup-land/.