LogMeal Daily Nutritional Goal API
Endpoints related to the APIUser's daily nutritional goal management.⚡ Monitor plan or above ⚡
Endpoints related to the APIUser's daily nutritional goal management.⚡ Monitor plan or above ⚡
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/logmeal:logmeal-daily-nutritional-goal-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
version: 2.1.0
title: Food AI Engine API Documentation Daily Nutritional Goal API
description: Please, refer to https://docs.logmeal.com to find the most up-to-date version of the Food AI Engine API documentation.
contact:
email: support@logmeal.com
servers:
- url: https://api.logmeal.com
description: Production
tags:
- name: Daily Nutritional Goal
description: 'Endpoints related to the APIUser''s daily nutritional goal management.
⚡ Monitor plan or above ⚡'
externalDocs:
url: https://docs.logmeal.com/docs/guides-features-daily-nutritional-goals#/
paths:
/v2/daily_nutritional_goal:
get:
tags:
- Daily Nutritional Goal
summary: ⚫🔴🔵 Get all the existent daily goals from a user
description: 'Retrieve the previously created intake goals. If this endpoint is called by an APIUser it will return its current daily nutritional goals.
If this endpoint is called by an APICompany/APIUserManager an extra parameter with the ID of the user to get the information from is required.'
parameters:
- in: query
name: user_id
schema:
type: integer
required: false
description: Parameter only required to APICompanies and APIUserManagers. ID of the user ID to get the goals from.
- in: query
name: language
schema:
type: string
enum:
- spa
- cat
- eng
- ita
- nld
- fre
- ger
- tur
- gre
- heb
description: Desired language for the response. It must be a three-letter ISO 639-2/T code. Defaults to the APIUser's assigned language or english.
required: false
responses:
'200':
description: Nutritional goal successfully deleted!
content:
application/json:
schema:
type: object
properties:
nutritional_goals:
type: object
properties:
DailyNutritionalGoalSample:
type: object
description: Contains the information of a nutritional goal. The key 'DailyNutritionalGoalSample' will be replaced by each nutrient code that has a goal assigned.
properties:
average_value:
type: number
format: float
example: 15
description: Average value of the goal (mean between the ranges).
label:
type: string
description: Translated label of the nutritional indicator.
example: Sugars
range:
type: array
example:
- 10
- 20
description: Array containing the range of the nutritional goal, with the minimum value at the first position, and the maximum at the second.
unit:
type: string
description: Unit used to measure the quantity provided.
example: g
result:
type: string
example: Daily nutritional goals successfully retrieved!
'400':
description: Bad request
'401':
description: Unauthorized, invalid token.
'403':
description: Forbidden
'404':
description: Not found
content:
application/json:
schema:
type: object
oneOf:
- type: object
properties:
message:
type: string
example: APIUser does not exist.
code:
type: integer
example: 1201
examples:
APIUserDoesNotExist:
value:
message: APIUser does not exist.
code: 1201
security:
- Bearer: []
operationId: getV2DailyNutritionalGoal
x-operation-id-source: derived
post:
tags:
- Daily Nutritional Goal
summary: ⚫🔴🔵 Create a daily goal for a specific nutrient
description: 'Create a daily intake goal for an specific nutritional indicator. The daily nutritional goals a user has will be taken into consideration to generate the intake recommendation (/v2/nutrition/getRecommendedDailyIntake). If a goal for the given nutrient already exists, it will be updated.
Note that creating a goal for the daily calorie intake (''ENERC_KCAL'') will modify the amount of the recommended main nutrients the user should ingest, but the creation of goals for the main nutrients won''t effect the total calories the user should ingest. Be careful when creating goals, make sure the goals match properly the relationship between all the nutritional indicators (e.g. An increment of calorie intake, implies an increment of carbohydrates, fats and protein).
A nutritional goal consists on two values that determine the quantity range the users should ingest through their meals.
The available indicators with their respective units can be found by using the endpoint ''/v2/info/nutrients''.
Any custom nutritional indicator defined can also be set as a goal.'
requestBody:
content:
application/json:
schema:
type: object
properties:
nutrient_code:
type: string
example: VITC
enum:
- CA
- CHOCDF
- CHOLE
- ENERC_KCAL
- FAMS
- FAPU
- FASAT
- FAT
- FATRN
- FE
- FIBTG
- FOLAC
- FOLDFE
- FOLFD
- K
- MG
- NA
- NIA
- P
- PROCNT
- RIBF
- SUGAR
- SUGAR.added
- THIA
- TOCPHA
- VITA_RAE
- VITB12
- VITB6A
- VITC
- VITD
- VITK1
- ZN
- F20D5
- F22D6
- F18D3CN3
- CAFFN
- ALC
description: Code of the nutritional indicator. Read the endpoint description to find all the options with their related unit.
min_amount:
type: number
format: float
example: 1650
description: Minimum value of the goal range.
max_amount:
type: number
format: float
example: 1890
description: Maximum value of the goal range.
user_id:
type: integer
example: 123
description: Optional for user managers/companies. ID of the user to add a goal to. You must be the owner of / have access to the user in order to do any modification.
required:
- nutrient_code
- min_amount
- max_amount
description: Parameters to create the nutritional goal. Managers/APICompanies can provide an APIUser ID to modify a specific user's goals.
required: true
responses:
'200':
description: Nutritional goal successfully created!
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
code:
type: integer
message:
type: string
'401':
description: Unauthorized, invalid token.
'403':
description: Forbidden
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: The provided nutritional indicator code does not exist. You can find the available nutrient codes in this response.
code:
type: integer
example: 1315
available_nutritional_codes:
type: array
items:
type: string
example:
- CA
- CHOCDF
- CHOLE
- ENERC_KCAL
- FAMS
- FAPU
- FASAT
- FAT
- FATRN
- FE
- FIBTG
- FOLAC
- FOLDFE
- FOLFD
- K
- MG
- NA
- NIA
- P
- PROCNT
- RIBF
- SUGAR
- SUGAR.added
- THIA
- TOCPHA
- VITA_RAE
- VITB12
- VITB6A
- VITC
- VITD
- VITK1
- ZN
- F20D5
- F22D6
- F18D3CN3
- CAFFN
- ALC
security:
- Bearer: []
operationId: postV2DailyNutritionalGoal
x-operation-id-source: derived
delete:
tags:
- Daily Nutritional Goal
summary: ⚫🔴🔵 Delete an existent daily goal for a specific nutrient
description: Delete a previously created intake goal, for a specific nutrient.
parameters:
- in: query
name: user_id
schema:
type: integer
description: Parameter only required for APICompanies and APIUserManagers. ID of the user ID to get the goals from.
- in: query
name: nutrient_code
schema:
type: string
enum:
- CA
- CHOCDF
- CHOLE
- ENERC_KCAL
- FAMS
- FAPU
- FASAT
- FAT
- FATRN
- FE
- FIBTG
- FOLAC
- FOLDFE
- FOLFD
- K
- MG
- NA
- NIA
- P
- PROCNT
- RIBF
- SUGAR
- SUGAR.added
- THIA
- TOCPHA
- VITA_RAE
- VITB12
- VITB6A
- VITC
- VITD
- VITK1
- ZN
- F20D5
- F22D6
- F18D3CN3
- CAFFN
- ALC
required: true
example: VITC
description: Code of the nutritional indicator. Read the endpoint description to find all the options with their related unit.
responses:
'200':
description: Nutritional goal successfully deleted!
'400':
description: Bad request
'401':
description: Unauthorized, invalid token.
'403':
description: Forbidden
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
code:
type: integer
message:
type: string
examples:
Nutrient code does not exist:
value:
type: object
properties:
message:
type: string
example: The provided nutritional indicator code does not exist. You can find the available nutrient codes in this response.
code:
type: integer
example: 1315
available_nutritional_codes:
type: array
items:
type: string
example:
- CA
- CHOCDF
- CHOLE
- ENERC_KCAL
- FAMS
- FAPU
- FASAT
- FAT
- FATRN
- FE
- FIBTG
- FOLAC
- FOLDFE
- FOLFD
- K
- MG
- NA
- NIA
- P
- PROCNT
- RIBF
- SUGAR
- SUGAR.added
- THIA
- TOCPHA
- VITA_RAE
- VITB12
- VITB6A
- VITC
- VITD
- VITK1
- ZN
- F20D5
- F22D6
- F18D3CN3
- CAFFN
- ALC
Nutritional goal does not exist:
value:
type: object
properties:
message:
type: string
example: A nutritional goal for the provided nutrient code does not exist.
code:
type: integer
example: 1316
security:
- Bearer: []
operationId: deleteV2DailyNutritionalGoal
x-operation-id-source: derived
/v2/daily_nutritional_goal/autocompute:
post:
tags:
- Daily Nutritional Goal
summary: 🔵⚫ Autocompute a daily goal for a specific list of nutrients
description: 'Automatically computes and posts a daily intake goal given a list of nutrients and a user. There is an optional force parameter that will not take into consideration if the user had previous goals for the nutrients in the list and will recompute and update them. Otherwise the daily nutritional goals a user has will be taken into consideration and won''t be updated. If force is not true only the nutrients in the nutrient list that don''t have a goal defined for the user will be calculated.
If the nutrient list is empty or it isn''t passed all nutrient goals will be recalculated if force is true. Otherwise only the ones missing in the user''s goals. If force is not passed it will be false by default.
The user profile attributes used for macros calculations (Fat, Protein, Carbs, Energy) are sex, height, weight, birth, and lifestyle. Only sex and age are used for the other nutrients. If the user does not have enough information on its profile, global average values are used for each non-provided user profile attribute.
The available indicators with their respective units can be found by using the endpoint ''/v2/info/nutrients''.
The following nutrients do not give an autocalculation. They will appear as null in the response (manual goal can still be set): F20D5, F22D6, FOLAC, FOLFD, CAFFN, ALC.'
requestBody:
content:
application/json:
schema:
type: object
properties:
user_id:
type: integer
example: 1238
description: ID of the user to add a goal to. You must be the owner have access to the user in order to do any modification.
nutrient_list:
type: array
example:
- MG
- FAT
description: Nutrients you want compute automatically taking into account the force parameter. If empty or not passed all the available nutrients will be computed
force:
type: boolean
example: true
description: If true, every nutrient in nutrient_list will be recalculated. If false, only the ones with no previous goal. If not passed, it is false by default
required:
- user_id
description: Parameters to autocompute the daily nutritional goals
required: true
responses:
'200':
description: Daily nutritional goals successfully calculated!
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
code:
type: integer
message:
type: string
'401':
description: Unauthorized, invalid token.
'403':
description: Forbidden
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: The provided nutritional indicator code does not exist. You can find the available nutrient codes in this response.
code:
type: integer
example: 1315
available_nutritional_codes:
type: array
items:
type: string
example:
- CA
- CHOCDF
- CHOLE
- ENERC_KCAL
- FAMS
- FAPU
- FASAT
- FAT
- FATRN
- FE
- FIBTG
- FOLAC
- FOLDFE
- FOLFD
- K
- MG
- NA
- NIA
- P
- PROCNT
- RIBF
- SUGAR
- SUGAR.added
- THIA
- TOCPHA
- VITA_RAE
- VITB12
- VITB6A
- VITC
- VITD
- VITK1
- ZN
- F20D5
- F22D6
- F18D3CN3
- CAFFN
- ALC
security:
- Bearer: []
operationId: postV2DailyNutritionalGoalAutocompute
x-operation-id-source: derived
components:
securitySchemes:
Bearer:
type: http
scheme: bearer
bearerFormat: JWT
x-build:
time: '2026-10-19T02:02:11.433999Z'
x-provenance:
method: harvested
publisher: LogMeal
source: https://docs.logmeal.com/openapi/logmeal_openapi.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)