Cellarion API
API by Cellarion · rest
The stable REST API for your own Cellarion data: your cellars and the ones shared with you, bottles, racks, personal fields, statistics and notifications. You reach it with a personal API token. This page describes the version of the server it is served from; the raw OpenAPI 3.1 document is at [/api/openapi.json](/api/openapi.json). Which interface should I use? | You are building | Use | |---|---| | A dashboard, a home-automation integration, a script | This REST API, starting with GET /api/inventory. It reads the cellar, takes bottles out and moves them | | Something that should react when the cellar changes | The event stream, GET /api/events/stream, then refetch | | An AI assistant (Claude, ChatGPT and others) | MCP: see [Connect an AI assistant](/connect-ai) | | A temperature or humidity sensor | Climate ingest, POST /api/climate/ingest | The API gives you your own data. It does not expose Cellarion's AI features (label scanning, enrichment, the…
Endpoint: https://cellarion.app/
Verification: observed. Source: crawl.
Capabilities (19)
- Which account this token belongs to
- Bottles in the cellars you own filtered and paged
- One bottle
- Take a bottle out of the cellar
- Move a bottle to another cellar
- Your cellars and the ones shared with you
- Post sensor readings
- Server-sent events when your data changes
- Is the server up and which version is it
- The whole inventory in one read
- Your 30 newest notifications
- The unread count cheaply
- This document
- The racks in one cellar
- Put a bottle in a rack slot
- Take a bottle out of a rack slot
- Statistics over the cellars you own
- Revoke the token making this request
- A bottle or wine thumbnail