Skip to content

Conversion ​

The /convert endpoint allows you to convert multiple temperature units between each other. You need to provide a value to convert, a source unit, and the unit you want to convert to.

Parameters ​

ParameterRequiredDescription
valueYesThe value to convert
fromYesThe source unit (celsius, fahrenheit, or kelvin)
toYesThe unit to convert to (celsius, fahrenheit, or kelvin)

Available Units ​

UnitDescription
celsiusTemperature in Celsius degrees
fahrenheitTemperature in Fahrenheit degrees
kelvinTemperature in Kelvin

Request Example ​

GET /v1/convert?value=30&from=celsius&to=kelvin

Response ​

json
{
    "from": "celsius",
    "to": "kelvin",
    "value": 30,
    "result": 303.15
}

cURL ​

bash
curl -X GET "https://api.sylvain.sh/v1/convert?value=30&from=celsius&to=kelvin"

Error Handling ​

If the value, from, or to field is empty or invalid, an error will be returned.