Buy from TheRealReal via API
Access TheRealReal's luxury consignment marketplace programmatically. Automate authenticated luxury goods purchasing via Zinc.
How the TheRealReal integration works
TheRealReal is the world's largest online marketplace for authenticated luxury consignment, offering pre-owned designer fashion, fine jewelry, watches, art, and home décor. Zinc's TheRealReal integration provides programmatic access to their curated inventory of verified luxury goods.
Ideal for luxury fashion platforms, sustainable shopping applications, and tools that help consumers access premium brands at pre-owned prices with authentication guarantees.
What you can build with the TheRealReal API
Build with the TheRealReal integration API for search, ordering, tracking, and returns.
TheRealReal Order Placement API
Place orders with a product URL and shipping address. No checkout flows required — Zinc handles the retailer-side workflow and processes orders asynchronously.
{
"products": [
{
"url": "https://therealreal.com/...",
"quantity": 1
}
],
"shipping_address": {
"first_name": "Jane",
"last_name": "Doe",
"address_line1": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postal_code": "94105",
"country": "US",
"phone_number": "5551234567"
},
"max_price": 39900
}TheRealReal Order Status API
Retrieve order details including item statuses, shipping address, and processing results. Poll to track progress from pending through to delivery.
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "order_placed",
"max_price": 39900,
"items": [
{
"url": "https://therealreal.com/...",
"quantity": 1,
"status": "shipped"
}
],
"tracking_numbers": [
{
"carrier": "ups",
"tracking_number": "1Z999AA10123456784",
"created_at": "2026-01-15T14:30:00Z"
}
],
"created_at": "2026-01-15T10:00:00Z"
}TheRealReal Shipment Tracking
Tracking numbers are automatically extracted from retailer shipping notifications and returned in the order response. Supports UPS, FedEx, USPS, Amazon Logistics, and DHL.
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "order_placed",
"tracking_numbers": [
{
"carrier": "ups",
"tracking_number": "1Z999AA10123456784",
"created_at": "2026-01-15T14:30:00Z"
},
{
"carrier": "amazon",
"tracking_number": "TBA123456789000",
"created_at": "2026-01-16T09:15:00Z"
}
]
}TheRealReal Managed Accounts
Use Zinc-managed checkout accounts or bring your own retailer credentials. Managed accounts handle login, 2FA, and payment automatically — no account setup required.
{
"credentials": [
{
"short_id": "zn_acct_a1b2c3d4",
"email": "orders@example.com",
"retailer": "therealreal",
"has_totp": true,
"has_forwarding": true
}
],
"total": 1
}TheRealReal Integration FAQ
You can search products, place orders, track shipments, and handle returns through a single Zinc API integration for TheRealReal.
No. Zinc handles the retailer-side ordering workflow so your app can place orders directly via API calls.
Yes. You can fetch tracking status through the API and subscribe to webhook events for shipping and delivery updates.
Create an account, get your API key, and follow the Zinc API docs to send your first search or order request.