Sign up

API → Unit → Convert energy units

Parameters

Name

Type

Req.

  • input_unit

    string
    required
    Possible values
    • btu:  British Thermal Unit (BTU) <https://en.wikipedia.org/wiki/British_thermal_unit>
    • electronvolts:  Electron Volts (eV) <https://en.wikipedia.org/wiki/Electronvolt>
    • joules:  Joules (or watt-seconds) <https://en.wikipedia.org/wiki/Joule>
    • kilocalories:  Kilocalories (often just called calories) <https://en.wikipedia.org/wiki/Kilocalorie>
    • kilowatt_hours:  Kilowatt hours (kWh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
    • watt_hours:  Watt hours (Wh) <https://en.wikipedia.org/wiki/Kilowatt-hour>

  • output_unit

    string
    required
    Possible values
    • btu:  British Thermal Unit (BTU) <https://en.wikipedia.org/wiki/British_thermal_unit>
    • electronvolts:  Electron Volts (eV) <https://en.wikipedia.org/wiki/Electronvolt>
    • joules:  Joules (or watt-seconds) <https://en.wikipedia.org/wiki/Joule>
    • kilocalories:  Kilocalories (often just called calories) <https://en.wikipedia.org/wiki/Kilocalorie>
    • kilowatt_hours:  Kilowatt hours (kWh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
    • watt_hours:  Watt hours (Wh) <https://en.wikipedia.org/wiki/Kilowatt-hour>

  • value

    number
    required

Returns

  • 200 OK

    successful operation

    Name

    Type

    Req.

    body

    object
    optional
    Object Properties

    • completed_at

      string / ISO-8601
      optional

    • created_at

      string / ISO-8601
      optional

    • error

      string
      optional

    • id

      string / UUID
      optional

    • input

      number
      optional

    • input_unit

      string
      optional
      Possible values
      • btu:  British Thermal Unit (BTU) <https://en.wikipedia.org/wiki/British_thermal_unit>
      • electronvolts:  Electron Volts (eV) <https://en.wikipedia.org/wiki/Electronvolt>
      • joules:  Joules (or watt-seconds) <https://en.wikipedia.org/wiki/Joule>
      • kilocalories:  Kilocalories (often just called calories) <https://en.wikipedia.org/wiki/Kilocalorie>
      • kilowatt_hours:  Kilowatt hours (kWh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
      • watt_hours:  Watt hours (Wh) <https://en.wikipedia.org/wiki/Kilowatt-hour>

    • output

      number
      optional

    • output_unit

      string
      optional
      Possible values
      • btu:  British Thermal Unit (BTU) <https://en.wikipedia.org/wiki/British_thermal_unit>
      • electronvolts:  Electron Volts (eV) <https://en.wikipedia.org/wiki/Electronvolt>
      • joules:  Joules (or watt-seconds) <https://en.wikipedia.org/wiki/Joule>
      • kilocalories:  Kilocalories (often just called calories) <https://en.wikipedia.org/wiki/Kilocalorie>
      • kilowatt_hours:  Kilowatt hours (kWh) <https://en.wikipedia.org/wiki/Kilowatt-hour>
      • watt_hours:  Watt hours (Wh) <https://en.wikipedia.org/wiki/Kilowatt-hour>

    • started_at

      string / ISO-8601
      optional

    • status

      string
      optional
      Possible values
      • queued:  The async API call is queued.
      • uploaded:  The async API call was uploaded to be converted.
      • in_progress:  The async API call is in progress.
      • completed:  The async API call has completed.
      • failed:  The async API call has failed.

    • updated_at

      string / ISO-8601
      optional

    • user_id

      string / UUID
      optional
get
/unit/conversion/energy/{input_unit}/{output_unit}
$ curl "https://api.zoo.dev/unit/conversion/energy/{input_unit}/{output_unit}" \
	--header "Authorization: Bearer $TOKEN"
200 OK
Response
{
  "completed_at": "2024-10-11T00:34:53.497Z",
  "created_at": "2024-10-11T00:34:53.497Z",
  "error": "7jC9",
  "id": "03741876-33e3-4c2c-a35d-95770a3879a5",
  "input": 8,
  "input_unit": "kilowatt_hours",
  "output": 3,
  "output_unit": "btu",
  "started_at": "2024-10-11T00:34:53.497Z",
  "status": "queued",
  "updated_at": "2024-10-11T00:34:53.497Z",
  "user_id": "1f505162-36dd-4869-8ca3-3005587ba681"
}