UnifyUnits Developers
GET /v1/units/:unit Public

Get metadata for a single unit

Returns full metadata for one canonical unit identifier or accepted unambiguous alias.

Prefer a language client when available: JavaScript / TypeScript, Python, or PHP (Laravel). Samples on this page stay raw HTTP so they match the OpenAPI contract.

Parameters

Name Type Required Description
unit string Yes Canonical unit id or unambiguous alias (path)

Possible errors

UNKNOWN_UNIT · AMBIGUOUS_UNIT · INVALID_REQUEST · RATE_LIMIT_EXCEEDED

All endpoints · Error reference

cURL
curl "https://api.unifyunits.com/v1/units/kg"

Response 200

json
{
  "data": {
    "id": "kg",
    "name": "Kilogram",
    "category": "mass",
    "aliases": ["kilograms", "kilo", "kilos"],
    "verification": "legacy",
    "factor": "1"
  }
}