Sperm analysis calculator

This sperm analysis calculator accepts the four laboratory values, compares each one with the 2021 lower reference limit, and labels it normal or below_reference. Volume below zero is rejected as invalid_input because a negative ejaculate volume is not a physical measurement.

WHO 2021 lower reference limits and how each status is assigned

Each parameter is labelled normal when the submitted value is greater than or equal to its lower reference limit, and below_reference when it is strictly smaller. Treat the JSON as an educational comparison against a named public table, not as a medical-device output or a substitute for a laboratory report reviewed by a clinician who knows the rest of the history.

Input contract, response shape, and error behaviour

A classic smoke check is volume two point five millilitres, concentration forty-five million per millilitre, motility fifty-five percent, and morphology eight percent, which is normal on every row including the derived total. POST a JSON body with four required finite numbers. The field volume is semen volume in millilitres and must be zero or greater; aliases volume_ml, semen_volume, and ejaculate_volume are accepted. A negative volume fails with invalid_input and the message that volume cannot be negative, and that failure is not billed. Zero millilitres is a legal input and is labelled below_reference against the one-point-four millilitre limit. The field concentration is sperm concentration in million spermatozoa per millilitre and must be a finite non-negative number; aliases sperm_concentration, concentration_million_per_ml, and count are accepted. The field motility is total motility as a percentage from zero to one hundred; aliases total_motility, motility_percent, and motility_pct are accepted. The field morphology is the percentage of spermatozoa with normal forms, also from zero to one hundred; aliases morphology_percent, normal_forms, and kruger are accepted. Each numeric field may arrive as a JSON number or as a numeric string. Missing fields, empty strings, booleans, NaN, and Infinity fail with invalid_input naming the field. On success the body echoes the four values with their WHO 2021 limits and a status of normal or below_reference for each, plus derived total_sperm, total_sperm_limit, and total_sperm_status. below_reference_count is how many of the four submitted parameters sit below their limits, and overall is normal only when that count is zero. Pair the JSON with your own counselling notes if you need narrative; this endpoint only classifies the four numbers against the named table.

Where a WHO 2021 sperm analysis check is used, pricing, and honest limits

Exam generators and LMS plugins need a deterministic engine that rejects a negative semen volume instead of silently emitting a status that a buggy grader might treat as success. Product teams building educational reproductive-health widgets want a documented WHO 2021 path that students can audit by hand, rather than a black-box fertility score that mixes vitality, DNA fragmentation, and progressive motility without disclosure. Keep expectations educational: this is a calculation and learning tool, not a diagnostic medical device, and it does not replace a reviewed semen analysis, a specialist interpretation, or local laboratory methods. People with a fertility concern should follow professional medical advice rather than any single automated comparison. Andrology teaching labs and reproductive-medicine clerkships constantly assign worksheets that ask whether a printed semen report meets current WHO lower reference limits, so a single trusted oracle that returns normal or below_reference beside each limit speeds grading and demo setup. Fertility-clinic intake forms that already store volume, concentration, motility, and morphology can call a tiny parse API instead of reimplementing the 2021 table in every spreadsheet language, which is how 2010 figures quietly survive in old templates. Because this capability is a pure parse engine, every successful API call costs the published $0.002 base price with no model tokens and no outbound network, and failed validation does not consume prepaid balance. Pin overall and the four status fields in tests, send total motility rather than progressive motility alone, and never treat a below_reference label on one parameter as a diagnosis of male-factor infertility.