{"openapi":"3.1.0","info":{"title":"MyPlate.food nutrition API","version":"1.0.0","summary":"Free, no-key JSON API for USDA nutrition calculators and the MyPlate Kitchen recipe collection.","description":"Free, open, GET-only JSON API for USDA-based nutrition calculators (BMI, BMR/TDEE, macros, protein, body fat, ideal weight, the MyPlate food-group plan, the full DRI table, and more) and the public-domain USDA MyPlate Kitchen recipe collection.\n\nNo API key. Open CORS. Every calculator response carries a citation envelope — `source` (the published formula + reference) and `canonical_url` (the matching myplate.food page), with a `disclaimer` on health math — so consumers and AI agents can cite the number.\n\nRate limited to 20 requests/minute per IP on the free tier; over that returns HTTP 429 with a Retry-After header. Independent; not affiliated with the USDA.\n\nThe free tier is for live, per-request use inside your app or agent. It is not a bulk-download channel: systematically retrieving or mirroring the recipe collection into your own database or storage is outside the free tier and requires a license agreement (https://myplate.food/for-professionals). Full recipe fetches are additionally capped at 100/day per IP (one budget shared with the MCP get_recipe tool). Full terms: https://myplate.food/terms.","termsOfService":"https://myplate.food/terms","contact":{"name":"MyPlate.food","email":"hello@myplate.food","url":"https://myplate.food/api"},"license":{"name":"Free for live per-request use, no API key — rate-limited; bulk export / data feeds require a license","url":"https://myplate.food/for-professionals"}},"servers":[{"url":"https://myplate.food/api/v1","description":"Production v1 API"}],"x-rate-limit":{"free_tier_per_minute":20,"on_exceeded":"HTTP 429 with a Retry-After header","contact_email":"hello@myplate.food","contact_url":"https://myplate.food/for-professionals"},"tags":[{"name":"Body metrics","description":"BMI, body fat, and ratio-based body-composition calculators."},{"name":"Energy & macros","description":"BMR, TDEE, calorie deficits, macronutrient splits, protein and ideal weight."},{"name":"MyPlate plan","description":"The USDA MyPlate food-group plan at your estimated calorie level."},{"name":"Guideline tools","description":"Water intake, one-rep max, GLP-1 protein, D-A-CH energy, and the full DRI table."},{"name":"Recipes","description":"Search and fetch the public-domain USDA MyPlate Kitchen recipe collection."},{"name":"Meta","description":"API index and this OpenAPI description."}],"paths":{"/calculate/myplate-plan":{"get":{"operationId":"calculate_myplate_plan","summary":"USDA MyPlate food-pattern plan","description":"Estimate daily calorie needs (IOM/NASEM Estimated Energy Requirement) and return the USDA MyPlate food-group plan at that level — cups of fruit/vegetables/dairy, ounce-equivalents of grains/protein, weekly vegetable & protein subgroup targets, and BMI.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/calculator), plus a `disclaimer`.","tags":["MyPlate plan"],"parameters":[{"name":"age","in":"query","required":true,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"activity","in":"query","required":false,"description":"Physical activity level. Defaults to sedentary.","schema":{"type":"string","enum":["sedentary","moderately-active","active","very-active"]},"example":"active"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176},{"name":"pregnancy","in":"query","required":false,"description":"Pregnancy status (adds the IOM trimester energy allowance).","schema":{"type":"string","enum":["not-pregnant","1st-trimester","2nd-trimester","3rd-trimester"]}},{"name":"lactation","in":"query","required":false,"description":"Lactation status (adds the IOM lactation energy allowance).","schema":{"type":"string","enum":["not-lactating","0-6-months","7-12-months"]}},{"name":"edition","in":"query","required":false,"description":"DRI Estimated Energy Requirement equation set. Defaults to iom2005.","schema":{"type":"string","enum":["iom2005","nasem2023"]},"example":"iom2005"}],"x-example-request":"https://myplate.food/api/v1/calculate/myplate-plan?age=30&sex=female&activity=moderately-active&height_cm=165&weight_kg=63","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"myplate-plan","inputs":{},"source":"USDA Dietary Guidelines for Americans food patterns + IOM/NASEM Estimated Energy Requirement equations, computed by myplate.food","canonical_url":"https://myplate.food/calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/calorie-needs":{"get":{"operationId":"calculate_calorie_needs","summary":"BMR, TDEE, deficit tiers, macros, protein & ideal-weight (everything-energy)","description":"One call for the full energy picture: resting metabolic rate (Mifflin-St Jeor), revised Harris-Benedict, TDEE at every activity level, three weight-loss deficit tiers, macronutrient splits, protein targets and healthy-weight ranges.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/metabolic-calculator), plus a `disclaimer`.","tags":["Energy & macros"],"parameters":[{"name":"age","in":"query","required":true,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"activity","in":"query","required":false,"description":"Physical activity level. Defaults to sedentary.","schema":{"type":"string","enum":["sedentary","moderately-active","active","very-active"]},"example":"active"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176}],"x-example-request":"https://myplate.food/api/v1/calculate/calorie-needs?age=30&sex=male&activity=active&height_cm=180&weight_kg=80","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"calorie-needs","inputs":{},"source":"Mifflin-St Jeor resting metabolic rate + WHO/FAO activity multipliers (TDEE) + IOM AMDR macronutrient ranges, computed by myplate.food","canonical_url":"https://myplate.food/metabolic-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/bmr":{"get":{"operationId":"calculate_bmr","summary":"Basal metabolic rate (Mifflin-St Jeor + Harris-Benedict)","description":"Resting/basal metabolic rate — the calories your body burns at rest. Returns the headline Mifflin-St Jeor (1990) value plus the revised Harris-Benedict (Roza & Shizgal 1984) estimate for comparison.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/bmr-calculator), plus a `disclaimer`.","tags":["Energy & macros"],"parameters":[{"name":"age","in":"query","required":true,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176}],"x-example-request":"https://myplate.food/api/v1/calculate/bmr?age=35&sex=male&height_ft=5&height_in=10&weight_lb=170","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"bmr","inputs":{},"source":"Basal metabolic rate — Mifflin-St Jeor (1990) headline with the revised Harris-Benedict (Roza & Shizgal 1984) for comparison, computed by myplate.food","canonical_url":"https://myplate.food/bmr-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/tdee":{"get":{"operationId":"calculate_tdee","summary":"Total daily energy expenditure","description":"Total daily energy expenditure (maintenance calories): Mifflin-St Jeor resting metabolic rate scaled by a physical-activity multiplier. Returns TDEE at the selected activity level plus a table across all four levels.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/tdee-calculator), plus a `disclaimer`.","tags":["Energy & macros"],"parameters":[{"name":"age","in":"query","required":true,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"activity","in":"query","required":false,"description":"Physical activity level. Defaults to sedentary.","schema":{"type":"string","enum":["sedentary","moderately-active","active","very-active"]},"example":"active"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176}],"x-example-request":"https://myplate.food/api/v1/calculate/tdee?age=30&sex=male&activity=active&height_cm=180&weight_kg=80","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"tdee","inputs":{},"source":"Total daily energy expenditure — Mifflin-St Jeor (1990) resting metabolic rate × WHO/FAO physical-activity-level (PAL) multipliers, computed by myplate.food","canonical_url":"https://myplate.food/tdee-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/calorie-deficit":{"get":{"operationId":"calculate_calorie_deficit","summary":"Calorie-deficit tiers for weight loss","description":"Maintenance calories (TDEE) and three deficit tiers — mild (−250), standard (−500) and aggressive (−750 kcal/day) — with the realistic weekly rate each buys and a flag when a target dips below BMR.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/calorie-deficit-calculator), plus a `disclaimer`.","tags":["Energy & macros"],"parameters":[{"name":"age","in":"query","required":true,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"activity","in":"query","required":false,"description":"Physical activity level. Defaults to sedentary.","schema":{"type":"string","enum":["sedentary","moderately-active","active","very-active"]},"example":"active"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176}],"x-example-request":"https://myplate.food/api/v1/calculate/calorie-deficit?age=30&sex=female&activity=moderately-active&height_cm=165&weight_kg=70","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"calorie-deficit","inputs":{},"source":"Maintenance calories (Mifflin-St Jeor × activity) minus a deficit, using the conventional ~7,700 kcal/kg body-fat approximation, computed by myplate.food","canonical_url":"https://myplate.food/calorie-deficit-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/macros":{"get":{"operationId":"calculate_macros","summary":"Macronutrient split (protein / carbs / fat)","description":"Split a calorie budget into protein, carbohydrate and fat grams across three common presets (balanced, higher-protein, lower-carb). Pass a calorie total directly, or a full profile to derive TDEE first.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/macro-calculator), plus a `disclaimer`.","tags":["Energy & macros"],"parameters":[{"name":"calories","in":"query","required":false,"description":"Daily calorie budget to split. Omit to derive TDEE from a profile.","schema":{"type":"number","minimum":500,"maximum":8000},"example":2000},{"name":"age","in":"query","required":false,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":false,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"activity","in":"query","required":false,"description":"Physical activity level. Defaults to sedentary.","schema":{"type":"string","enum":["sedentary","moderately-active","active","very-active"]},"example":"active"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176}],"x-example-request":"https://myplate.food/api/v1/calculate/macros?calories=2000","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"macros","inputs":{},"source":"Macronutrient split within the IOM acceptable macronutrient distribution ranges (protein 10–35%, carbohydrate 45–65%, fat 20–35%), computed by myplate.food","canonical_url":"https://myplate.food/macro-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/protein":{"get":{"operationId":"calculate_protein","summary":"Daily protein target","description":"Daily protein target from body weight and activity: the IOM RDA floor (0.8 g/kg) and a g/kg range scaled to activity level (up to the 1.2–2.0 g/kg athlete range), in grams per day.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/protein-calculator), plus a `disclaimer`.","tags":["Energy & macros"],"parameters":[{"name":"age","in":"query","required":true,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"activity","in":"query","required":false,"description":"Physical activity level. Defaults to sedentary.","schema":{"type":"string","enum":["sedentary","moderately-active","active","very-active"]},"example":"active"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176}],"x-example-request":"https://myplate.food/api/v1/calculate/protein?age=35&sex=male&activity=moderately-active&height_cm=178&weight_kg=77","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"protein","inputs":{},"source":"Protein targets — IOM RDA 0.8 g/kg with the Academy of Nutrition and Dietetics / Dietitians of Canada / ACSM (2016) 1.2–2.0 g/kg activity ranges, computed by myplate.food","canonical_url":"https://myplate.food/protein-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/ideal-weight":{"get":{"operationId":"calculate_ideal_weight","summary":"Ideal / healthy body-weight range","description":"Estimated ideal body weight from height and sex via four classic clinical formulas (Devine, Robinson, Miller, Hamwi), plus the healthy-BMI (18.5–24.9) weight band and your current BMI for context.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/ideal-weight-calculator), plus a `disclaimer`.","tags":["Energy & macros"],"parameters":[{"name":"age","in":"query","required":true,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176}],"x-example-request":"https://myplate.food/api/v1/calculate/ideal-weight?age=35&sex=male&height_ft=5&height_in=10&weight_lb=170","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"ideal-weight","inputs":{},"source":"Ideal body-weight estimates — Devine (1974), Robinson (1983), Miller (1983) and Hamwi (1964) formulas plus the healthy-BMI (18.5–24.9) weight band, computed by myplate.food","canonical_url":"https://myplate.food/ideal-weight-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/bmi":{"get":{"operationId":"calculate_bmi","summary":"Body Mass Index + classification","description":"Body Mass Index and weight classification from height and weight. Adults use the WHO cutoffs; pass age + sex for ages 2–19 to use the CDC BMI-for-age percentiles (which are sex-specific).\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/bmi-calculator), plus a `disclaimer`.","tags":["Body metrics"],"parameters":[{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176},{"name":"age","in":"query","required":false,"description":"Age in years (2–120). Omit for adult BMI cutoffs; required (with sex) under age 20 for CDC percentiles. Under 2, weight status is assessed on weight-for-length rather than BMI.","schema":{"type":"integer","minimum":2,"maximum":120},"example":30},{"name":"sex","in":"query","required":false,"description":"Required only when age < 20 (CDC curves are sex-specific).","schema":{"type":"string","enum":["male","female"]},"example":"male"}],"x-example-request":"https://myplate.food/api/v1/calculate/bmi?height_cm=180&weight_kg=80","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"bmi","inputs":{},"source":"Body Mass Index — WHO adult cutoffs, CDC BMI-for-age percentiles under age 20, computed by myplate.food","canonical_url":"https://myplate.food/bmi-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/body-fat":{"get":{"operationId":"calculate_body_fat","summary":"Body-fat % (U.S. Navy circumference method)","description":"Estimate body-fat % using the U.S. Navy circumference method, with a Deurenberg BMI-based cross-check and ACE category. Needs neck and waist measurements (plus hip for women).\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/body-fat-calculator), plus a `disclaimer`.","tags":["Body metrics"],"parameters":[{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"age","in":"query","required":true,"description":"Age in years (18–80). The Deurenberg cross-check and the ACE category bands are adult references; the Navy equation itself does not use age.","schema":{"type":"integer","minimum":18,"maximum":80},"example":30},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176},{"name":"neck_cm","in":"query","required":false,"description":"Neck circumference in cm (or neck_in).","schema":{"type":"number"},"example":38},{"name":"neck_in","in":"query","required":false,"description":"Neck circumference in inches.","schema":{"type":"number"}},{"name":"waist_cm","in":"query","required":false,"description":"Waist circumference in cm (or waist_in).","schema":{"type":"number"},"example":85},{"name":"waist_in","in":"query","required":false,"description":"Waist circumference in inches.","schema":{"type":"number"}},{"name":"hip_cm","in":"query","required":false,"description":"Hip circumference in cm — required for women (or hip_in).","schema":{"type":"number"}},{"name":"hip_in","in":"query","required":false,"description":"Hip circumference in inches (women).","schema":{"type":"number"}}],"x-example-request":"https://myplate.food/api/v1/calculate/body-fat?sex=male&age=30&height_cm=180&weight_kg=80&neck_cm=38&waist_cm=85","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"body-fat","inputs":{},"source":"U.S. Navy circumference method + Deurenberg BMI estimate (ACE categories), computed by myplate.food","canonical_url":"https://myplate.food/body-fat-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/waist-to-height":{"get":{"operationId":"calculate_waist_to_height","summary":"Waist-to-height ratio","description":"Waist-to-height ratio and its risk band (Ashwell: keep your waist under half your height).\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/waist-to-height-ratio-calculator), plus a `disclaimer`.","tags":["Body metrics"],"parameters":[{"name":"unit","in":"query","required":false,"description":"Units for inputs and output. metric = cm/kg (default), imperial = in/lb.","schema":{"type":"string","enum":["metric","imperial"]},"example":"metric"},{"name":"waist","in":"query","required":true,"description":"Waist circumference (cm or in per unit).","schema":{"type":"number"},"example":80},{"name":"height","in":"query","required":true,"description":"Height (cm or in per unit).","schema":{"type":"number"},"example":180}],"x-example-request":"https://myplate.food/api/v1/calculate/waist-to-height?waist=80&height=180","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"waist-to-height","inputs":{},"source":"Waist-to-height ratio — Ashwell & Hsieh (2005) risk bands, computed by myplate.food","canonical_url":"https://myplate.food/waist-to-height-ratio-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/waist-to-hip":{"get":{"operationId":"calculate_waist_to_hip","summary":"Waist-to-hip ratio","description":"Waist-to-hip ratio and WHO (2008) risk band (cutoffs differ by sex).\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/waist-to-hip-ratio-calculator), plus a `disclaimer`.","tags":["Body metrics"],"parameters":[{"name":"unit","in":"query","required":false,"description":"Units for inputs and output. metric = cm/kg (default), imperial = in/lb.","schema":{"type":"string","enum":["metric","imperial"]},"example":"metric"},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"waist","in":"query","required":true,"description":"Waist circumference (cm or in).","schema":{"type":"number"},"example":90},{"name":"hip","in":"query","required":true,"description":"Hip circumference (cm or in).","schema":{"type":"number"},"example":100}],"x-example-request":"https://myplate.food/api/v1/calculate/waist-to-hip?waist=90&hip=100&sex=male","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"waist-to-hip","inputs":{},"source":"Waist-to-hip ratio — WHO (2008) expert-consultation cutoffs, computed by myplate.food","canonical_url":"https://myplate.food/waist-to-hip-ratio-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/lean-body-mass":{"get":{"operationId":"calculate_lean_body_mass","summary":"Lean body mass (Boer + Hume)","description":"Lean body mass from weight, height and sex via the Boer (1984) and Hume (1966) formulas, plus implied fat mass.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/lean-body-mass-calculator), plus a `disclaimer`.","tags":["Body metrics"],"parameters":[{"name":"unit","in":"query","required":false,"description":"Units for inputs and output. metric = cm/kg (default), imperial = in/lb.","schema":{"type":"string","enum":["metric","imperial"]},"example":"metric"},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"weight","in":"query","required":true,"description":"Weight (kg or lb).","schema":{"type":"number"},"example":80},{"name":"height","in":"query","required":true,"description":"Height (cm or in).","schema":{"type":"number"},"example":180}],"x-example-request":"https://myplate.food/api/v1/calculate/lean-body-mass?weight=80&height=180&sex=male","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"lean-body-mass","inputs":{},"source":"Lean body mass — Boer (1984) and Hume (1966) prediction equations, computed by myplate.food","canonical_url":"https://myplate.food/lean-body-mass-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/ffmi":{"get":{"operationId":"calculate_ffmi","summary":"Fat-free mass index","description":"Fat-free mass index (FFMI) and its height-normalized value from weight, height, body-fat % and sex (Kouri 1995 normalization).\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/ffmi-calculator), plus a `disclaimer`.","tags":["Body metrics"],"parameters":[{"name":"unit","in":"query","required":false,"description":"Units for inputs and output. metric = cm/kg (default), imperial = in/lb.","schema":{"type":"string","enum":["metric","imperial"]},"example":"metric"},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"weight","in":"query","required":true,"description":"Weight (kg or lb).","schema":{"type":"number"},"example":80},{"name":"height","in":"query","required":true,"description":"Height (cm or in).","schema":{"type":"number"},"example":180},{"name":"body_fat","in":"query","required":true,"description":"Body-fat percentage (0–70).","schema":{"type":"number","minimum":0,"maximum":70},"example":15}],"x-example-request":"https://myplate.food/api/v1/calculate/ffmi?weight=80&height=180&body_fat=15&sex=male","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"ffmi","inputs":{},"source":"Fat-free mass index — Kouri et al. (1995) height-normalization, computed by myplate.food","canonical_url":"https://myplate.food/ffmi-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/water-intake":{"get":{"operationId":"calculate_water_intake","summary":"Daily water intake","description":"Daily fluid target from body weight and activity, based on the U.S. DRI total-water reference and the 30–40 mL/kg/day rule of thumb.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/water-intake-calculator), plus a `disclaimer`.","tags":["Guideline tools"],"parameters":[{"name":"unit","in":"query","required":false,"description":"Units for inputs and output. metric = cm/kg (default), imperial = in/lb.","schema":{"type":"string","enum":["metric","imperial"]},"example":"metric"},{"name":"weight","in":"query","required":true,"description":"Weight (kg or lb).","schema":{"type":"number"},"example":70},{"name":"activity","in":"query","required":false,"description":"Activity level (default moderate).","schema":{"type":"string","enum":["sedentary","moderate","active"]},"example":"moderate"}],"x-example-request":"https://myplate.food/api/v1/calculate/water-intake?weight=70","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"water-intake","inputs":{},"source":"Daily water intake — U.S. DRI total-water reference + 30–40 mL/kg/day rule of thumb, computed by myplate.food","canonical_url":"https://myplate.food/water-intake-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/weight-loss-percentage":{"get":{"operationId":"calculate_weight_loss_percentage","summary":"Weight-loss percentage","description":"Percentage of starting body weight lost (or gained), against the NHLBI/USPSTF 5–10% clinically-meaningful thresholds.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/weight-loss-percentage-calculator), plus a `disclaimer`.","tags":["Guideline tools"],"parameters":[{"name":"unit","in":"query","required":false,"description":"Units for inputs and output. metric = cm/kg (default), imperial = in/lb.","schema":{"type":"string","enum":["metric","imperial"]},"example":"metric"},{"name":"start_weight","in":"query","required":true,"description":"Starting weight (kg or lb).","schema":{"type":"number"},"example":100},{"name":"current_weight","in":"query","required":true,"description":"Current weight (kg or lb).","schema":{"type":"number"},"example":93}],"x-example-request":"https://myplate.food/api/v1/calculate/weight-loss-percentage?start_weight=100&current_weight=93","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"weight-loss-percentage","inputs":{},"source":"Weight-loss percentage — NHLBI/USPSTF 5–10% clinically-meaningful thresholds, computed by myplate.food","canonical_url":"https://myplate.food/weight-loss-percentage-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/one-rep-max":{"get":{"operationId":"calculate_one_rep_max","summary":"One-rep max (1RM)","description":"Estimated one-rep max from a set taken near failure, via the Epley (1985) and Brzycki (1993) formulas, with a training-percentage table.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/one-rep-max-calculator), plus a `disclaimer`.","tags":["Guideline tools"],"parameters":[{"name":"unit","in":"query","required":false,"description":"Units for inputs and output. metric = cm/kg (default), imperial = in/lb.","schema":{"type":"string","enum":["metric","imperial"]},"example":"metric"},{"name":"weight","in":"query","required":true,"description":"Weight lifted (kg or lb).","schema":{"type":"number"},"example":100},{"name":"reps","in":"query","required":true,"description":"Reps performed (1–12).","schema":{"type":"integer","minimum":1,"maximum":12},"example":5}],"x-example-request":"https://myplate.food/api/v1/calculate/one-rep-max?weight=100&reps=5","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"one-rep-max","inputs":{},"source":"One-rep max — Epley (1985) and Brzycki (1993) estimation formulas, computed by myplate.food","canonical_url":"https://myplate.food/one-rep-max-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/glp1-protein":{"get":{"operationId":"calculate_glp1_protein","summary":"GLP-1 muscle-preservation protein target","description":"Protein target to preserve muscle during weight loss on a GLP-1 medication (Ozempic/Wegovy/Zepbound/Mounjaro): the 1.2–1.6 g/kg preservation range vs the 0.8 g/kg RDA, per-meal spread, and the DRI fiber Adequate Intake for age + sex.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/glp-1-protein-calculator), plus a `disclaimer`.","tags":["Guideline tools"],"parameters":[{"name":"unit","in":"query","required":false,"description":"Units for inputs and output. metric = cm/kg (default), imperial = in/lb.","schema":{"type":"string","enum":["metric","imperial"]},"example":"metric"},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"weight","in":"query","required":true,"description":"Body weight (kg or lb).","schema":{"type":"number"},"example":80},{"name":"age","in":"query","required":true,"description":"Age in years (sets the fiber Adequate Intake).","schema":{"type":"integer","minimum":1,"maximum":120},"example":40}],"x-example-request":"https://myplate.food/api/v1/calculate/glp1-protein?weight=80&age=40&sex=male","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"glp1-protein","inputs":{},"source":"GLP-1 muscle-preservation protein — IOM/NASEM RDA (0.8 g/kg) and the 1.2–1.6 g/kg preservation range (AND/DoC/ACSM 2016; Phillips 2016), computed by myplate.food","canonical_url":"https://myplate.food/glp-1-protein-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/dach-energy":{"get":{"operationId":"calculate_dach_energy","summary":"D-A-CH / DGE energy requirement","description":"Daily energy requirement for the German/Austrian/Swiss (D-A-CH) reference framework: resting energy after the Müller et al. (2004) equation the DGE uses, scaled by a PAL activity factor. Returns resting energy, the requirement at the chosen PAL, and a table at PAL 1.4 / 1.6 / 1.8. Adults only — the DGE derives this equation for adults and publishes table reference values for children and adolescents instead.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/ernaehrungspyramide/energiebedarf), plus a `disclaimer`.","tags":["Guideline tools"],"parameters":[{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"age","in":"query","required":true,"description":"Age in years (19–120). The DGE derives resting energy from Müller (2004) for adults only; under 19 it publishes table reference values instead, which this endpoint does not compute.","schema":{"type":"integer","minimum":19,"maximum":120},"example":40},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (or weight_lb).","schema":{"type":"number"},"example":71},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds.","schema":{"type":"number"}},{"name":"pal","in":"query","required":false,"description":"Physical Activity Level factor (default 1.6, DGE range 1.2–2.4).","schema":{"type":"number","minimum":1.2,"maximum":2.4},"example":1.6}],"x-example-request":"https://myplate.food/api/v1/calculate/dach-energy?sex=male&age=40&weight_kg=71&pal=1.6","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"dach-energy","inputs":{},"source":"D-A-CH / DGE reference values for energy intake — resting energy after Müller et al. (2004) × PAL activity factor, computed by myplate.food (source: Deutsche Gesellschaft für Ernährung, Referenzwerte für die Energiezufuhr)","canonical_url":"https://myplate.food/ernaehrungspyramide/energiebedarf"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/calculate/dri":{"get":{"operationId":"calculate_dri","summary":"Dietary Reference Intakes (full nutrient table)","description":"The full Dietary Reference Intakes table for a life stage: recommended intakes and tolerable upper limits for macronutrients, vitamins and minerals (IOM 2005/2006/2011, NASEM 2019), plus the Estimated Energy Requirement and BMI.\n\nCites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/dri-calculator), plus a `disclaimer`.","tags":["Guideline tools"],"parameters":[{"name":"age","in":"query","required":true,"description":"Age in years.","schema":{"type":"integer","minimum":1,"maximum":120},"example":30},{"name":"sex","in":"query","required":true,"description":"Biological sex — drives the equation.","schema":{"type":"string","enum":["male","female"]},"example":"male"},{"name":"activity","in":"query","required":false,"description":"Physical activity level. Defaults to sedentary.","schema":{"type":"string","enum":["sedentary","moderately-active","active","very-active"]},"example":"active"},{"name":"height_cm","in":"query","required":false,"description":"Height in centimeters (metric). Provide height_cm OR height_ft (+ optional height_in).","schema":{"type":"number"},"example":180},{"name":"height_ft","in":"query","required":false,"description":"Height, feet component (imperial).","schema":{"type":"number"},"example":5},{"name":"height_in","in":"query","required":false,"description":"Height, inches component (imperial).","schema":{"type":"number"},"example":10},{"name":"weight_kg","in":"query","required":false,"description":"Weight in kilograms (metric). Provide weight_kg OR weight_lb.","schema":{"type":"number"},"example":80},{"name":"weight_lb","in":"query","required":false,"description":"Weight in pounds (imperial).","schema":{"type":"number"},"example":176},{"name":"pregnancy","in":"query","required":false,"description":"Pregnancy status (adds the IOM trimester energy allowance).","schema":{"type":"string","enum":["not-pregnant","1st-trimester","2nd-trimester","3rd-trimester"]}},{"name":"lactation","in":"query","required":false,"description":"Lactation status (adds the IOM lactation energy allowance).","schema":{"type":"string","enum":["not-lactating","0-6-months","7-12-months"]}},{"name":"edition","in":"query","required":false,"description":"DRI Estimated Energy Requirement equation set. Defaults to iom2005.","schema":{"type":"string","enum":["iom2005","nasem2023"]},"example":"iom2005"}],"x-example-request":"https://myplate.food/api/v1/calculate/dri?age=25&sex=male&activity=moderately-active&height_cm=178&weight_kg=77","responses":{"200":{"description":"Calculation result with citation envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitedResult"},"example":{"calculator":"dri","inputs":{},"source":"Dietary Reference Intakes — National Academies (IOM 2005/2006/2011, NASEM 2019) recommended intakes with IOM/NASEM Estimated Energy Requirements, computed by myplate.food","canonical_url":"https://myplate.food/dri-calculator"}}}},"400":{"description":"Invalid or missing parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recipes":{"get":{"operationId":"search_recipes","summary":"Search MyPlate Kitchen recipes","description":"Search the ~1,072-recipe public-domain USDA MyPlate Kitchen collection by query, food group, category, max calories and minimum rating. Returns recipe cards; use /recipes/{slug} for the full recipe.","tags":["Recipes"],"parameters":[{"name":"q","in":"query","required":false,"description":"Free-text search over recipe name + description.","schema":{"type":"string"},"example":"chicken"},{"name":"food_group","in":"query","required":false,"description":"Filter by MyPlate food group.","schema":{"type":"string","enum":["fruits","vegetables","grains","protein-foods","dairy"]}},{"name":"category","in":"query","required":false,"description":"Dish category, e.g. \"Main dish\", \"Salad\", \"Soup\".","schema":{"type":"string"}},{"name":"max_calories","in":"query","required":false,"description":"Only recipes at or below this calorie count per serving.","schema":{"type":"number"}},{"name":"min_rating","in":"query","required":false,"description":"Minimum USDA rating (0–5).","schema":{"type":"number","minimum":0,"maximum":5}},{"name":"limit","in":"query","required":false,"description":"Max results (default 20).","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"description":"Pagination offset.","schema":{"type":"integer","minimum":0}}],"x-example-request":"https://myplate.food/api/v1/recipes?q=chicken&food_group=protein-foods&limit=5","responses":{"200":{"description":"A page of recipe cards.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/recipes/{slug}":{"get":{"operationId":"get_recipe","summary":"Get a full MyPlate Kitchen recipe","description":"Fetch one recipe by slug: ingredients, directions, the full USDA nutrition table, MyPlate food-group amounts, rating, image and source attribution.","tags":["Recipes"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Recipe slug, e.g. \"2-step-chicken\".","schema":{"type":"string"},"example":"2-step-chicken"}],"x-example-request":"https://myplate.food/api/v1/recipes/2-step-chicken","responses":{"200":{"description":"The full recipe.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Recipe not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/":{"get":{"operationId":"api_index","summary":"API index","description":"Self-documenting catalog of endpoints, rate limits and the MCP endpoint.","tags":["Meta"],"responses":{"200":{"description":"The API index.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/openapi.json":{"get":{"operationId":"openapi","summary":"This OpenAPI 3.1 document","tags":["Meta"],"responses":{"200":{"description":"The OpenAPI description.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message."},"details":{"description":"Optional structured detail."}},"required":["error"]},"CitedResult":{"type":"object","description":"Calculation result. Shape varies by endpoint, but every result carries the citation envelope fields below alongside the calculator's own numbers.","properties":{"calculator":{"type":"string","description":"The endpoint name."},"inputs":{"type":"object","description":"The parsed, normalized inputs the result was computed from."},"source":{"type":"string","description":"The formula and published reference behind the number."},"canonical_url":{"type":"string","format":"uri","description":"The matching myplate.food page."},"disclaimer":{"type":"string","description":"Present on health calculators."}},"required":["calculator","source","canonical_url"],"additionalProperties":true}}}}