{
  "openapi": "3.0.3",
  "info": {
    "title": "Fitness and Health Calculator API",
    "version": "1.5.1",
    "description": "BMI, body fat, BMR, TDEE and macros, ideal weight, water intake and pregnancy due date with citations. Validated health and fitness formulas with the working and citations in the response: BMI with WHO class, BMI Prime, waist-to-height ratio and target weight; body fat by the US Navy method with ACE categories; BMR and TDEE by Mifflin-St Jeor with cut and bulk targets and optional macros; ideal weight; daily water intake; and a due date by Naegele's rule with gestational age. General information, not medical advice. Nothing you send is stored. One X-API-Key header authenticates every call, and the same key works across every FreeDailyPro API. Every 4xx response is documented and none of them is billed.",
    "contact": {
      "name": "FreeDailyPro",
      "url": "https://www.freedailypro.com/developers",
      "email": "support@freedailypro.com"
    },
    "termsOfService": "https://www.freedailypro.com/terms",
    "x-logo": {
      "url": "https://www.freedailypro.com/favicon.ico"
    }
  },
  "servers": [
    {
      "url": "https://api.freedailypro.com",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "Developer hub, plans and MCP setup",
    "url": "https://www.freedailypro.com/developers"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "Fitness & Health",
      "description": "BMI, body fat, BMR, TDEE and macros, ideal weight, water intake and pregnancy due date with citations."
    }
  ],
  "paths": {
    "/v1/converters/bmi": {
      "post": {
        "summary": "Calculate BMI, category, BMI Prime, Ponderal Index, WHO class, waist-to-height ratio and target weight in metric or imperial units",
        "operationId": "convertersBmi",
        "description": "Send 'weight' and 'height' (metric kg and cm by default, or 'unit': imperial for pounds and inches). Returns 'bmi' (one decimal) and 'category' as before, plus 'bmiPrime' (BMI / 25), 'ponderalIndex' (kg per m3), 'whoClass' and 'whoRange' (the eight-class WHO adult table), 'healthyWeightRange' (BMI 18.5 to 24.9 at this height) and a 'steps' array that shows the working. Optional 'waist' (same units as height) adds 'waistToHeightRatio', its band and a note. Optional 'targetBmi' (10 to 60) or 'targetBmiPrime' adds 'target': the weight that gives that BMI at this height and the change from now (negative means lose). Who calls it: health, fitness and nutrition apps, telehealth intake forms, wellness and insurance onboarding flows, workplace wellbeing dashboards, and chatbots or MCP agents. Worked examples: {\"weight\":72.57,\"height\":177.8} returns bmi 23, bmiPrime 0.92, ponderalIndex 12.9 and whoClass 'Normal range'; {\"weight\":90,\"height\":180,\"targetBmi\":24.9} returns target.targetWeightKg 80.7 and changeKg -9.3; {\"weight\":70,\"height\":170,\"waist\":85} returns waistToHeightRatio 0.5. Integration scenario: an onboarding form collects height, weight and waist and shows the person their BMI class, their ratio and the weight range for their height in one call, with the working behind each figure. Sources: WHO adult BMI classification (WHO Technical Report Series 894, 2000); BMI Prime and Ponderal Index are the standard definitions (BMI / 25 and kg / m3); the waist-to-height bands (0.4 and 0.5 and 0.6) are the common 0.5 guideline. These are the same functions the FreeDailyPro website calculator runs. BMI is a screening number, not a diagnosis, and it does not apply to children and teenagers: this endpoint gives adult figures only and does not provide child or teen percentiles. Weight outside 2 to 700 kg, height outside 50 to 272 cm (inches 20 to 107), a waist outside 10 to 300 cm, a target BMI outside 10 to 60, or both targetBmi and targetBmiPrime are rejected with a 400 and a plain-words message. Nothing to update: the class table is fixed by WHO. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "weight": {
                    "type": "number",
                    "description": "Weight in kg (metric) or pounds (imperial). Metric 2 to 700 kg, imperial 4 to 1500 lb.",
                    "minimum": 0
                  },
                  "height": {
                    "type": "number",
                    "description": "Height in cm (metric) or inches (imperial). Metric 50 to 272 cm, imperial 20 to 107 in.",
                    "minimum": 0
                  },
                  "unit": {
                    "description": "metric (kg and cm, the default) or imperial (lb and inches).",
                    "type": "string",
                    "enum": [
                      "metric",
                      "imperial"
                    ]
                  },
                  "waist": {
                    "description": "Optional waist in cm (metric) or inches (imperial). Adds the waist-to-height ratio and its band.",
                    "type": "number",
                    "minimum": 0
                  },
                  "targetBmi": {
                    "description": "Optional target BMI (10 to 60). Adds the weight that gives it at this height and the change from now.",
                    "type": "number",
                    "minimum": 0
                  },
                  "targetBmiPrime": {
                    "description": "Optional target BMI Prime (target BMI / 25). Send this or targetBmi, not both.",
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "weight",
                  "height"
                ],
                "additionalProperties": false
              },
              "example": {
                "weight": 70,
                "height": 175,
                "unit": "metric"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Bmi calculator client and server side from freedailypro",
                  "result": {
                    "bmi": 22.9,
                    "category": "Normal",
                    "bmiPrime": 0.91,
                    "ponderalIndex": 13.1,
                    "whoClass": "Normal range",
                    "whoRange": "18.5 to 24.99",
                    "healthyWeightRange": {
                      "lowKg": 56.7,
                      "highKg": 76.3
                    },
                    "steps": [
                      {
                        "label": "Height in metres",
                        "formula": "height in cm / 100",
                        "inputs": {
                          "cm": 175
                        },
                        "result": 1.75
                      },
                      {
                        "label": "BMI",
                        "formula": "weight in kg / (height in m)^2",
                        "inputs": {
                          "weight": "70.0 kg",
                          "height": "1.75 m"
                        },
                        "result": "22.9"
                      },
                      {
                        "label": "BMI Prime",
                        "formula": "BMI / 25",
                        "inputs": {
                          "BMI": "22.9"
                        },
                        "result": "0.91"
                      },
                      {
                        "label": "Ponderal Index",
                        "formula": "weight in kg / (height in m)^3",
                        "inputs": {
                          "weight": "70.0 kg",
                          "height": "1.75 m"
                        },
                        "result": "13.1 kg/m3"
                      },
                      {
                        "label": "WHO class",
                        "formula": "the WHO adult BMI table row that contains the BMI",
                        "inputs": {
                          "BMI": "22.9"
                        },
                        "result": "Normal range (18.5 to 24.99)"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or non-positive weight or height, a value outside the measurable range, a target BMI outside 10 to 60, or both targetBmi and targetBmiPrime; the body says which field Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/water-intake": {
      "post": {
        "summary": "Estimate daily water intake from body weight and activity level",
        "operationId": "convertersWaterIntake",
        "description": "Estimate daily water intake from body weight and activity level. Send JSON with weightKg (required); optional: activityLevel. Returns JSON with liters, milliliters, ounces, glassesApprox (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "weightKg": {
                    "type": "number",
                    "minimum": 0
                  },
                  "activityLevel": {
                    "type": "string",
                    "enum": [
                      "sedentary",
                      "light",
                      "moderate",
                      "active"
                    ]
                  }
                },
                "required": [
                  "weightKg"
                ],
                "additionalProperties": false
              },
              "example": {
                "weightKg": 68,
                "activityLevel": "moderate"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Water intake calculator client and server side from freedailypro",
                  "result": {
                    "liters": 2.38,
                    "milliliters": 2380,
                    "ounces": 80.5,
                    "glassesApprox": 10
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/ideal-weight": {
      "post": {
        "summary": "Estimate an ideal weight range from height and sex",
        "operationId": "convertersIdealWeight",
        "description": "Estimate an ideal weight range from height and sex. Send JSON with heightCm, sex (required). Returns JSON with devineKg, robinsonKg, rangeKg (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "heightCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  }
                },
                "required": [
                  "heightCm",
                  "sex"
                ],
                "additionalProperties": false
              },
              "example": {
                "heightCm": 170,
                "sex": "female"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Ideal weight calculator client and server side from freedailypro",
                  "result": {
                    "devineKg": 61.4,
                    "robinsonKg": 60.8,
                    "rangeKg": {
                      "min": 55,
                      "max": 67.2
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/bmr": {
      "post": {
        "summary": "Calculate basal metabolic rate and daily calories from body measurements and activity",
        "operationId": "convertersBmr",
        "description": "Send 'weightKg', 'heightCm', 'ageYears', 'sex' and optionally 'activity'. By default the result is Mifflin-St Jeor exactly as before: 'bmr' and 'tdee' (BMR x the activity factor) in calories a day. Optional 'formula' (mifflin-st-jeor, harris-benedict or katch-mcardle) picks the equation; optional 'bodyFatPct' (3 to 60) switches to Katch-McArdle unless 'formula' says otherwise. When either is sent the response adds 'formula', 'formulaName', 'equation', 'citation', 'comparison' (the BMR and TDEE by every formula that can be worked out: Katch-McArdle appears only with body fat) and a 'steps' array that shows the working. Equations: Mifflin-St Jeor 10 x kg + 6.25 x cm - 5 x age + 5 (men) or - 161 (women) (Mifflin et al., Am J Clin Nutr 1990;51:241-247); Harris-Benedict as revised by Roza and Shizgal (men 88.362 + 13.397 x kg + 4.799 x cm - 5.677 x age; women 447.593 + 9.247 x kg + 3.098 x cm - 4.330 x age; Am J Clin Nutr 1984;40:168-182; coefficients checked 30 Oct 2026 against the Dutch national guideline database); Katch-McArdle 370 + 21.6 x lean body mass in kg, where lean body mass = weight x (1 - body fat %) (McArdle, Katch and Katch, Exercise Physiology; page not checked). The original 1919 Harris-Benedict constants are not offered because they were not re-checked. Who calls it: fitness and nutrition apps, coaching and gym onboarding tools, wellness dashboards, and chatbots or MCP agents. Worked examples: {\"weightKg\":75,\"heightCm\":175,\"ageYears\":30,\"sex\":\"male\",\"activity\":\"light\"} returns bmr 1699 and tdee 2336; adding \"bodyFatPct\":15 returns Katch-McArdle bmr 1747 and tdee 2402 (lean mass 63.75 kg) with Mifflin 1699 and Harris-Benedict 1763 in the comparison. Integration scenario: a coaching app asks for body fat from a scan and shows the lifter the three estimates side by side with the equation behind each. These are estimates of resting energy use in healthy adults and differ by a few percent; body fat from a scale or calipers is itself an estimate. Not medical advice. A katch-mcardle formula without bodyFatPct, or a body fat outside 3 to 60, is rejected with a 400 and a plain-words message. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "weightKg": {
                    "type": "number",
                    "minimum": 0
                  },
                  "heightCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "ageYears": {
                    "type": "number",
                    "maximum": 120,
                    "minimum": 0
                  },
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  },
                  "activity": {
                    "type": "string",
                    "enum": [
                      "sedentary",
                      "light",
                      "moderate",
                      "active",
                      "very_active"
                    ]
                  },
                  "formula": {
                    "description": "Equation to use. Default mifflin-st-jeor (or katch-mcardle when bodyFatPct is sent). harris-benedict is the 1984 Roza-Shizgal revision. katch-mcardle needs bodyFatPct.",
                    "type": "string",
                    "enum": [
                      "mifflin-st-jeor",
                      "harris-benedict",
                      "katch-mcardle"
                    ]
                  },
                  "bodyFatPct": {
                    "description": "Body fat as a percentage, 3 to 60. Switches to Katch-McArdle (370 + 21.6 x lean body mass in kg) unless formula says otherwise; the comparison then includes it.",
                    "type": "number"
                  }
                },
                "required": [
                  "weightKg",
                  "heightCm",
                  "ageYears",
                  "sex"
                ],
                "additionalProperties": false
              },
              "example": {
                "weightKg": 70,
                "heightCm": 175,
                "ageYears": 35,
                "sex": "male",
                "activity": "moderate"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Bmr calorie calculator client and server side from freedailypro",
                  "result": {
                    "bmr": 1624,
                    "tdee": 2517,
                    "activity": "moderate"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Katch-McArdle requested without bodyFatPct, a bodyFatPct outside 3 to 60, an unknown formula, or the usual missing or non-positive body measurements; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/pregnancy-due-date": {
      "post": {
        "summary": "Estimate a due date and gestational age from the last menstrual period",
        "operationId": "convertersPregnancyDueDate",
        "description": "Send 'lastMenstrualPeriod' (YYYY-MM-DD) and optionally 'referenceDate' (default today) and 'cycleLengthDays' (20 to 45; Naegele's rule assumes 28, and a longer or shorter cycle moves the due date by the difference). Returns 'dueDate' (LMP + 280 days, plus the cycle adjustment), 'gestationalAgeDays', 'gestationalWeeks', 'gestationalDaysRemainder', 'trimester', 'cycleAdjustmentDays', 'method' and 'citation' (ACOG Committee Opinion No. 700, Methods for Estimating the Due Date, 2017; only about 4% of babies arrive on the estimated date and early ultrasound dating is the clinical standard). Who calls it: pregnancy and parenting apps, clinic and doula intake forms, wellness tools, chatbots and MCP agents. Worked example: {\"lastMenstrualPeriod\":\"2026-01-10\"} returns 2026-10-17; with cycleLengthDays 32 it returns 2026-10-21. Pure date arithmetic, nothing to update. Not medical advice. No customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lastMenstrualPeriod": {
                    "type": "string"
                  },
                  "referenceDate": {
                    "type": "string"
                  },
                  "cycleLengthDays": {
                    "description": "Average cycle length in days (default 28). Naegele's rule assumes 28; a longer or shorter cycle moves the due date by the difference.",
                    "type": "integer",
                    "minimum": 20,
                    "maximum": 45
                  }
                },
                "required": [
                  "lastMenstrualPeriod"
                ],
                "additionalProperties": false
              },
              "example": {
                "lastMenstrualPeriod": "2026-03-01",
                "referenceDate": "2026-10-30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Pregnancy due date calculator client and server side from freedailypro",
                  "dueDate": "2026-12-06",
                  "gestationalAgeDays": 243,
                  "gestationalWeeks": 34,
                  "gestationalDaysRemainder": 5,
                  "trimester": 3
                }
              }
            }
          },
          "400": {
            "description": "A missing lastMenstrualPeriod or a cycleLengthDays outside 20 to 45. An unreadable date comes back as 200 with an 'error' field, as before Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/body-fat": {
      "post": {
        "summary": "Estimate body fat percentage from tape measurements (US Navy method)",
        "operationId": "convertersBodyFat",
        "description": "Send 'sex', 'heightCm', 'waistCm', 'neckCm' and, for women, 'hipCm' (all in centimetres); add 'weightKg' to get 'fatMassKg' and 'leanMassKg'. Returns 'bodyFatPercent', 'category' (the American College of Exercise bands, listed in 'categoryScheme'), 'method' and 'citation': Hodgdon and Beckett, Naval Health Research Center reports 84-11 and 84-29 (1984), with the usual accuracy of about 3 to 4 percentage points; it is an estimate, not a DEXA scan. Who calls it: fitness and coaching apps, gym and clinic intake tools, wellness dashboards, chatbots and MCP agents. Worked example: {\"sex\":\"male\",\"heightCm\":180,\"waistCm\":90,\"neckCm\":38,\"weightKg\":80} returns 19.8% (Average), fat mass 15.84 kg and lean mass 64.16 kg (checked against the published formula in Python). Integration scenario: an intake form sends the three tape measurements and shows the category with the citation beside it. Pure formula, nothing to update. Not medical advice. No customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  },
                  "heightCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "waistCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "neckCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "hipCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "weightKg": {
                    "description": "Optional body weight in kg; adds fatMassKg and leanMassKg to the result.",
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "sex",
                  "heightCm",
                  "waistCm",
                  "neckCm"
                ],
                "additionalProperties": false
              },
              "example": {
                "sex": "male",
                "heightCm": 180,
                "waistCm": 88,
                "neckCm": 38
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Body fat calculator client and server side from freedailypro",
                  "bodyFatPercent": 18.4,
                  "category": "Average"
                }
              }
            }
          },
          "400": {
            "description": "A missing or non-numeric measurement or an unknown sex. Calculation problems (a missing hipCm for women, a non-positive value) come back as 200 with an 'error' field, as before Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/tdee": {
      "post": {
        "summary": "Calculate total daily energy expenditure with cut and bulk calorie targets",
        "operationId": "convertersTdee",
        "description": "Send 'sex', 'age', 'weightKg', 'heightCm' and optionally 'activity'. The response is 'bmr' (Mifflin-St Jeor, Am J Clin Nutr 1990;51:241-247), 'tdee' (BMR x the activity factor), 'cut' (tdee - 500) and 'bulk' (tdee + 300), in calories a day; these are unchanged. Optional weekly cycling: send 'highDays' (1 to 3 higher days a week), and optionally 'swingPct' (how far above the daily target the higher days sit, 1 to 30, default 15) and 'cycleGoal' (maintain, cut or bulk; default maintain). The response then adds 'cycle' (dailyTarget, highKcal, lowKcal, the seven days, weeklyTotal, appliedSwingPct, limitedByFloor and safeMinimum) and a 'steps' array that shows the working. The weekly total is always the daily target x 7, so cycling changes when the calories are eaten, not how many. A lower day is never set under the safe minimum (1500 men, 1200 women; this app's long-standing floor, not re-checked against a published guideline); when the swing would break it the swing is reduced and limitedByFloor is true, and a target too close to the minimum is rejected with a 400. Note that 'cut' here is a plain 500 under maintenance with no 25 percent cap; the website calculator applies the cap and merges loss tiers that read the same. Who calls it: fitness and meal-planning apps, coaching dashboards, wellness chatbots and MCP agents. Worked example: {\"sex\":\"male\",\"age\":30,\"weightKg\":75,\"heightCm\":175,\"activity\":\"light\",\"highDays\":2,\"swingPct\":15} returns tdee 2336, two days at 2686 and five at 2196, week total 16352. Integration scenario: a meal-planning app turns one daily number into a seven-day plan with the same weekly calories. An estimate for healthy adults, not medical advice. Macros: send 'macroGoal' (lose, maintain or gain) to add 'macros': grams of protein, carbohydrate and fat for the matching calorie target (lose = cut, maintain = TDEE, gain = bulk), using the website's 35/35/30, 30/40/30 and 30/45/25 protein/carb/fat splits at 4, 4 and 9 kcal per gram, with 'withinAmdr' flags against the Institute of Medicine ranges (protein 10-35%, carbohydrate 45-65%, fat 20-35% of calories, DRI 2005). A 2,759 kcal maintenance target gives 207 g protein, 276 g carbohydrate and 92 g fat. The response also carries 'method' naming the formula, the activity factors and the cut and bulk rules. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  },
                  "age": {
                    "type": "number"
                  },
                  "weightKg": {
                    "type": "number"
                  },
                  "heightCm": {
                    "type": "number"
                  },
                  "activity": {
                    "type": "string",
                    "enum": [
                      "sedentary",
                      "light",
                      "moderate",
                      "active",
                      "veryActive"
                    ]
                  },
                  "highDays": {
                    "description": "Weekly calorie cycling: how many higher-calorie days a week (1 to 3).",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 3
                  },
                  "swingPct": {
                    "description": "How far above the daily target the higher days sit, in percent. Default 15.",
                    "type": "number",
                    "minimum": 1,
                    "maximum": 30
                  },
                  "cycleGoal": {
                    "description": "Which daily target to spread over the week. Default maintain.",
                    "type": "string",
                    "enum": [
                      "maintain",
                      "cut",
                      "bulk"
                    ]
                  },
                  "macroGoal": {
                    "description": "Adds a macros block: grams of protein, carbohydrate and fat for the matching calorie target (lose = cut, maintain = TDEE, gain = bulk), the percentage split, and whether each share sits inside the Institute of Medicine AMDR ranges.",
                    "type": "string",
                    "enum": [
                      "lose",
                      "maintain",
                      "gain"
                    ]
                  }
                },
                "required": [
                  "sex",
                  "age",
                  "weightKg",
                  "heightCm"
                ],
                "additionalProperties": false
              },
              "example": {
                "sex": "female",
                "age": 32,
                "weightKg": 62,
                "heightCm": 168,
                "activity": "light"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Calorie TDEE calculator client and server side from freedailypro",
                  "result": {
                    "bmr": 1349,
                    "tdee": 1855,
                    "cut": 1355,
                    "bulk": 2155
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or non-positive body measurements, highDays outside 1 to 3, a swingPct outside 1 to 30, or a target too close to the safe minimum for a cycling plan; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    }
  }
}