Unit Conversion

The /convert endpoint allows you to convert values between units of the same category. You need to provide a value to convert, a source unit, and the target unit.

gethttps://api.moxon.dev/v5/convert

Try itget/v5/convert

curl -X GET \  "https://api.moxon.dev/v5/convert"

Send the request to see the response here.

Parameters

valuestringrequired
The numeric value to convert
fromstringrequired
The source unit (see available units below)
- celsius
- fahrenheit
- kelvin
- km
- mi
- m
- ft
- cm
- in
- yd
- kg
- lb
- oz
- g
- ton
- b
- kb
- mb
- gb
- tb
- km/h
- mph
- m/s
- knots
tostringrequired
The target unit (must be in the same category as from)
- celsius
- fahrenheit
- kelvin
- km
- mi
- m
- ft
- cm
- in
- yd
- kg
- lb
- oz
- g
- ton
- b
- kb
- mb
- gb
- tb
- km/h
- mph
- m/s
- knots

Available Units

Temperature:

Unit	Description
`celsius`	Celsius degrees
`fahrenheit`	Fahrenheit degrees
`kelvin`	Kelvin

Length:

Unit	Description
`km`	Kilometers
`mi`	Miles
`m`	Meters
`ft`	Feet
`cm`	Centimeters
`in`	Inches
`yd`	Yards

Weight:

Unit	Description
`kg`	Kilograms
`lb`	Pounds
`oz`	Ounces
`g`	Grams
`ton`	Metric tons

Data:

Unit	Description
`b`	Bytes
`kb`	Kilobytes
`mb`	Megabytes
`gb`	Gigabytes
`tb`	Terabytes

Speed:

Unit	Description
`km/h`	Kilometers/hour
`mph`	Miles/hour
`m/s`	Meters/second
`knots`	Knots

Response Fields

fromstring
Source unit
tostring
Target unit
valuenumber
Original value to convert
resultnumber
Converted value

Code Examples

curl -X GET \  "https://api.moxon.dev/v5/convert?value=100&from=km&to=mi"

Error Handling

If parameters are missing or invalid, the API will return an error:

400Please provide a valid value (?value={value})The value parameter is missing or invalid
400Please provide a valid source unit (&from={unit})The from parameter is missing or invalid
400Please provide a valid target unit (&to={unit})The to parameter is missing or invalid
400Value must be a numberThe value is not a valid number
400Invalid conversion unitThe from/to combination is not valid
400Value must be greater than absolute zeroThe value is below absolute zero (temperature only)

Edit this page on GitHub Report an issue

Last updated on May 25, 2026