Merran documentation API & integrations
What the household eats
GET
/api/households/current/tastes
const url = 'http://localhost:3000/api/households/current/tastes';const options = { method: 'GET', headers: {cookie: 'merran.session_token=<merran.session_token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url http://localhost:3000/api/households/current/tastes \ --cookie merran.session_token=<merran.session_token>Foods it avoids (an allergy is never suggested), diets every meal must fit, and how long a weeknight dinner can take. Fill the week keeps to them. With an API key, it needs the plan: read permission.
Authorizations
Section titled “Authorizations”Responses
Section titled “Responses”Its tastes.
Media typeapplication/json
object
avoid
required
Foods the household doesn’t eat.
Array<object>
object
food
required
string
level
required
How firmly: an allergy or never, and recipes with it aren’t suggested; leave-out, and they are, with it crossed off, unless it’s what the dish is or the recipe needs it. Nuts, dairy, gluten, eggs and meat can’t be left out, so they’re saved as never.
string
who
Who doesn’t eat it, when it isn’t everyone.
string | null
diets
required
Diets every meal must fit.
Array<string>
weeknightMinutes
required
The longest a dinner Monday to Thursday can take.
integer | null
Example
{ "avoid": [ { "food": "peanuts", "level": "allergy", "who": "Sam" }, { "food": "mushrooms", "level": "leave-out", "who": "Emma" } ], "diets": [], "weeknightMinutes": 45}Not signed in.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}Not allowed.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
fields
object
key
additional properties
string
Example
{ "error": { "code": "not_found", "message": "There's nothing here.", "fields": { "name": "Give it a name." } }}© 2026 Kyle Johnson. Documentation: CC BY 4.0. Merran: AGPL-3.0-or-later.