RightSize by Temsor

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).

FieldTypeNotes
locationstrrequiredUS ZIP, Canadian postal code or US street address
unitstroptionaldefault bill unit: therm, kwh, ccf, ... (required with bills; optional for a CSV green_button)
billslist[Bill]optionalgive bills OR green_button
green_buttonstroptionalGreen Button file text (ESPI XML or utility CSV); processed in memory, never stored (T106)
timezonestroptionalIANA zone of the premises, cuts local days of a green_button file
efficiencystroptionalone of ['boiler_85', 'electric_resistance', 'furnace_80', 'furnace_95', 'heat_pump']
efficiency_rangetuple[float, float]optionalexplicit seasonal efficiency band (lo, hi)
countrystroptional
quote_modelstroptionalmodel name from GET /v1/models
design_temp_cfloatoptionaloverride, e.g. the local NBC / F280 value
thermostat_csvstroptionalecobee API-style run-time CSV (T81); processed in memory, never stored
equipmentstroptionalexisting system for the run-time fit; v1: 'single_stage_gas_furnace'
output_btuhfloatoptionalfurnace plate OUTPUT (heating capacity), Btu/h
input_btuhfloatoptionalfurnace plate INPUT, Btu/h (with afue)
afuefloatoptionalAFUE, 0-1 or percent (with input_btuh)
floor_area_m2floatoptionalheated floor area, m2; Canada only: plausibility warning (T124b)

Errors

StatusMeaning
422Invalid input; detail says which field and why (also Québec, which is not supported).
503Weather for this area is not prepared yet, or the server is busy; honour Retry-After.
429Rate limit exceeded; honour Retry-After.
411Content-Length header missing; send the JSON body with a length (curl and HTTP libraries do).
413Request too large (bills-only bodies are small; thermostat exports may be a few MB).
500The 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].