BrewForge API
Public API documentation for BrewForge brewing software
The BrewForge API lets you programmatically access your brewing data - brews, inventory, equipment profiles, and more.
- Get an API token - Go to Settings → API in BrewForge
- Make your first request:
curl https://brewforge.sh/api/v1/brews \
-H "Authorization: Bearer bfk_your_token_here"
- Pro subscription or higher - API access is not available on Free/Basic plans
- API token with appropriate scopes
| Method | Endpoint | Description |
|---|
GET | /api/v1/brews | List brews (paginated) |
POST | /api/v1/brews | Create a brew |
GET | /api/v1/brews/:id | Get a specific brew |
PATCH | /api/v1/brews/:id | Update a brew |
DELETE | /api/v1/brews/:id | Delete a brew |
GET | /api/v1/brews/:id/notes | List brew notes |
POST | /api/v1/brews/:id/notes | Add a note |
GET | /api/v1/brews/:id/notes/:noteId | Get a note |
PATCH | /api/v1/brews/:id/notes/:noteId | Update a note |
DELETE | /api/v1/brews/:id/notes/:noteId | Delete a note |
GET | /api/v1/brews/:id/readings | List fermentation readings |
POST | /api/v1/brews/:id/readings | Add a fermentation reading |
| Method | Endpoint | Description |
|---|
GET | /api/v1/inventory | List all inventory (grouped) |
GET | /api/v1/inventory/fermentables | List fermentables (paginated) |
POST | /api/v1/inventory/fermentables | Create fermentable item |
GET | /api/v1/inventory/fermentables/:id | Get fermentable item |
PATCH | /api/v1/inventory/fermentables/:id | Update fermentable item |
DELETE | /api/v1/inventory/fermentables/:id | Delete fermentable item |
GET | /api/v1/inventory/hops | List hops (paginated) |
POST | /api/v1/inventory/hops | Create hop item |
GET | /api/v1/inventory/hops/:id | Get hop item |
PATCH | /api/v1/inventory/hops/:id | Update hop item |
DELETE | /api/v1/inventory/hops/:id | Delete hop item |
GET | /api/v1/inventory/yeasts | List yeasts (paginated) |
POST | /api/v1/inventory/yeasts | Create yeast item |
GET | /api/v1/inventory/yeasts/:id | Get yeast item |
PATCH | /api/v1/inventory/yeasts/:id | Update yeast item |
DELETE | /api/v1/inventory/yeasts/:id | Delete yeast item |
GET | /api/v1/inventory/miscs | List misc items (paginated) |
POST | /api/v1/inventory/miscs | Create misc item |
GET | /api/v1/inventory/miscs/:id | Get misc item |
PATCH | /api/v1/inventory/miscs/:id | Update misc item |
DELETE | /api/v1/inventory/miscs/:id | Delete misc item |
| Method | Endpoint | Description |
|---|
GET | /api/v1/equipment | List equipment profiles |
GET | /api/v1/styles | List style profiles |