API Reference

Every documented route, with a page for each.

Meta

• GET / - API metadata

Health

• GET /health - Upstream service health check

Batch

• POST /batch - Run several sub-requests in one round trip

API Keys

• GET /admin/activity - Recent admin actions (root key only)
• GET /admin/health-history - Uptime, upstream status and outage timeline (root key only)
• GET /admin/keys - List API keys (root key only)
• POST /admin/keys - Create a new API key (root key only)
• DELETE /admin/keys/{id} - Revoke an API key (root key only)
• GET /admin/monitoring - Failed calls and slow endpoints (root key only)
• GET /admin/overview - Admin monitor snapshot (root key only)
• GET /admin/usage - Usage by endpoint (root key only)

Developer keys

• GET /developer/keys - List your consumer API keys
• POST /developer/keys - Create a consumer API key
• DELETE /developer/keys/{id} - Revoke one of your keys

Foods

• GET /foods - List foods
• POST /foods - Create a food (admin)
• GET /foods/{id} - Get a food by id
• PUT /foods/{id} - Replace a food (admin)
• PATCH /foods/{id} - Partially update a food (admin)
• DELETE /foods/{id} - Delete a food (admin)
• GET /foods/{id}/convert - Household and standard measures for the food with this id (API key, rate-limited)
• GET /foods/{id}/label - Codex-oriented nutrition label for one food
• GET /foods/autocomplete - Search-as-you-type suggestions (API key, rate-limited)
• GET /foods/baby-foods - Baby and infant foods (API key, rate-limited)
• POST /foods/bulk - Bulk-create foods (admin)
• GET /foods/by-category - Browse foods by category (API key, rate-limited)
• GET /foods/categories - Food category list (API key, rate-limited, cached 24h)
• GET /foods/compare - Side-by-side nutrient comparison of 2-6 foods (API key, rate-limited)
• GET /foods/convert - Household and standard measures for one food, either way round (API key, rate-limited)
• GET /foods/local-categories - Categories used by the local food table (API key, rate-limited)
• GET /foods/lookup - External food lookup cascade (API key, rate-limited)
• GET /foods/search - Typo-tolerant fuzzy search over foods (API key, rate-limited)
• GET /foods/substitutes - Nutritionally close substitutes for a food (API key, rate-limited)
• GET /measures - Every unit, the printed reference tables and the scoop sizes (API key, rate-limited)
• GET /measures/convert - Unit to unit, no food (API key, rate-limited)

Glycaemic Index

• GET /glycaemic-index - List glycaemic index/load reference entries
• POST /glycaemic-index - Create a glycaemic index entry (admin)
• GET /glycaemic-index/{id} - Get a glycaemic index entry by id
• PUT /glycaemic-index/{id} - Replace a glycaemic index entry (admin)
• PATCH /glycaemic-index/{id} - Partially update a glycaemic index entry (admin)
• DELETE /glycaemic-index/{id} - Delete a glycaemic index entry (admin)
• POST /glycaemic-index/bulk - Bulk-create glycaemic index entries (admin)

Exchange

• GET /exchange - List diabetes/renal exchange list entries
• POST /exchange - Create an exchange list entry (admin)
• PUT /exchange/{id} - Replace an exchange list entry (admin)
• PATCH /exchange/{id} - Partially update an exchange list entry (admin)
• DELETE /exchange/{id} - Delete an exchange list entry (admin)
• POST /exchange/bulk - Bulk-create exchange list entries (admin)

Renal

• GET /renal - List renal foods
• POST /renal - Create a renal food entry (admin)
• PUT /renal/{id} - Replace a renal food entry (admin)
• PATCH /renal/{id} - Partially update a renal food entry (admin)
• DELETE /renal/{id} - Delete a renal food entry (admin)
• POST /renal/bulk - Bulk-create renal food entries (admin)

Formulas

• GET /formulas - List enteral formulas
• POST /formulas - Create an enteral formula (admin)
• PUT /formulas/{id} - Replace an enteral formula (admin)
• PATCH /formulas/{id} - Partially update an enteral formula (admin)
• DELETE /formulas/{id} - Delete an enteral formula (admin)
• POST /formulas/bulk - Bulk-create enteral formulas (admin)

Drug Interactions

• GET /drug-interactions - List drug-nutrient interaction entries
• POST /drug-interactions - Create a drug-nutrient interaction entry (admin)
• GET /drug-interactions/{id} - Get a drug-nutrient interaction entry by id
• PUT /drug-interactions/{id} - Replace a drug-nutrient interaction entry (admin)
• PATCH /drug-interactions/{id} - Partially update a drug-nutrient interaction entry (admin)
• DELETE /drug-interactions/{id} - Delete a drug-nutrient interaction entry (admin)
• POST /drug-interactions/bulk - Bulk-create drug-nutrient interaction entries (admin)
• GET /drug-interactions/search - Keyword search across drug-nutrient interactions

BMI for age

• GET /bmi-for-age - List BMI-for-age reference rows (-3SD to +3SD cut-offs)
• POST /bmi-for-age/bulk - Bulk-create BMI-for-age rows (admin)
• GET /bmi-for-age/classify - Classify BMI-for-age for a child or adolescent (5y 1m to 19y 0m)

HC velocity

• GET /hc-velocity - List WHO 6-month head circumference increment rows (-3SD to +3SD, cm)
• POST /hc-velocity/bulk - Bulk-create HC velocity rows (admin)
• GET /hc-velocity/classify - Classify a 6-month head circumference increment (birth to 24 months)

Length velocity

• GET /length-velocity - List WHO 6-month length increment rows (-3SD to +3SD, cm)
• POST /length-velocity/bulk - Bulk-create Length velocity rows (admin)
• GET /length-velocity/classify - Classify a 6-month length increment (birth to 24 months)

Weight velocity

• GET /weight-velocity - List WHO 6-month weight increment rows (grams, with L/M/S/Delta)
• POST /weight-velocity/bulk - Bulk-create weight velocity rows (admin)
• GET /weight-velocity/classify - Classify a 6-month weight increment (birth to 24 months)

MUAC for age

• GET /muac-for-age - List WHO arm circumference-for-age rows (cm, with L/M/S)
• POST /muac-for-age/bulk - Bulk-create MUAC-for-age rows (admin)
• GET /muac-for-age/classify - Classify arm circumference (MUAC) for age, 3 to 60 months

MUAC fixed cut-offs

• GET /muac/classify - Classify MUAC with fixed age-group cut-offs (6 months to adult)

Length height for age

• GET /length-height-for-age - List WHO length/height-for-age rows (cm, with L/M/S)
• POST /length-height-for-age/bulk - Bulk-create length/height-for-age rows (admin)
• GET /length-height-for-age/classify - Classify length/height-for-age (stunting), birth to 19 years

Weight for age

• GET /weight-for-age - List WHO weight-for-age rows (kg, with L/M/S)
• POST /weight-for-age/bulk - Bulk-create weight-for-age rows (admin)
• GET /weight-for-age/classify - Classify weight-for-age (underweight), birth to 10 years

Weight for length height

• GET /weight-for-length-height - List WHO weight-for-length/height rows (kg, with L/M/S)
• POST /weight-for-length-height/bulk - Bulk-create weight-for-length/height rows (admin)
• GET /weight-for-length-height/classify - Classify weight-for-length/height (wasting), birth to 5 years

BMI for age under 5

• GET /bmi-for-age-under-5 - List WHO BMI-for-age rows, birth to 5 years (kg/m2, with L/M/S)
• POST /bmi-for-age-under-5/bulk - Bulk-create BMI-for-age (under 5) rows (admin)
• GET /bmi-for-age-under-5/classify - Classify BMI-for-age, birth to 5 years

HC for age

• GET /hc-for-age - List WHO head circumference-for-age rows (cm, with L/M/S)
• POST /hc-for-age/bulk - Bulk-create head circumference-for-age rows (admin)
• GET /hc-for-age/classify - Classify head circumference-for-age, birth to 5 years

Growth assessment

• GET /growth/assess - Combined WHO growth assessment (every applicable indicator in one call)

Energy

• GET /activity-energy - Physical activity energy table (kcal per hour by body weight)
• POST /activity-energy/bulk - Bulk-create activity energy rows (admin)
• POST /activity-energy/calculate - Energy spent on one or more activities
• GET /energy/factors - Energy engine factors and reference tables
• POST /energy/food-energy - Food energy from macronutrients or an alcoholic drink
• POST /energy/requirements - Energy requirement estimate (REE, stress, activity, IOM equations)

Sports Nutrition

• POST /sports/body-composition - Fat mass, lean mass, lowest safe weight and weekly rates
• POST /sports/energy - Athlete energy requirement (Cunningham REE, Box 23.2)
• POST /sports/fuel-timing - Carbohydrate before, during and after exercise
• POST /sports/hydration - Hydration: body-mass loss, rehydration, in-exercise fluid and sodium
• POST /sports/macros - Athlete macronutrient targets (g/kg by training profile)
• POST /sports/plan - One-athlete sports nutrition plan
• GET /sports/reference - Sports nutrition reference tables and known chapter issues
• POST /sports/supplement-dose - Weight-based supplement doses from Table 23.4

Weight Management

• POST /weight-management/assess - Assess weight status: BMI class, disease risk, metabolic syndrome, treatment options
• GET /weight-management/bariatric - Bariatric diet stages and supplementation (Tables 21.9 and 21.10)
• POST /weight-management/diet-pattern - Classify a daily macronutrient pattern
• POST /weight-management/gain-plan - Weight-gain plan for underweight adults
• POST /weight-management/loss-plan - Weight-loss plan: intake, expected rate, goal weights
• POST /weight-management/progress - Track progress from weigh-ins
• GET /weight-management/reference - Weight management reference tables

Pregnancy

• POST /pregnancy/assess - Pregnancy lab and clinical screens
• POST /pregnancy/gestational-age - Gestational age, trimester and due date
• POST /pregnancy/plan - Pregnancy or lactation nutrition plan
• GET /pregnancy/reference - Pregnancy and lactation reference tables
• POST /pregnancy/weight-gain - Pre-pregnancy BMI category and gestational weight gain

Renal Nutrition

• POST /renal-nutrition/adequacy - Dialysis adequacy
• GET /renal-nutrition/emergency-diet - Emergency dialysis diet plan
• POST /renal-nutrition/food-plan - Renal targets linked to the food exchange list
• POST /renal-nutrition/labs - Blood values with diet actions
• POST /renal-nutrition/plan - Renal nutrition plan in one call
• GET /renal-nutrition/reference - Renal nutrition reference tables
• POST /renal-nutrition/requirements - Nutrient targets by CKD status
• POST /renal-nutrition/stage - eGFR and CKD stage

Diabetes Nutrition

• POST /diabetes/carb-count - Carbohydrate counting from a food label
• POST /diabetes/carb-plan - Carbohydrate prescription and distribution
• POST /diabetes/exchange-plan - Carbohydrate targets linked to the exchange list
• POST /diabetes/exercise - Extra carbohydrate for exercise
• POST /diabetes/glucose-targets - Glucose targets
• POST /diabetes/glycemic-load - Glycaemic load of foods and a meal
• POST /diabetes/hypoglycemia - Hypoglycaemia level and treatment steps
• POST /diabetes/insulin - Insulin-to-carbohydrate ratio, correction factor and dose
• POST /diabetes/plan - Glycaemic status, targets and carbohydrate plan
• GET /diabetes/reference - Diabetes nutrition reference tables
• POST /diabetes/status - Diagnosis category and estimated average glucose

Fenton Preterm

• POST /fenton-preterm/bulk - Bulk-create Fenton preterm reference rows (admin)
• GET /fenton-preterm/chart - Server-rendered SVG growth chart (P3/P10/P50/P90/P97 curves)
• GET /fenton-preterm/classify - Classify a preterm infant measurement (weight, length, or head circumference)
• POST /fenton-preterm/growth - Classify a series of same-metric measurements over time (trajectory + trend)
• POST /fenton-preterm/profile - Classify weight, length, and head circumference together at one timepoint
• GET /fenton-preterm/references - Static reference metadata (years, sexes, metrics, valid age ranges, citations, license)
• POST /fenton-preterm/velocity - Growth velocity between consecutive same-metric measurements

FHIR

• POST /fhir/$validate - Structural R4 check of one resource or Bundle
• GET /fhir/AuditEvent - Search stored audit events (admin)
• GET /fhir/AuditEvent/{id} - Read one stored audit event (admin)
• POST /fhir/Bundle/$care-context - NCP Step 6 - professional and institutional context
• POST /fhir/Bundle/$ncp-document - NCP Step 5 - complete ADIME document Bundle
• POST /fhir/Bundle/$nutrition-assessment - Structured nutrition assessment (NCP step 1 foundation)
• POST /fhir/Bundle/$validate-document - Validate an ADIME document Bundle
• POST /fhir/CarePlan/$intervene - NCP Step 3 — nutrition intervention
• POST /fhir/CarePlan/$monitor - NCP Step 4 - monitoring and evaluation of a follow-up visit
• GET /fhir/CodeSystem/{name} - FHIR CodeSystem used by the facade
• GET /fhir/CodeSystem/ncp-diagnosis - NCP nutrition diagnostic terminology (2006 edition) as a FHIR CodeSystem
• GET /fhir/ConceptMap/{id} - Published terminology mapping
• POST /fhir/ConceptMap/$translate - Translate a Chakudya code (LOINC, HL7 practitioner-role, v3 ObservationInterpretation)
• POST /fhir/Condition/$diagnose - NCP Step 2 — nutrition diagnosis (PES statement)
• POST /fhir/Goal/$evaluate - NCP Step 4 — monitoring and evaluation
• GET /fhir/metadata - FHIR R4 CapabilityStatement
• POST /fhir/Observation/$assess-nutrition - NCP Step 1 — nutrition assessment (adults)
• POST /fhir/Observation/$evaluate-growth - Evaluate a growth/anthropometry measurement, FHIR-shaped
• POST /fhir/Observation/$screen - NCP screening (MUST, NRS-2002, MNA, SGA, PG-SGA or NACS classification)
• GET /fhir/OperationDefinition/{id} - FHIR OperationDefinition
• GET /fhir/Questionnaire - List the built-in assessment forms
• GET /fhir/Questionnaire/{id} - One built-in assessment form
• POST /fhir/QuestionnaireResponse/$validate - Validate a QuestionnaireResponse against a built-in form
• GET /fhir/StructureDefinition/{name} - FHIR Extension StructureDefinition

Packaged

• GET /packaged - List packaged/branded foods
• PUT /packaged/{id} - Replace a packaged food (admin)
• PATCH /packaged/{id} - Partially update a packaged food (admin)
• DELETE /packaged/{id} - Delete a packaged food (admin)
• POST /packaged/{id}/approve - Approve a pending packaged food (admin)
• POST /packaged/{id}/reject - Reject a pending packaged food (admin)
• GET /packaged/pending - Admin review queue (admin)
• POST /packaged/scan - Submit a packaged food via photo (API key, rate-limited)
• POST /packaged/submit - Submit a packaged food (API key, rate-limited)

Favorites

• GET /favorites - List a user's favorites (API key, rate-limited)
• POST /favorites - Save a favorite (API key, rate-limited, idempotent)
• DELETE /favorites - Remove a favorite (API key, rate-limited)

History

• GET /history - Recently viewed, most recent first (API key, rate-limited)
• POST /history - Log a view (API key, rate-limited, opt-in)

Food Log

• GET /log - List nutrition diary entries (API key, opt-in identity)
• POST /log - Log a food diary entry
• GET /log/{id} - Get a food log entry by id
• DELETE /log/{id} - Delete a food log entry
• GET /log/summary - Daily or weekly calorie totals for a user

Recipes

• POST /recipes/calculate - Compute total and per-serving nutrition for a recipe (API key, rate-limited)

Meals

• POST /meals/analyze - Analyze a meal's macro split, food groups, and (optionally) targets (API key, rate-limited)

Dietary assessment

• POST /dietary-assessment - Dietary assessment - intake analysis, comparison with requirements, dietary gaps (API key, rate-limited)
• GET /dietary-assessment/reference - Assessable nutrients, status definitions, accepted input and method notes (API key)

Paediatric nutrition

• POST /paediatric/catch-up - Catch-up growth energy and protein (API key)
• POST /paediatric/energy - Paediatric energy requirements (API key)
• POST /paediatric/enteral-feeds - Age-specific enteral feed calculations (API key)
• POST /paediatric/fluid - Paediatric maintenance fluid, Holliday-Segar (API key)
• POST /paediatric/growth-velocity - Growth velocity against the reference (API key)
• POST /paediatric/plan - Paediatric nutrition plan in one call (API key)
• POST /paediatric/preterm - Preterm infant requirements and growth monitoring (API key)
• POST /paediatric/protein - Paediatric protein requirements (API key)
• GET /paediatric/reference - Paediatric reference tables and their sources (API key)

Critical care nutrition

• POST /critical-care/carbohydrate - Carbohydrate requirement reference (API key)
• GET /critical-care/cho-fat-ratio - CHO:fat ratio of non-protein energy (API key)
• POST /critical-care/electrolytes - Phosphate, potassium and magnesium replacement reference (API key)
• GET /critical-care/fat - Fat requirement reference (API key)
• POST /critical-care/fluid - Adult ICU fluid reference range (API key)
• POST /critical-care/nitrogen-balance - Nitrogen output and stress grade (general ICU) (API key)
• POST /critical-care/npe-nitrogen-ratio - Non-protein energy to nitrogen ratio (API key)
• POST /critical-care/potassium-deficit - Total potassium deficit band from serum potassium (API key)
• POST /critical-care/propofol-fat - Propofol dose and fat delivered (API key)
• POST /critical-care/protein-by-stress - Protein by metabolic stress level (API key)
• GET /critical-care/reference - Critical care reference tables and known issues (API key)

Burn nutrition

• POST /burns/energy - Burn energy requirement, Toronto (adult) or weight-only Schofield (child) (API key)
• POST /burns/fluid-resuscitation - Burn resuscitation fluid, Parkland formula (API key)
• POST /burns/glycemic-targets - Burn carbohydrate ceiling and glucose targets (API key)
• POST /burns/indirect-calorimetry - REE from indirect calorimetry, modified Weir (API key)
• POST /burns/maintenance-fluid - Paediatric maintenance fluid, Holliday-Segar (API key)
• POST /burns/micronutrients - Burn micronutrient dosing guidance (API key)
• POST /burns/nitrogen-balance - Burn nitrogen balance (API key)
• POST /burns/pediatric-equations - Paediatric burn predictive equations side by side (API key)
• POST /burns/pharmacology - Burn hypermetabolism drug dosing reference (API key)
• POST /burns/protein - Burn protein requirement (API key)
• GET /burns/reference - Stored burn reference values (API key)

Refeeding syndrome

• POST /refeeding/initiation - Refeeding initiation and advancement (ASPEN Tables 6 and 7) (API key)
• GET /refeeding/reference - Stored refeeding reference values (API key)
• POST /refeeding/risk-adult - Refeeding risk, adults (ASPEN Table 3) (API key)
• POST /refeeding/risk-pediatric - Refeeding risk, paediatric (ASPEN Table 5) (API key)
• POST /refeeding/severity - Refeeding syndrome severity (ASPEN definition) (API key)

Energy and stress factors

• GET /stress-factors/adjustments - 24-hour energy expenditure adjustment factors (API key)
• GET /stress-factors/conditions - Clinical stress factors (Barak et al, 2002) (API key)
• POST /stress-factors/fever - Fever adjustment of a baseline REE (API key)
• POST /stress-factors/harris-benedict - Harris-Benedict BEE with optional stress, adjustment and temperature factors (API key)
• GET /stress-factors/reference - Stored stress factor reference values (API key)

Carbohydrate counting

• POST /carb-counting/carbohydrate-content - Carbohydrate in a weighed portion, or the portion weight for a carbohydrate target (API key)
• GET /carb-counting/dose-adjustment - Stepwise carbohydrate counting and dose adjustment (API key)
• GET /carb-counting/foods - Food groups that do and do not affect blood glucose (API key)
• GET /carb-counting/handy-measures - Handy carbohydrate measures and weighing rules (API key)
• POST /carb-counting/insulin-dose - Mealtime quick-acting insulin dose, carbohydrate plus optional correction (API key)
• GET /carb-counting/insulin-types - Background and quick-acting insulin types (API key)
• GET /carb-counting/reference - Stored carb counting reference values (API key)

Enteral nutrition

• POST /enteral-nutrition/calculate - Tube feeding prescription calculator (API key)
• GET /enteral-nutrition/reference - Enteral nutrition steps, limits and request fields (API key)

Micronutrient assessment

• POST /micronutrients/assess - Micronutrient intake assessment against the DRI (API key)
• GET /micronutrients/reference - Micronutrients covered and the adequacy rules (API key)
• GET /micronutrients/requirements - Vitamin and mineral requirements by life stage (API key)

Research engine

• POST /research/convert - Convert one nutrition value between units, with a plausibility check (API key)
• POST /research/harmonise - Standardise nutrition variables across one or several clinical studies (API key)
• GET /research/reference - Matching rules, unit factors, diagnosis concepts and outcome definitions (API key)
• GET /research/variables - Data dictionary of standardised variables (API key)

Longitudinal outcomes

• POST /longitudinal/analyse - Follow one participant's nutrition outcomes over repeated visits (API key)
• POST /longitudinal/cohort - Analyse a cohort's nutrition outcomes over follow-up (API key)
• GET /longitudinal/reference - Request fields, variables, condition definitions, pattern rules, thresholds and limits (API key)

Nutrition epidemiology

• POST /epidemiology/analyse - Prevalence, incidence, risk and odds ratios with confidence intervals from a research dataset (API key)
• POST /epidemiology/counts - The same estimators from published or tabulated counts (API key)
• GET /epidemiology/reference - Design rules, measure definitions, methods and limits (API key)

Data quality

• POST /data-quality/audit - Audit a nutrition dataset for unit errors, implausible measurements and inconsistencies (API key)
• GET /data-quality/reference - What each check means, the screening bands and the limits (API key)

Malnutrition research

• POST /malnutrition/analyse - Population-level malnutrition indicators from survey or study records (API key)
• GET /malnutrition/reference - Case definitions, thresholds and limits (API key)

Dataset export

• POST /export/dataset - De-identified, analysis-ready dataset files with dictionary, provenance and loaders (API key)
• GET /export/reference - Request fields, de-identification rules, file layouts, naming, provenance and limits (API key)
• POST /export/verify - Check files against the SHA-256 hashes in a provenance file (API key)

Ingredients

• POST /ingredients/parse - Parse free-text ingredients into structured items (API key, rate-limited)

DRI

• GET /dri - Look up EAR/RDA/AI/UL by life stage or age+sex
• POST /dri/compare - Compare an actual day's intake against a life stage's RDA/AI targets
• GET /dri/life-stages - List every DRI life-stage group

RAG

• POST /rag/ask - RAG Search Orchestrator (API key, rate-limited)
• POST /rag/enqueue - Queue an already-uploaded file, or retry a failed job (admin)
• POST /rag/ingest - Ingest a document into the RAG knowledge base (admin)
• GET /rag/jobs - List recent ingestion jobs (admin)
• GET /rag/jobs/{id} - Get one ingestion job (admin)
• POST /rag/retrieve - Raw semantic retrieval (API key, rate-limited)
• DELETE /rag/source - Bulk-remove RAG chunks by citation (admin)
• POST /rag/upload - Upload a document for automatic ingestion (admin)
• POST /rag/webhook - Storage trigger webhook (shared secret)

Memory

• POST /memory/consolidate - Manually trigger consolidation for one session (admin)
• GET /memory/recall - Recall (deprecated - use POST, same params as query string)
• POST /memory/recall - Recall top-K relevant memory rows for a session (API key, rate-limited, preferred)
• POST /memory/write - Write a raw memory fact (API key, rate-limited)

Developer

• POST /hooks/signup - Sign-up notification webhook (shared secret)

All guides

• Getting Started - Base URL, your first request and live API status.
• API Endpoints - What the API provides, grouped by resource.
• Authentication - API keys, key types, open routes and rate limits.
• Request & Response Examples - Response format, pagination and runnable examples.
• Data Schemas - Shared response and object shapes from the spec.
• Error Handling - Status codes, error bodies, retries and request IDs.
• Integrations - Browsers, the JS SDK, FHIR, AI assistants and batching.
• API Reference - Every documented route, with a page for each.