This API provides accurate **health and fitness calculations** including **BMI**, **BMR**, **TDEE**, **daily calorie needs**, **ideal weight**, **body fat estimation**, **lean body mass**, **hydration needs**, and **macronutrient breakdown** using basic personal inputs.

Getting Started

To begin using this API, follow these steps and make your first API call: **Subscribe to a plan:** Visit our Pricing page and subscribe to one of the plans. If you are just starting, you can subscribe to the free BASIC plan of the API (hard-limited and no credit card required). **Make your first API call:** Visit the RapidAPI Playground — the Health Calculator endpoint should be selected and displayed on the main panel view. Since there are default query parameter values, simply click the blue **“Test endpoint”** button to make your first API call. The JSON response will be displayed on the right panel. **Documentation and Resources:** Refer to the detailed endpoint descriptions, input parameters, and response examples provided in the Endpoints tab. Code snippets are available for popular programming languages including JavaScript, Python, Java, Shell, and more to help you quickly integrate the API. You should be good to go now!

Authentication

To authenticate with the API, send the **X-RapidAPI-Host** header along with the **X-RapidAPI-Key** header set to your RapidAPI App API Key (as shown in the endpoint Code Snippets).

Input Parameters

The following query parameters are supported by the API: **height** (required) Height of the user in centimeters. Example: `175` **weight** (required) Weight of the user in kilograms. Example: `70` **age** (required) Age in years. Example: `25` **gender** (required) Gender of the user. Supported values: `male`, `female` **activity_level** (optional) Physical activity level used for TDEE calculation. Default: `moderate` Supported values: | Value | Description | | ----------- | --------------------------------- | | sedentary | Little or no exercise | | light | Light exercise (1–3 days/week) | | moderate | Moderate exercise (3–5 days/week) | | active | Hard exercise (6–7 days/week) | | very_active | Very intense exercise | **goal** (optional) Calorie goal preference. Default: `maintain` Supported values: * `lose` * `maintain` * `gain`

Response Structure

Here’s an example of a successful response: ``` { "success": true, "input": { "height_cm": 175, "weight_kg": 70, "age": 25, "gender": "male", "activity_level": "moderate", "goal": "maintain" }, "calculations": { "bmi": { "value": 22.86, "category": "Normal" }, "bmr": 1674, "tdee": 2594, "daily_calories": { "lose_weight": 2094, "maintain_weight": 2594, "gain_weight": 3094 }, "ideal_weight_kg": 72, "body_fat_percentage": 18.2, "lean_body_mass_kg": 57.3, "daily_water_intake_liters": 2.8, "macros": { "protein_g": 130, "carbs_g": 290, "fats_g": 75 } } } ``` Please note that some errors might be returned by the RapidAPI gateway and will have a different structure. Please refer to the Error Handling / Error Response Structure section for more details. In addition, RapidAPI gateway adds several headers to each response. For more information, please refer to [https://docs.rapidapi.com/docs/response-headers](https://docs.rapidapi.com/docs/response-headers).

Endpoints

For detailed endpoint parameters, response fields, and live testing, please refer to the **Endpoints** section of this API.

Rate Limiting

Each subscription plan defines the maximum number of requests permitted per month, along with a rate limit expressed in RPS (Requests Per Second). All free plans (such as BASIC) are limited to **1000 requests per hour**, as required by RapidAPI.

Rate Limits Headers

All API responses include the following rate limit headers: **x-ratelimit-requests-limit:** Total number of requests allowed by your subscription. **x-ratelimit-requests-remaining:** Remaining requests before reaching the quota limit. **x-ratelimit-requests-reset:** Time in seconds until the quota resets.

Handling Limits

When rate limits are exceeded, the API will return a **429 Too Many Requests** error. ``` { "message": "Too many requests" } ``` Wait until the limit resets or upgrade your subscription plan for higher limits.

Code Examples

Code examples for JavaScript, Python, Java, Shell, and other popular languages are available in the **Endpoints** tab under **Code Snippets**.

Common HTTP Status Codes

**400 Bad Request:** Missing or invalid parameters **403 Forbidden:** Invalid API key or no active subscription **404 Not Found:** Invalid endpoint **429 Too Many Requests:** Rate limit exceeded **5XX Server Error:** Temporary server-side issue

Support

If you encounter any issues or need clarification, please contact us with the error code, message, and request context, and we will assist you promptly.

Contact Us

For custom plans, enterprise usage, or high-volume requests: **Email:** [alreadycoded@gmail.com](mailto:alreadycoded@gmail.com) **Website:** [https://www.alreadycoded.com](https://www.alreadycoded.com)