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
| Group | Path prefix | Auth required |
|---|---|---|
| Auth & Account | /api/auth | Varies |
| Profile & Preferences | /api/me | JWT |
| Recipes | /api/recipes | Varies |
| Meal Plans | /api/meal-plans | JWT |
| Inventory | /api/inventory | JWT |
| Shopping List | /api/shopping-list | JWT |
| Subscription | /api/subscription | JWT |
| Stores & Promotions | /api/stores, /api/admin | Varies |
| AI Chat | /api/chat | JWT |
| Ingredients | /api/ingredients | No |
Subscription tiers
| Feature | Free | Pro β¬9.99/mo | Family β¬14.99/mo |
|---|---|---|---|
| Inventory + basic meal plan | β | β | β |
| AI-scored meal plan generation | β | β | β |
| AI Chat | 10/day | Unlimited | Unlimited |
| Price comparison | β | β | β |
| Create recipes | β | β | β |
| Shopping list optimizer | β | β | β |
| Multiple household profiles | β | β | β |