Micronutrient API¶
Look up daily micronutrient requirements by nutrient name, age, and sex with life-stage-aware guidance.
Endpoint¶
GET /api/v1/micronutrientPOST /api/v1/micronutrient/post
Parameters¶
| Name | Type | Required | In | Description |
|---|---|---|---|---|
gender | string | Yes | Query/Body | male or female. |
age | integer | Yes | Query/Body | Age in years; supports age groups from 9+ years. |
micronutrient | string | Yes | Query/Body | Nutrient key (calcium,iron,magnesium,b12-related keys etc.). |
lang | string | No | Query | Response language (en,es,de,fr,pt,ja,hi,ar). |
Why Use This Endpoint¶
- Centralize requirement lookups for nutrition products.
- Support age-group specific recommendations in UX flows.
- Return actionable life-stage guidance with each lookup.
Request Example¶
curl -X GET "https://api.hefitapi.com/api/v1/micronutrient?gender=female&age=29µnutrient=iron&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/micronutrient/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"gender":"male","age":55,"micronutrient":"magnesium"}'
Response Example¶
Info
The response example below is for demonstration purposes only. Make a live request to this endpoint to receive the full, real-time, and potentially richer JSON structure.
{
"Micronutrient": "iron",
"Requirement": "18 mg/d",
"requirement_value": 18,
"requirement_unit": "mg/d",
"Gender": "female",
"Age": "29 yr",
"age_group": "19-30 y",
"life_stage": "adult",
"life_stage_label": "Adult",
"priority_focus": ["Prioritize nutrient density and absorption quality"],
"monitoring_plan": "Review dietary adequacy in periodic nutrition check-ins.",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "f9b92ab61182d57e",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "micronutrient",
"response_language": "en"
}
}
Product Positioning¶
Strong fit for nutrition education portals, meal-planning systems, and enterprise preventive-health products.
Note
Age below supported bands returns HTTP 400 because no requirement bucket is defined.
Recommended Endpoints¶
GET /api/v1/fitness/micronutrient-risk- Micronutrient Risk APIGET /api/v1/bmi- Bmi APIGET /api/v1/tdee- Tdee APIGET /api/v1/bmr- Bmr APIGET /api/v1/protein-calculator- Protein Calculator APIGET /api/v1/fitness/heart-rate-zones- Heart Rate Zones API