Skip to content

Micronutrient API

Look up daily micronutrient requirements by nutrient name, age, and sex with life-stage-aware guidance.

Endpoint

  • GET /api/v1/micronutrient
  • POST /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.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/micronutrient?gender=female&age=29&micronutrient=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.