API · Public endpoints

Public API Documentation

Last updated: June 8, 2026

Luxe Copilot's decision engine is exposed via public endpoints — anyone can request them directly, no API key required (subject to rate limits). The 9 endpoints below are the ones reviewers, B2B integrators, and third-party researchers reach for first; the full OpenAPI schema lives atthe live OpenAPI UI(Swagger). The service runs on Render's free tier, so the first request may incur a 30–60 s cold start.

Base URL

https://luxe-copilot-api.onrender.com

Rate limit

60 req/min/IP

Auth

none for public endpoints (admin/* excluded)

Endpoints

POST/verdict

Returns deal / fair / overpriced for a listing price (anchored on P10/P50/P90; bags use resale median).

curl -X POST https://luxe-copilot-api.onrender.com/verdict \
  -H "Content-Type: application/json" \
  -d '{"product_id": 1, "asking_price_usd": 9800, "currency": "USD"}'

GET/resale-score/{product_id}

Resale-market profile for a SKU: median, P10/P90, retention, liquidity score (high_confidence requires n ≥ 30).

curl https://luxe-copilot-api.onrender.com/resale-score/1

POST/future-value

Three-year residual value forecast plus retention pct and hold/sell recommendation. Brand × style × liquidity model.

curl -X POST https://luxe-copilot-api.onrender.com/future-value \
  -H "Content-Type: application/json" \
  -d '{"product_id": 1, "purchase_price_usd": 12000, "condition": "excellent"}'

POST/match

SKU-free same-item match v3: char-trigram + Cohere multilingual embedding, cross-language aligned.

curl -X POST https://luxe-copilot-api.onrender.com/match \
  -H "Content-Type: application/json" \
  -d '{"text": "Black Togo Birkin 25"}'

POST/lens

Image → SKU normalisation → verdict + future_value chain. Vision model: gpt-4.1, fallback: Haiku 4.5.

curl -X POST https://luxe-copilot-api.onrender.com/lens \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/bag.jpg", "asking_price_usd": 8500}'

GET/wardrobe/{user_id}

Per-user wardrobe valuation: invested, current value, 3y residual, ROI, hold/sell action (per item + summary).

curl https://luxe-copilot-api.onrender.com/wardrobe/1

GET/products?limit=80

Product catalogue (212 SKUs, 32 brands). Fields: msrp_usd, category, iconic, style_code.

curl "https://luxe-copilot-api.onrender.com/products?limit=10"

GET/export/skus.csv

Full SKU export (CSV; LOI attachment / third-party integration). Columns: brand, name, category, msrp_usd, style_code, iconic.

curl https://luxe-copilot-api.onrender.com/export/skus.csv -o skus.csv

GET/health

Liveness probe. Returns {status: 'ok', db: <bool>}.

curl https://luxe-copilot-api.onrender.com/health

Provenance field

Every numeric field carries a provenance tag indicating its source. The UI renders this as a coloured dot:

manual — human verified (boutique price + affiliate feed double-confirmed).
real — observed sample (resale-platform public listing, dated).
llm_synth — AI-synthesised estimate (training data + comparable-SKU interpolation, dated; not used to anchor verdicts).
null — no data yet (UI shows it explicitly; we never invent a number).

Error bands

Resale median CI: ±10% (n ≥ 30)
3-year residual forecast: ±15% (brand × style × liquidity model)
If n < 30, the response includes "low_confidence": true

Affiliate links (FTC §255)

This API does not handle affiliate redirects directly, but verdict / future-value responses may include aretailer_url field. When a user clicks through and converts on the front-end, we earn a commission via Awin / CJ / Rakuten / Impact. This does not change the price you pay, and our verdict scoring treats every retailer identically. See/en/terms §4.

Contact

API integration / B2B: hello@luxecopilot.com. Bug / schema issues: include the curl reproduction.

This page mirrors the live OpenAPI UI · methodology and data-source bounds: /en/methodology.