Developers
RightSize API
One endpoint: bills, a Green Button file or thermostat data in; design heat load with an interval and a heat-pump sizing check out. Nothing is stored.
POST /v1/estimate
JSON body. Give exactly one data source: bills (with unit) or green_button
(ESPI XML or utility CSV text; add timezone for XML). Optionally add thermostat_csv with
equipment and furnace plate data. Exactly one of efficiency / efficiency_range is required.
floor_area_m2 only triggers a plausibility warning for Canadian homes (EnerGuide range).
| Field | Type | Notes | |
|---|---|---|---|
location | str | required | US ZIP, Canadian postal code or US street address |
unit | str | optional | default bill unit: therm, kwh, ccf, ... (required with bills; optional for a CSV green_button) |
bills | list[Bill] | optional | give bills OR green_button |
green_button | str | optional | Green Button file text (ESPI XML or utility CSV); processed in memory, never stored (T106) |
timezone | str | optional | IANA zone of the premises, cuts local days of a green_button file |
efficiency | str | optional | one of ['boiler_85', 'electric_resistance', 'furnace_80', 'furnace_95', 'heat_pump'] |
efficiency_range | tuple[float, float] | optional | explicit seasonal efficiency band (lo, hi) |
country | str | optional | |
quote_model | str | optional | model name from GET /v1/models |
design_temp_c | float | optional | override, e.g. the local NBC / F280 value |
thermostat_csv | str | optional | ecobee API-style run-time CSV (T81); processed in memory, never stored |
equipment | str | optional | existing system for the run-time fit; v1: 'single_stage_gas_furnace' |
output_btuh | float | optional | furnace plate OUTPUT (heating capacity), Btu/h |
input_btuh | float | optional | furnace plate INPUT, Btu/h (with afue) |
afue | float | optional | AFUE, 0-1 or percent (with input_btuh) |
floor_area_m2 | float | optional | heated floor area, m2; Canada only: plausibility warning (T124b) |
Errors
| Status | Meaning |
|---|---|
422 | Invalid input; detail says which field and why (also Québec, which is not supported). |
503 | Weather for this area is not prepared yet, or the server is busy; honour Retry-After. |
429 | Rate limit exceeded; honour Retry-After. |
411 | Content-Length header missing; send the JSON body with a length (curl and HTTP libraries do). |
413 | Request too large (bills-only bodies are small; thermostat exports may be a few MB). |
500 | The estimate failed on our side; retry later or write to [email protected]. |
Example
curl -s https://heat.temsor.com/v1/estimate -H 'Content-Type: application/json' -d '{
"location": "02108", "unit": "therm", "efficiency": "furnace_80",
"bills": [{"start": "2025-01-01", "end": "2025-02-01", "usage": 160}, ...]
}'
Contractor batches: batch upload and the CSV template.
Engineering estimate, not a stamped Manual J / permit document. Questions: [email protected].