NutriGym API

A small read-only API for pulling your NutriGym data into other tools. All endpoints below are versioned under /api/v1 and require an API key.

Authentication

Generate a key from Settings in the app. Send it on every request as a bearer token in the Authorization header:

Authorization: Bearer <your_api_key>

Generating a new key revokes any previous key for your account. Requests with a missing or invalid key receive a 401 response.

Response Shape

Every endpoint returns the same envelope:

{
					"ok": boolean,
					"message": string,
					"data": T | null
				}

Endpoints

GET/api/v1/weight

Returns your logged weight entries over a trailing window of days, oldest first.

Query Parameters

Name	Type	Required	Description
days	integer	No	Number of trailing days to include. 1–365, defaults to 28.

Example Request

curl "https://nutrigym.softwarerror.com/api/v1/weight?days=7" \
					-H "Authorization: Bearer <your_api_key>"

Example Response

{
					"ok": true,
					"message": "Successfully retrieved weight.",
					"data": [
						{ "date": "2026-07-04", "weight": 181.2 },
						{ "date": "2026-07-06", "weight": 180.8 },
						{ "date": "2026-07-11", "weight": 180.1 }
					]
					}

GET/api/v1/macros

Returns your current active macro goals.

Example Request

curl "https://nutrigym.softwarerror.com/api/v1/macros" \
					-H "Authorization: Bearer <your_api_key>"

Example Response

{
					"ok": true,
					"message": "Successfully retrieved macro goals.",
					"data": {
						"calories": 2400,
						"protein": 180,
						"carbs": 250,
						"fat": 70
					}
				}

GET/api/v1/macros/tracked

Returns your logged (tracked) macros for the trailing 7-day window ending on the given date, oldest first.

Query Parameters

Name	Type	Required	Description
date	string (YYYY-MM-DD)	No	Anchor date for the 7-day window. Defaults to today (UTC).

Example Request

curl "https://nutrigym.softwarerror.com/api/v1/macros/tracked?date=2026-07-11" \
					-H "Authorization: Bearer <your_api_key>"

Example Response

{
					"ok": true,
					"message": "Successfully retrieved tracked macros.",
					"data": [
						{ "date": "Sat", "protein": 142, "carbs": 210, "fat": 61 },
						{ "date": "Sun", "protein": 155, "carbs": 198, "fat": 58 },
						{ "date": "Mon", "protein": 130, "carbs": 220, "fat": 65 },
						{ "date": "Tue", "protein": 148, "carbs": 205, "fat": 60 },
						{ "date": "Wed", "protein": 160, "carbs": 190, "fat": 55 },
						{ "date": "Thu", "protein": 138, "carbs": 215, "fat": 63 },
						{ "date": "Fri", "protein": 150, "carbs": 200, "fat": 59 }
					]
				}

Errors

A missing or invalid API key returns:

{
					"ok": false,
					"message": "Invalid or missing API key.",
					"data": null
				}