Merran documentation API & integrations
Connect to a Mealie
POST
/api/households/current/import/mealie/check
const url = 'http://localhost:3000/api/households/current/import/mealie/check';const options = { method: 'POST', headers: { cookie: 'merran.session_token=<merran.session_token>', 'Content-Type': 'application/json' }, body: '{"url":"http://192.168.1.20:9000","token":"sample-mealie-api-token"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url http://localhost:3000/api/households/current/import/mealie/check \ --header 'Content-Type: application/json' \ --cookie merran.session_token=<merran.session_token> \ --data '{ "url": "http://192.168.1.20:9000", "token": "sample-mealie-api-token" }'The server admin only, since Mealie is usually on the home network and this reaches the address given. Says which Mealie it is and how many recipes it has. The token isn’t kept.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
url
required
string format: uri
token
required
string
Example
{ "url": "http://192.168.1.20:9000", "token": "sample-mealie-api-token"}Responses
Section titled “Responses”Connected.
Media typeapplication/json
object
version
required
string | null
recipes
required
integer
alreadyHere
required
Recipes an earlier Mealie import brought in. They’re skipped.
integer
Example
{ "version": "v3.28.0", "recipes": 312, "alreadyHere": 0}Mealie didn’t take the token.
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 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." } }}Couldn’t reach Mealie, or it isn’t Mealie.
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.