Submit a home energy assessment through the DOE Home Energy Score (HEScore) API
domain: hes-documentation.labworks.org · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Become a DOE-approved Qualified Assessor and email assessor@ee.doe.gov (or your state HES administrator) to request Software Partner status and a developer API key.
Authenticate by calling get_session_token with the assessor's username and password; store the returned session_key and send it with every subsequent call.
Build the home model as an HPXML document and call submit_hpxml_inputs to register the building (inputs cannot be revised after submission).
Call validate_inputs with the returned building_id and resolve any reported errors before generating a label; optionally pre-check locally with the open-source hes-validation-engine Node.js library first.
Call generate_label to run the simulation and produce the PDF Home Energy Score label, then call destroy_session_token when the assessor's session ends.
Known gotchas
The API is SOAP/WSDL-based (separate Sandbeta, Sandbox, and Production WSDL URLs), not REST/JSON — plan client tooling accordingly.
Production access requires DOE written authorization after passing the DOE HEScore API Test Suite; Sandbox credentials do not carry over to Production.
Access is gated to DOE-approved Qualified Assessors, not open developer signup — budget lead time for DOE approval before promising an integration timeline.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?