Phineus Kitchen Sign in Sign up free

API reference

The REST API lives under /api on the same host as the app. Requests and responses are JSON. The full, machine-readable description is at /openapi.json and an interactive explorer is at /docs.

All endpoints below except sign-up and sign-in need Authorization: Bearer <token>. See Authentication for how to get a token.

Recipes

MethodPathWhat it does
GET/api/recipes?search=lentil&perPage=10Search your recipes. Returns items and total.
GET/api/recipes/{slug}One recipe with ingredients and instructions.
POST/api/recipes/create/urlImport from a web page. Body {"url": "https://..."}. Returns the new slug.
POST/api/recipesCreate an empty recipe. Body {"name": "Soup"}. Returns the slug.
DELETE/api/recipes/{slug}Delete a recipe.

Example, importing a recipe:

curl -X POST https://kitchen.phineus.ai/api/recipes/create/url \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"url": "https://example.org/recipes/lentil-soup"}'

Shopping lists

MethodPathWhat it does
GET/api/households/shopping/listsYour shopping lists.
POST/api/households/shopping/listsCreate a list. Body {"name": "Weekend"}.
POST/api/households/shopping/itemsAdd an item. Body {"shoppingListId": "...", "note": "lemons", "quantity": 2}.
GET/api/households/shopping/items?perPage=50All items across lists.

Meal plans

MethodPathWhat it does
GET/api/households/mealplansPlanned meals.
POST/api/households/mealplansPlan a meal. Body {"date": "2026-12-01", "entryType": "dinner", "recipeId": "..."}.

Errors

Errors are JSON with an HTTP status: 401 for a missing or rejected token, 403 for something you may not do, 404 for something that does not exist and 422 for a request body that failed validation, with the offending fields listed in detail.

Limits

The Free plan has no request quota for individual use; please keep automated traffic polite.

Phineus Kitchen is a demo product run for testing. Nothing here is real or paid.