Cookest
Backend APIsEndpoints

Endpoints Overview

Complete Cookest API endpoint reference

Endpoints Overview

Cookest now exposes two Rust backend services:

  • the Food API on port 8081 for catalog data
  • the App API on port 8080 for authenticated app workflows

All endpoints return JSON unless noted otherwise.

Base URL

http://localhost:8080   (App API)
http://localhost:8081   (Food API)

Authentication

App API protected endpoints require:

Authorization: Bearer <access_token>

Subscription-gated App API endpoints return 402 when accessed by a Free user:

{ "error": "subscription_required", "feature": "user_recipes" }

Endpoint groups

GroupPath prefixAuth required
Food API/api/v1/ingredients, /api/v1/recipesPublic reads / API key writes
Auth/api/authVaries
Profile & Preferences/api/meJWT
Recipes/api/recipesVaries
Image Generation/api/image-genJWT
Meal Plans/api/meal-plansJWT
Inventory/api/inventoryJWT
Shopping List/api/shopping-listJWT
Subscription/api/subscriptionJWT
Stores & Promotions/api/stores, /api/adminVaries
AI Chat/api/chatJWT

Subscription tiers

FeatureFreePro €9.99/moFamily €14.99/mo
Inventory + basic meal plan
AI-scored meal plan generation
AI Chat10/dayUnlimitedUnlimited
Price comparison
Create recipes
Shopping list optimizer
Multiple household profiles

On this page