{"openapi":"3.1.0","info":{"title":"HVAC BTU Calculator API","version":"1.0.0","description":"HVAC sizing maths as an API, computed locally and deterministically from standard rule-of-thumb factors. The cooling endpoint estimates the air-conditioner load for a room — in BTU per hour, tons of cooling and kilowatts — from the floor area (in square feet or metres, or length × width) using a baseline of about 20 BTU/h per square foot, with adjustments for the number of occupants, a kitchen, sun exposure and ceiling height. The heating endpoint estimates the heating load from the area and a climate zone (mild through very cold) or a custom BTU per square foot. The convert endpoint converts between BTU per hour, tons of cooling, kilowatts and watts (one ton = 12,000 BTU/h ≈ 3.517 kW). Everything is computed locally and deterministically, so it is instant and private. These are rule-of-thumb estimates in the EnergyStar style — a proper Manual J load calculation accounting for insulation, windows and local climate is recommended for a real installation. Ideal for HVAC and home-improvement tools, air-conditioner and heater sizing guides, smart-home and energy apps, and contractor quoting. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is HVAC sizing; for appliance running cost use an energy-cost API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hvac-api","description":"oanor gateway"}],"tags":[{"name":"HVAC"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["HVAC"],"summary":"BTU / ton / kW / watt","description":"","parameters":[{"name":"value","in":"query","required":true,"description":"Value","schema":{"type":"string"},"example":"12000"},{"name":"from","in":"query","required":true,"description":"btu|ton|kw|w","schema":{"type":"string"},"example":"btu"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"kw":3.5169,"note":"1 ton of cooling = 12,000 BTU/h ≈ 3.517 kW.","tons":1,"input":{"from":"btu","value":12000},"watts":3516.9,"btu_per_hour":12000},"meta":{"timestamp":"2026-06-04T01:59:18.153Z","request_id":"733f460e-15f6-47f5-a39f-d279cf3b0da9"},"status":"ok","message":"BTU / ton / kW conversion","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cooling":{"get":{"operationId":"get_v1_cooling","tags":["HVAC"],"summary":"Air-conditioner cooling load","description":"","parameters":[{"name":"area","in":"query","required":false,"description":"Room area (or length+width)","schema":{"type":"string"},"example":"300"},{"name":"area_unit","in":"query","required":false,"description":"sqft|sqm","schema":{"type":"string"},"example":"sqft"},{"name":"occupants","in":"query","required":false,"description":"People (default 2)","schema":{"type":"string"},"example":"4"},{"name":"sun_exposure","in":"query","required":false,"description":"sunny|shaded","schema":{"type":"string"}},{"name":"room_type","in":"query","required":false,"description":"kitchen adds 4000 BTU","schema":{"type":"string"}},{"name":"ceiling_height_ft","in":"query","required":false,"description":"default 8","schema":{"type":"string"},"example":"8"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Rule-of-thumb cooling load (≈20 BTU/h·ft² baseline). Estimate only — use a Manual J calculation for a real install.","input":{"area_sqft":300,"occupants":4,"btu_per_sqft":20,"ceiling_height_ft":8},"cooling_kw":2.11,"adjustments":[{"btu":1200,"factor":"occupants"}],"cooling_tons":0.6,"cooling_btu_per_hour":7200},"meta":{"timestamp":"2026-06-04T01:59:18.242Z","request_id":"1e2e0fd6-17a1-43ed-8366-795376ab0c55"},"status":"ok","message":"Cooling load","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/heating":{"get":{"operationId":"get_v1_heating","tags":["HVAC"],"summary":"Heating load by climate","description":"","parameters":[{"name":"area","in":"query","required":true,"description":"Room area (or length+width)","schema":{"type":"string"},"example":"300"},{"name":"area_unit","in":"query","required":false,"description":"sqft|sqm","schema":{"type":"string"},"example":"sqft"},{"name":"climate","in":"query","required":false,"description":"mild|warm|moderate|cool|cold|verycold","schema":{"type":"string"},"example":"moderate"},{"name":"btu_per_sqft","in":"query","required":false,"description":"Or custom BTU/ft²","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Rough heating load by climate zone for moderate insulation. Estimate only — a Manual J calculation is recommended.","input":{"climate":"moderate","area_sqft":300,"btu_per_sqft":40},"heating_kw":3.517,"heating_watts":3516.9,"heating_btu_per_hour":12000},"meta":{"timestamp":"2026-06-04T01:59:18.322Z","request_id":"868bc6a4-089e-4eda-b223-e8ed246479bb"},"status":"ok","message":"Heating load","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Rule-of-thumb estimates (EnergyStar-style). A Manual J load calculation is recommended for real installations.","service":"hvac","climates":["mild","warm","moderate","cool","cold","verycold"],"endpoints":{"/v1/convert":"Convert between BTU/h, tons of cooling, kW and watts.","/v1/cooling":"Cooling BTU/h, tons and kW for a room from area and adjustments (occupants, sun, ceiling, kitchen).","/v1/heating":"Heating BTU/h, kW and watts from area and a climate zone (or BTU/ft²)."},"description":"HVAC sizing maths: air-conditioner cooling load, heating load by climate, and BTU/ton/kW conversion."},"meta":{"timestamp":"2026-06-04T01:59:18.410Z","request_id":"8a0e4bb1-840e-47fa-b82e-2e75f80673d9"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":11235,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1275,"monthly_call_quota":20850,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3265,"monthly_call_quota":258500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7065,"monthly_call_quota":1335000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hvac-api"}