The InVintory Partner API
Integrate the world's most comprehensive wine platform into your product. Power inventory, label recognition, search, and POS connections with a single, elegant Partner API.
curl -X POST https://api.invintorywines.com/partners/v1/wines/actions/scan-image \ -H "Content-Type: multipart/form-data" \ -H "x-api-key: YOUR_SECRET_TOKEN" \ -F "image=@label.jpg" \ -F "scan_id=abc123" // 200 OK — response { "resolution": "matched", "scan_id": "abc123", "year": 2015, "results": [ { "wine": { "id": 123, "producer_name": "Château Mouton Rothschild", "name": "Château Mouton Rothschild Pauillac Premier Grand Cru Classé", "type": "Red", "region_name": "Bordeaux, Pauillac", "country_name": "France" }, "score": 97 } ] }
What you can build
Everything you need to integrate wine into your operations
A single, documented Partner API for inventory, identification, search, and connectivity — ready for production from day one.
Collection management
Programmatic access to cellars, bottles, locations, and movements. Add, remove, and reconcile inventory across any system you already run.
Scan wines by image
Identify bottles directly from a photo of the label. Our computer-vision endpoint returns producer, vintage, region, and matched catalogue records.
Wine database & search
Query our catalogue of 1.5M+ wine labels with rich metadata — producers, appellations, vintages, tasting notes, and provenance.
POS & system integrations
Connect inventory to your point-of-sale, ERP, or reservation system. Sync depletions, surface stock at the table, and close the loop on every pour.
Operational workflows
Build custom flows for receiving, transfers, audits, and reporting. Webhooks keep your stack in sync as bottles move through the cellar.
Enterprise-grade access
Scoped API keys, role-based permissions, and a dedicated partner success contact. Built for hospitality groups, retailers, and software platforms.
Who it's for
Built for the teams that move wine
Hospitality groups
Embed live inventory into your POS, table-side service apps, and back-of-house tools.
Retailers & marketplaces
Enrich product listings with our catalogue and let customers scan bottles to add to their lists.
Software platforms
Add wine identification, search, and collection features to your app without building from scratch.
Frequently asked questions
What can I build with the InVintory Partner API?
The API gives you programmatic access to cellars, bottles, locations, and movements, so you can add, remove, and reconcile inventory across any system you already run, and build custom flows for receiving, transfers, audits, and reporting.
Does the API include wine label recognition?
Yes. Our computer vision endpoint identifies bottles directly from a photo of the label and returns producer, vintage, region, and matched catalogue records.
How large is the wine catalogue?
You can query our catalogue of more than 1.5 million wine labels, with metadata including producers, appellations, vintages, tasting notes, and provenance.
Can it connect to our point of sale system?
Yes. You can connect inventory to your point of sale, ERP, or reservation system to sync depletions and surface stock at the table, and webhooks keep your stack in sync as bottles move through the cellar.
How is access secured?
Access uses scoped API keys with role based permissions, and every partner gets a dedicated partner success contact.
How much does the Partner API cost?
Partner pricing is tailored to your volume and use case. Email support@invintory.com and our team will get back to you within one business day.