Merran documentation API & integrations
The household's theme nights
GET
/api/households/current/themes
const url = 'http://localhost:3000/api/households/current/themes';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/themes \ --cookie merran.session_token=<merran.session_token>Dinner’s theme each weekday, Sunday first: taco night, fish on Friday, eat out on Saturday. 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 theme nights.
Media typeapplication/json
object
themes
required
Dinner’s theme each weekday, Sunday first; null for none.
Array<object | null>
object
kind
required
string
name
required
string
tag
string
Example
{ "themes": [ null, null, { "kind": "tag", "name": "Tacos", "tag": "taco" }, null, null, { "kind": "fish", "name": "Fish" }, { "kind": "skip", "name": "Eat out" } ]}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.