mocop
Browse · Docs · Guide · Analyze

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
About · Contact · Privacy