Skip to content
GET /v1/heat-pump

Heat-pump electricity and cost

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/poolheat-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/poolheat-api/v1/heat-pump" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/poolheat-api/v1/heat-pump", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/poolheat-api/v1/heat-pump");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/poolheat-api/v1/heat-pump",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "cost": 13.33,
        "note": "A heat-pump heater moves more heat than it consumes: electricity = thermal BTU ÷ 3412 ÷ the COP (typically 5–6 for pool units in mild weather, less in the cold). It is far cheaper to run than gas or resistance heat but heats slowly, so it suits holding temperature, not a fast warm-up.",
        "inputs": {
            "cop": 5.5,
            "temp_rise_f": 10,
            "volume_gallons": 20000
        },
        "total_btu": 1668000,
        "electricity_kwh": 88.88
    },
    "meta": {
        "timestamp": "2026-06-06T15:30:43.771Z",
        "request_id": "75752aa7-ca79-485a-87d5-a69611dc2174"
    },
    "status": "ok",
    "message": "Heat pump",
    "success": true
}