Open data

HVAC Bench Error Code Dataset

Every source-verified error code reference on HVAC Bench as one table: the manufacturer, the code, the product family it applies to, what it means, what an owner can safely check, and when a technician is needed. Free to reuse with credit.

87 codes38 manufacturersVersion 1.0.0CC BY 4.0

Download

CSV: hvac-error-codes.csv
JSON: hvac-error-codes.json
API: /api/v1/error-codes/
DOI: 10.5281/zenodo.22698962
Updated: 2026-09-11

Read this before using a code

A manufacturer defines an error code for a specific product family. The same code can mean different things on two brands, and on two generations of one brand. Every record states the family its definition was documented for, in product_family and scope_note. Do not apply a record outside that scope, and do not merge records from different brands into one universal list.

The owner_safe_checks column lists only checks that need no tools and no access to live electrical parts, refrigerant, or combustion components. Everything else is in call_a_technician_when.

What each record contains

18 columns, in file order. List fields are separated by a semicolon or a vertical bar as noted.
Column	Description
`id`	Stable record identifier, taken from the reference page address.
`brand`	Manufacturer name as it appears on the equipment.
`brand_slug`	Lowercase manufacturer key, stable across versions.
`error_code`	The code as the display or controller shows it.
`equipment_type`	Equipment category, such as ductless-mini-split or boiler.
`product_family`	The product family the definition was documented for. A code is only valid inside this scope.
`models`	Models or series named in the documentation, separated by semicolons.
`fault_category`	What kind of fault the code reports, such as communication-fault.
`title`	Headline of the HVAC Bench reference page.
`meaning`	Plain-language definition of what the control detected.
`scope_note`	Limits on where the definition applies, when the documentation states them.
`owner_safe_checks`	Checks an owner can make without opening the equipment, separated by a vertical bar.
`call_a_technician_when`	Conditions and work that need a qualified technician, separated by a vertical bar.
`reset_guidance`	What the documentation permits for a reset, when it says.
`evidence_class`	Class of primary documentation behind the definition.
`evidence_publishers`	Publishers of that documentation, separated by semicolons.
`last_reviewed`	Date the definition was last checked against its source (ISO 8601).
`reference_url`	The full HVAC Bench reference page for this code.

How the records are made

Each record comes from a published reference page that was checked against the manufacturer's own documentation, as described in our sources and methodology. Definitions are paraphrased, not copied. The class and publisher of the documentation are recorded in evidence_class and evidence_publishers; the documents themselves are verified and retained internally, not publicly linked. The full reasoning, diagnostic branches, and safety limits for a code are on the page in reference_url.

Add a free code lookup to your site

Paste this where you want the lookup to appear. It searches the dataset as a visitor types and opens the matching reference. The link inside the element stays visible as the credit line, and it is what readers without JavaScript see.

<div data-hvac-bench-lookup>
  <a href="https://hvac-bench.com/error-codes/">HVAC error codes from HVAC Bench</a>
</div>
<script src="https://hvac-bench.com/embed/error-code-lookup.js" async></script>

To show one manufacturer only, add its key from the brand_slug column:

<div data-hvac-bench-lookup data-brand="daikin">…</div>

Read it from code

The API returns the same payload as the JSON download, with cross-origin requests allowed. It changes only when the dataset does, so cache it rather than calling it on every page view.

fetch("https://hvac-bench.com/api/v1/error-codes/")
  .then((response) => response.json())
  .then((data) => console.log(data.count, data.records[0]));

Licence and credit

The dataset is licensed under Creative Commons Attribution 4.0 International. You may share and adapt it for any purpose, including commercially, as long as you credit HVAC Bench. Please attribute as: HVAC Bench Error Code Dataset by HVAC Bench (https://hvac-bench.com), CC-BY-4.0.

@misc{hvacbench_error_codes,
  title     = {HVAC Bench Error Code Dataset},
  author    = {Haroon, Mukarram},
  publisher = {HVAC Bench},
  year      = {2026},
  version   = {1.0.0},
  doi       = {10.5281/zenodo.22698962},
  url       = {https://hvac-bench.com/data/hvac-error-codes/}
}

Other copies

Version 1.0.0 is archived on Zenodo under DOI 10.5281/zenodo.22698962. The DOI 10.5281/zenodo.22698961 always points to the latest version. Identical copies are published on GitHub, Zenodo, Kaggle, and Hugging Face. This page is the canonical copy and is updated first.

Corrections

If a record is wrong for your equipment, tell us. Corrections that change a definition are logged on the corrections page and in the next dataset version.