Skip to content
merran
GitHubInstall

Merran documentation API & integrations

Connect to a Mealie

POST
/api/households/current/import/mealie/check
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.

Media typeapplication/json
object
url
required
string format: uri
<= 2000 characters
token
required
string
>= 10 characters <= 4000 characters

Example

{
"url": "http://192.168.1.20:9000",
"token": "sample-mealie-api-token"
}

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.