UnifyUnitsDevelopers

GET/v1/convertRequires API key

Single conversion via query parameters

Converts one measurement value from a source unit to a target unit. All three query parameters are required.

Parameters

Name	Type	Required	Description
`value`	string	Yes	Measurement value as a decimal string (e.g. "10.5")
`from`	string	Yes	Source unit identifier (e.g. "kg")
`to`	string	Yes	Target unit identifier (e.g. "lb")

Possible errors

INVALID_VALUE · UNKNOWN_UNIT · AMBIGUOUS_UNIT · INCOMPATIBLE_UNITS · OUT_OF_RANGE · UNAUTHORIZED · INVALID_API_KEY · RATE_LIMIT_EXCEEDED

All endpoints · Error reference

cURL

curl "https://api.unifyunits.com/v1/convert?value=10&from=kg&to=lb" \
  -H "Authorization: Bearer $UNIFYUNITS_API_KEY"

Response 200

json

{
  "data": {
    "input": { "value": "10", "unit": "kg" },
    "result": {
      "value": "22.04622621848775807229738013450270338542",
      "unit": "lb"
    },
    "category": "mass"
  }
}