Skip to main content
The AHRI matches endpoint returns matched-system efficiency records for HVAC split systems, including SEER2, EER2, HSPF2, and capacity ratings at multiple outdoor temperatures. Records are sourced from the AHRI directory and ENERGY STAR matched-system lists. This endpoint requires at minimum sandbox-level dataset access to query, but quote_safe: true is only assigned to records that have resolved licensed AHRI data provenance, a certified status, an exact matched-system review, and no outstanding unresolved requirements. Certificate lookups, ENERGY STAR-derived rows, and contractor-uploaded records remain quote_safe: false until data rights are fully resolved. Endpoint 
GET https://homeservicedata.com/api/v1/context/ahri-matches
License gate applies. AHRI matched-system data is subject to AHRI licensing terms. Records backed by licensed AHRI directory data return with quote_safe: true only when your account has the required data rights. Records derived from public ENERGY STAR exports, certificate URL scrapes, or contractor uploads always return with quote_safe: false regardless of account tier. Contact your account manager to upgrade your AHRI data access.

​
Query Parameters

​
equipment_id
string
HSD equipment record ID. Resolves the associated AHRI matches for a specific product in the HSD catalog. Recommended as the primary lookup method when building quotes from HSD equipment records.
​
ahri_reference_number
string
AHRI certificate reference number. Exact match.
​
outdoor_model
string
Outdoor unit model number. Partial match, case-insensitive.
​
indoor_model
string
Indoor unit model number. Partial match, case-insensitive.
​
manufacturer
string
Outdoor unit brand/manufacturer name. Partial match, case-insensitive.
​
status
string
Filter by certification status. One of: certified, candidate, superseded, unknown.
​
quote_safe
boolean
When true, returns only records with resolved AHRI data rights and full certification review. When false, returns context-only records.
​
limit
integer
default:"100"
Maximum number of records to return. Capped at 500.

​
Response Fields

​
records
array
Array of AHRI matched-system objects.
​
coverage
object
Query summary metadata.
When looking up AHRI matches for a specific equipment record in your quote workflow, supply equipment_id rather than raw model numbers. The API resolves the canonical model identifiers and returns the pre-matched set, reducing false positives from model number variant mismatches.

​
Example Request

curl -G https://homeservicedata.com/api/v1/context/ahri-matches \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "equipment_id=eqp_01hzka1bc2de3fg4hi5jk6abcd" \
  --data-urlencode "quote_safe=true"

​
Example Response

{
  "success": true,
  "data": {
    "records": [
      {
        "record_id": "ahm_01hzka1bc2de3fg4hi5jk6efgh",
        "ahri_reference_number": "210191234",
        "outdoor_unit": {
          "brand": "Carrier",
          "model": "24ACC636A003"
        },
        "indoor_unit": {
          "brand": "Carrier",
          "model": "FV4CNF003"
        },
        "system_type": "split_ac",
        "refrigerant_type": "R-410A",
        "ratings": {
          "seer2": 15.2,
          "eer2": 12.5,
          "hspf2": null,
          "cooling_capacity_btu_h": 34800,
          "heating_capacity_47f_btu_h": null,
          "heating_capacity_17f_btu_h": null,
          "heating_capacity_5f_btu_h": null
        },
        "status": "certified",
        "energy_star_link_status": "matched",
        "verification": {
          "source_kind": "ahri_licensed",
          "exact_match": true,
          "certified_at": "2022-03-15T00:00:00Z",
          "published_at": "2022-03-20T00:00:00Z"
        },
        "unresolved_requirements": [],
        "quote_safe": true,
        "confidence": "high",
        "provenance": {
          "source_document_id": "doc_01hzka1bc2de3fg4hi5ahri",
          "source_url": "https://www.ahridirectory.org/",
          "certificate_url": "https://www.ahridirectory.org/Certificate/210191234",
          "last_verified_at": "2024-10-01T00:00:00Z",
          "trust_basis": "ahri_match_context"
        }
      }
    ],
    "coverage": {
      "records_returned": 1,
      "quote_safe_only": true,
      "status": "all",
      "trust_basis": "Quote-safe AHRI rows require licensed AHRI data provenance, certified status, exact matched-system review, and no unresolved requirements; certificate lookups, ENERGY STAR-derived rows, and contractor uploads remain context until data rights are resolved."
    }
  }
}