Merran documentation API & integrations

Nutrition across the library

GET

/api/recipes/nutrition

const url = 'http://localhost:3000/api/recipes/nutrition';
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/recipes/nutrition \
  --cookie merran.session_token=<merran.session_token>

How many recipes have no nutrition yet, how many need servings first, and the latest run working it out. With an API key, it needs the recipes: read permission.

Authorizations

session
apiKey

Responses

200

The library.

application/json

object

missing

required

Recipes with servings and ingredients but no nutrition.

integer

noServings

required

Recipes without nutrition that need servings first.

integer

run

required

The latest run, going or finished in the last day.

object

required

string

status

required

string

Allowed values: queued running done failed cancelled

total

required

integer

done

required

integer

workedOut

required

integer

failed

required

integer

stopped

required

Why it stopped before the end, when it did.

string | null

startedAt

required

string | null format: date-time

finishedAt

required

string | null format: date-time

Example

{
  "missing": 42,
  "noServings": 3,
  "run": {
    "id": "0199e8b0-5a10-7a01-8b00-00000000002f",
    "status": "running",
    "total": 42,
    "done": 12,
    "workedOut": 11,
    "failed": 1,
    "stopped": null,
    "startedAt": "2026-10-15T18:30:00.000Z",
    "finishedAt": null
  }
}

401

Not signed in.

application/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."
    }
  }
}

403

Not allowed.

application/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."
    }
  }
}