---
title: "Weight-loss percentage"
method: GET
path: "/calculate/weight-loss-percentage"
tags: ["Guideline tools"]
---

# Weight-loss percentage

`GET /calculate/weight-loss-percentage`

## Request

- Base URL: `https://myplate.food/api/v1`
- URL: `https://myplate.food/api/v1/calculate/weight-loss-percentage`
- Auth: none declared

Percentage of starting body weight lost (or gained), against the NHLBI/USPSTF 5–10% clinically-meaningful thresholds.

Cites its source in every response: `source` (the formula + published reference) and `canonical_url` (https://myplate.food/weight-loss-percentage-calculator), plus a `disclaimer`.

## Query parameters

- `unit` 'metric' | 'imperial'
- `start_weight` number, required
- `current_weight` number, required

## Response `200`

Calculation result with citation envelope.

- CitedResult: Calculation result. Shape varies by endpoint, but every result carries the citation envelope fields below alongside the calculator's own numbers.
  - `calculator` string, required: The endpoint name.
  - `inputs` object: The parsed, normalized inputs the result was computed from.
  - `source` string, required: The formula and published reference behind the number.
  - `canonical_url` string, uri, required: The matching myplate.food page.
  - `disclaimer` string: Present on health calculators.

## Other responses

- `400`: Invalid or missing parameters.

---

[API](https://skmtc.dev/myplate/apis/myplate-food-nutrition-api.md) · [All operations](https://skmtc.dev/myplate/apis/myplate-food-nutrition-api/llms.txt) · [OpenAPI document](https://skmtc.dev/myplate/apis/myplate-food-nutrition-api/revisions/cb7ba731c59b?raw)