Bar Companion Docs

API Reference

Endpoints and Parameters

JSON and form endpoints used by the UI. Base URL defaults to http://localhost:5000.

Notes

  • Responses are JSON unless noted
  • Form endpoints use multipart/form-data
  • Review scores accept 0-10

API Reference

Example: Add Bottle

{
  "brand": "Lagavulin",
  "name": "16",
  "abv": "43%",
  "spirit_type": "Whisky",
  "subtype": "Scotch",
  "description": "",
  "photo": "data:image/png;base64,..."
}

Example: Add Review

{
  "name": "Alex",
  "review_text": "Smoky with dried fruit",
  "notes": ["note_Fruity", "subnote_cooked_fruit"],
  "score": 8,
  "bottle_id": 12,
  "event_id": 3
}