Cookest
Backend APIEndpoints

Endpoints Overview

Complete Cookest API endpoint reference

Endpoints Overview

The Cookest API is a REST API running on Actix-Web 4. All endpoints return JSON.

Base URL

http://localhost:8080   (development)

Authentication

Protected endpoints require:

Authorization: Bearer <access_token>

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

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

Endpoint groups

GroupPath prefixAuth required
Auth & Account/api/authVaries
Profile & Preferences/api/meJWT
Recipes/api/recipesVaries
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
Ingredients/api/ingredientsNo

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