{"openapi":"3.1.0","info":{"title":"BMI & Body Composition API","version":"1.0.0","description":"Body-composition maths as an API, computed locally and deterministically. The bmi endpoint computes the body mass index, BMI = weight/height², classifies it on the WHO scale (underweight, normal, overweight, obese) and returns the healthy weight range for the person's height. The idealweight endpoint computes the ideal body weight by the four classic formulas — Devine, Robinson, Miller and Hamwi — each a base weight plus an increment for every inch of height above five feet, and their average. The bodyfat endpoint estimates body-fat percentage by the US Navy circumference method from the neck and waist (and hip for women) and the height, classifies it from essential to high, and — given a weight — splits it into fat mass and lean mass. Everything is computed locally and deterministically, so it is instant and private. Ideal for fitness, health and wellness app developers, body-tracking and coaching tools, gym and clinic dashboards, and self-assessment apps. Pure local computation — no key, no third-party service, instant. Live, nothing stored. Estimates only, not medical advice. 3 endpoints. This is body composition; for basal metabolic rate and calories use a BMR API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bmi-api","description":"oanor gateway"}],"tags":[{"name":"Body"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/bmi":{"get":{"operationId":"get_v1_bmi","tags":["Body"],"summary":"Body mass index","description":"","parameters":[{"name":"weight","in":"query","required":true,"description":"Weight (kg)","schema":{"type":"string"},"example":"80"},{"name":"height","in":"query","required":true,"description":"Height (cm)","schema":{"type":"string"},"example":"180"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"bmi":24.69,"note":"BMI = kg/m². WHO bands: <18.5 underweight, 18.5–24.9 normal, 25–29.9 overweight, ≥30 obese.","inputs":{"height":180,"weight":80},"category":"normal","healthy_weight_max_kg":80.68,"healthy_weight_min_kg":59.94},"meta":{"timestamp":"2026-06-04T18:38:21.571Z","request_id":"ba38788d-8863-4ff9-93ec-675b7b45dfa8"},"status":"ok","message":"Body mass index","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/bodyfat":{"get":{"operationId":"get_v1_bodyfat","tags":["Body"],"summary":"Body-fat percentage","description":"","parameters":[{"name":"sex","in":"query","required":true,"description":"male | female","schema":{"type":"string"},"example":"male"},{"name":"height","in":"query","required":true,"description":"Height (cm)","schema":{"type":"string"},"example":"180"},{"name":"neck","in":"query","required":true,"description":"Neck circumference (cm)","schema":{"type":"string"},"example":"40"},{"name":"waist","in":"query","required":true,"description":"Waist circumference (cm)","schema":{"type":"string"},"example":"90"},{"name":"hip","in":"query","required":false,"description":"Hip circumference (cm, women)","schema":{"type":"string"}},{"name":"weight","in":"query","required":false,"description":"Weight (kg) for fat/lean mass","schema":{"type":"string"},"example":"80"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"US Navy circumference method (metric). Measurements in cm. An estimate — calipers or DEXA are more accurate.","inputs":{"sex":"male","neck":40,"waist":90,"height":180},"category":"average","fat_mass_kg":14.69,"lean_mass_kg":65.31,"body_fat_percent":18.37},"meta":{"timestamp":"2026-06-04T18:38:21.676Z","request_id":"cee46a31-db3c-4ad2-adba-053b122c33ed"},"status":"ok","message":"Body fat percentage","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/idealweight":{"get":{"operationId":"get_v1_idealweight","tags":["Body"],"summary":"Ideal body weight","description":"","parameters":[{"name":"height","in":"query","required":true,"description":"Height (cm)","schema":{"type":"string"},"example":"180"},{"name":"sex","in":"query","required":true,"description":"male | female","schema":{"type":"string"},"example":"male"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Classic ideal-body-weight formulas, each = base + increment per inch of height above 5 ft (152.4 cm).","inputs":{"sex":"male","height":180},"hamwi_kg":77.34,"devine_kg":74.99,"miller_kg":71.52,"average_kg":74.12,"robinson_kg":72.65},"meta":{"timestamp":"2026-06-04T18:38:21.793Z","request_id":"4b7d74a7-f5a0-4281-84f3-7a34cb08e819"},"status":"ok","message":"Ideal weight","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Weight in kg, height/girths in cm. Body-fat needs neck and waist (and hip for women). Estimates only — not medical advice.","service":"bmi-api","formulae":{"bmi":"BMI = kg/m²","ideal_weight":"base + increment·(inches over 5 ft)","navy_bodyfat_male":"495/(1.0324 − 0.19077·log10(waist−neck) + 0.15456·log10(height)) − 450"},"endpoints":{"GET /v1/bmi":"BMI = kg/m² with WHO category and the healthy weight range for the height.","GET /v1/meta":"This document.","GET /v1/bodyfat":"US Navy body-fat percentage from girth measurements, with lean/fat mass.","GET /v1/idealweight":"Ideal body weight by the Devine, Robinson, Miller and Hamwi formulas."},"description":"Body-composition calculator: body mass index, ideal body weight (four formulas) and US Navy body-fat percentage."},"meta":{"timestamp":"2026-06-04T18:38:21.902Z","request_id":"c5a225bf-6753-459e-a580-fb206bd38fc2"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":400,"monthly_call_quota":40000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1200,"monthly_call_quota":250000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3900,"monthly_call_quota":1500000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bmi-api"}