Blog/Argile sizing API: automating calculations
Argile product

May 19, 2026

5 min read

Updated August 11, 2026

Argile sizing API: automated calculations

When a client asks you for a quick estimate, you don't have time to redo ten calculations by hand. With automated calculations, you gain consistency, limit oversights, and can move faster from the site survey to a clear proposal. The idea is simple: you keep control of the assumptions, and the tool does the heavy lifting, always the same way. The result is fewer back-and-forths, and technical decisions that are easier to justify to the client.

Contents

The Argile sizing API exposes the calculation engine over REST in JSON, with a response time under 200 ms and endpoints for heat pumps, photovoltaics, insulation and domestic hot water. It takes site survey data as input, areas, volumes, walls, joinery, existing systems and climate data at the address, and returns outputs and thermal resistances computed on the same rules at every call. What matters for the firm is not the speed but the repeatability: the same survey always gives the same result, which makes the output adopted defensible under inspection. The assumptions stay in the firm's hands, the API does not correct a wrong survey, it carries it through to the quote.

What is a sizing API for on your retrofit job sites in 2026?

Going from the site survey to a reliable calculation without wasting time

A sizing API links your surveys (surfaces, volumes, photos, plans, climate zones) to a calculation engine. The result: you get a reliable calculation without re-entering data, with clear assumptions that are exportable for the job file and the grants.

Reducing power and equipment choice errors (heat pump, ventilation, insulation)

Correct sizing means avoiding a heat pump that is too big and short-cycles, or too small and struggles on cold days. An API can apply rules derived from reference frameworks, check the consistency of heat loss, and secure the right power rating. The same logic applies to ventilation (flow rates) and insulation (thermal resistances), with alerts when a choice falls outside the norms.

Responding faster to requests with consistent, comparable scenarios

With an API, you generate several scenarios on an identical basis. You compare options (insulation first, then heat pump, or the reverse) and you send a quote faster. The client sees clear variants, you keep control, and your recommendation stays consistent with the fabric-first order PAS 2035 expects.

What data should you plan for to automate your sizing calculations?

Building data: surfaces, volumes, walls, joinery, orientation, use

To automate a reliable sizing, start from a solid base. Enter the heated surfaces, volumes and ceiling heights, then the walls (walls, floors, roofs) with their materials and insulation. Add the joinery with glazing type, dimensions, airtightness, orientation and shading. Finish with the intended use, the temperature setpoints and the room zoning.

Technical data: existing systems, emitters, networks, installation constraints

List the existing system and its settings: generator, power rating, flow temperatures, regulation, DHW, ventilation. On the distribution side, specify radiators, underfloor heating, indoor units, as well as the state of the networks (lengths, diameters, heating network balancing). Also note the constraints: available space, access, noise, condensate drainage, flue system, and electrical capacity.

External data: local weather, altitude, regulatory context, address-based Open Data

Calculations gain in accuracy with local weather and a design external temperature, altitude, wind exposure, and microclimate. Integrate the scheme and installation rules (TrustMark, PAS 2030:2023, MCS) and, via an API, pre-fill using address-based open data: the EPC register, mapping and land registry data, flood risk zones, conservation area and listed building constraints, networks.

How the Argile API automates the sizing of your projects

Fast energy diagnosis and retrofit scenarios in under 5 minutes

With the Argile API, you start from a fast energy diagnosis. In 5 minutes, the platform estimates the heat loss, proposes scenarios (insulation, ventilation, heating) and gives orders of magnitude for the power rating and the surfaces to be treated. You keep control of the assumptions, without getting lost in spreadsheets. Once the project firms up, the sizing report compliant with NF EN 12831-1 comes out of the workflow with no extra work.

Feasibility analysis: technical constraints automatically detected at the address

Starting from an address, the feasibility analysis cross-references public data: at the address, climate zone, altitude, building type, access or planning constraints, presence of a gas network. The system highlights what often blocks a sizing, then suggests realistic alternatives.

3D reconstruction and technical visit assistance to make calculation inputs more reliable

3D reconstruction and technical visit assistance secure your surveys. Reliable measurements, openings, heights, surfaces, insulation thicknesses, heat pump unit locations. Once the inputs are made reliable, your calculations and quotes gain in precision, without extending the time on site, in line with the workflow from technical visit to quote.

From calculation to quote: integrating automation into your pricing and the grants

Pre-costing and detailed quotes: linking sizing, quantities and prices

With a tool connected to your price libraries, the sizing (heat pump, insulation, ventilation) automatically feeds the quantities. Surfaces, lengths, power ratings, accessories, everything flows through into the pre-costing, then into a detailed quote. An API can also push these lines to your ERP or your invoicing software, without re-entering data.

Funding calculation: ECO4 and the Boiler Upgrade Scheme directly in the quoting journey

In the same journey, you work out what the chosen scenario can attract, according to the measure, the target performance and your certifications. In 2026, the client mainly wants a simple answer: the remaining cost, any advance payment and the documents to prepare. Automation reduces oversights and secures your funding.

Standardising your deliverables: assumptions, results, supporting documents and traceability

Standardise your assumptions (surface, thermal resistance, COP, regulation), your results and the expected supporting documents. With templates, you produce a quote, a calculation note and a consistent, timestamped evidence file. This traceability makes checking easier and speeds up exchanges with the grant bodies.

Best practices for deploying an API in a renovation company

Defining your internal rules: assumptions, margins, options, quality checks

Before opening your API to your quoting or grant tools, set clear rules. List your assumptions (surfaces, resistances, efficiencies), your margins per work package, your standard options. Add simple quality checks. For example, alert thresholds on heat pump power ratings, consistency of insulation U-values, missing administrative documents.

Securing exchanges: access management, confidentiality, calculation responsibility

Apply the principle of minimal access. One token per application, role-based rights, and regular key rotation. Encrypt exchanges (HTTPS), log calls, and define what falls under your responsibility. Housing data, client data, grant calculations. Also plan a "read-only" mode for partners.

Measuring field impact: quoting lead times, signature rate, share of comprehensive retrofits

Track field indicators every week. Average quoting time, number of quotes sent, signature rate, and share of comprehensive retrofit projects. Link these figures to API changes. A useful improvement shows up quickly in your schedule and your order book.

Key figures

< 200 ms

Response time

heat pumps, PV, insulation, DHW

Endpoints

JSON REST

Format

Frequently asked questions

Before locking in a power rating or flow rate, check that the calculation assumptions match standard practice: heat loss to BS EN 12831 and the MCS sizing rules, ventilation rates to Approved Document F, insulation to Approved Document L, and consistency between emitters and pipework. For heat pumps, align the design external temperature and the flow temperatures with the emitter circuit, then keep an exportable report for the MCS handover pack.

Share this article

Pierre-Louis Guhur

Pierre-Louis is CEO and co-founder of Argile. He holds a PhD in machine learning, written at Inria, and renovated a house with his own hands in 2017 before founding the company. On the blog he writes about what he implements in the software: the 3CL-DPE 2021 method, NF EN 12831 and building physics as a calculation engine has to handle them, assumption by assumption.

Further reading

Heat pump sizing note

Calculated to NF EN 12831-1

General information

Beneficiary

Mrs Margaret Hughes

Email

contact@argile.ai

Phone

+44 7700 900457

Works address

7 Rosewood Close, Sheffield

Air-to-water heat pump

Model

Alféa Extensa S. 10

Make

Atlantic

Rated output

10 kW

ηs at 35 °C / 55 °C

195 % / 154 %

COP

3,5

Controller

Classe VI

EPREL no.

2491075

Heat loss of the home

6,0 kW

Output at the design temperature

5,80 kW

3,59 kW

7,78 kW

0 %

60 %

130 %

Coverage of the demand

Equipment output / heat loss of the home

97 %

Sizing of the appliance

Roofs

Transmittance W/m².K

1,8

Area

65,2

Heat loss W/K

135,0

Floors

Transmittance W/m².K

0,6

Area

63,0

Heat loss W/K

15,6

Thermal bridges

Conductivity W/K/m

0,4

Lengths m

33,4

Heat loss W/K

12,5

Façades

Transmittance W/m².K

0,9

Area

162,4

Heat loss W/K

151,4

Openings

Transmittance W/m².K

1,2

Area

5,5

Heat loss W/K

10,9

Air renewal

Air change rate h⁻¹

0,8

Heat loss W/K

102,3

Temperature difference

Outdoor design temperature

-7 °C

Heat pump cut-off temperature

5 °C

Indoor set temperature

19 °C

DeltaT

14,0 °C

Construction coefficient

Volume (area × ceiling height)

378,0 m³

Equivalent G value

1,13 W/m³/K

With argile

The compliant sizing report, generated automatically

Compliant with EN 12831-1 and built from the data collected during the site visit, the sizing report comes out of the flow with no extra work, ready for the customer's file.

Argile productApril 26, 2026
Argile and installers: from diagnosis to sizing

On site, an accurate diagnosis and correct sizing are what save you from callbacks, repeated adjustments and runaway energy bills. Taking the time to ask the right questions, floor area, insulation, usage patterns, emitters, secures your equipment choice and your commissioning. The result: an installation that keeps its promises, and a reputation that follows.

5 min read

ContractorsApril 18, 2026
Low-temperature underfloor heating: sizing and pipe spacing

Low-temperature underfloor heating is sized under two ceilings, not one: the surface temperature of the finished floor, and the flow water temperature. Everything else, spacing, active area, water regime, exists to keep the required output under those limits. Here are the referenced figures, the screed cover thicknesses to respect, and what belongs on the quotation before the first pipe goes down.

5 min read

Reveal your expertise

One demo, and you see your expertise proven.

Contact us