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": "2025-01-10T17:02:02.226Z",
  "created_at": "2025-01-10T17:02:02.226Z",
  "error": "jGL1TGqDh5suYHNHMfglkW368",
  "id": "5daa12bc-bd05-4a28-8cc0-b90a60d57d1e",
  "input": 31,
  "input_unit": "electronvolts",
  "output": 6,
  "output_unit": "btu",
  "started_at": "2025-01-10T17:02:02.226Z",
  "status": "in_progress",
  "updated_at": "2025-01-10T17:02:02.226Z",
  "user_id": "971f2510-4e0f-49d8-a823-2a82ad465d8d"
}