Buy from Total Wine via API
Programmatically order from Total Wine's catalog. Automate purchasing wine, spirits, and beer through Zinc's API.
How the Total Wine integration works
Total Wine & More is America's largest independent retailer of fine wine, spirits, and beer, offering an enormous selection at competitive prices. Zinc's Total Wine integration provides programmatic access to their extensive beverage catalog.
Perfect for corporate gifting platforms, event planning services, beverage subscription boxes, and any application focused on wine and spirits e-commerce.
What you can build with the Total Wine API
Build with the Total Wine integration API for search, ordering, tracking, and returns.
Total Wine 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://totalwine.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
}Total Wine 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://totalwine.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"
}Total Wine 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"
}
]
}Total Wine 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": "total_wine",
"has_totp": true,
"has_forwarding": true
}
],
"total": 1
}Total Wine Integration FAQ
You can search products, place orders, track shipments, and handle returns through a single Zinc API integration for Total Wine.
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.