API reference
Base URL: https://api.unifyunits.com
All responses use Content-Type: application/json.
Values are always decimal strings. Every response includes an
X-Request-Id header.
| Method | Path | Auth | Summary |
|---|---|---|---|
| GET |
/v1/convert
|
Bearer | Single conversion via query parameters |
| POST |
/v1/convert
|
Bearer | Single conversion via JSON body |
| POST |
/v1/batch
|
Bearer | Convert up to 100 measurements in one request |
| POST |
/v1/parse
|
Bearer | Parse a written measurement |
| POST |
/v1/currency/convert
|
Bearer | Convert between currencies |
| GET |
/v1/currency/convert
|
Bearer | Convert between currencies via query parameters |
| GET |
/v1/currency/rates
|
Bearer | List currency rates |
| GET |
/v1/currency/rates/latest
|
Public | Latest currency rates without an API key |
| POST |
/v1/normalize
|
Bearer | Normalize a messy quantity |
| GET |
/v1/substances
|
Bearer | List substances |
| POST |
/v1/substance/convert
|
Bearer | Convert between mass and volume for a substance |
| GET |
/v1/substance/convert
|
Bearer | Convert between mass and volume via query parameters |
| POST |
/v1/unit-price
|
Bearer | Compare offers by price per unit |
| GET |
/v1/categories
|
Public | List all measurement categories |
| GET |
/v1/categories/:category
|
Public | Get a single category with its units |
| GET |
/v1/units
|
Public | List all supported units |
| GET |
/v1/units/:unit
|
Public | Get metadata for a single unit |
| GET |
/v1/health
|
Public | Service health check |
| GET |
/openapi.json
|
Public | OpenAPI 3.1 specification |
Also see errors and the live OpenAPI 3.1 contract.