GET /api/v1/context/hvac/pricing — Equipment Prices

The HVAC pricing context endpoint surfaces observed market prices for HVAC equipment sourced from distributor pages, public benchmarks, and third-party price feeds. Each record carries a quote_safe flag that tells you whether the observation meets the verification bar for use in customer-facing quotes. Records with quote_safe: false are still useful for internal cost modeling, competitive benchmarking, and range estimation. Endpoint

GET https://homeservicedata.org/api/v1/context/hvac/pricing

Query Parameters

string

Filter by manufacturer name. Partial match, case-insensitive (e.g., Carrier, Lennox).

string

Filter by model number. Partial match, case-insensitive.

string

Narrow to a specific price observation type. Common values: msrp, distributor_list, street_price, installed_benchmark.

string

Filter by provenance category. Common values: public_market_observation, third_party, inferred_model, public_benchmark.

boolean

When true, returns only records cleared for use in customer-facing quotes. Omit to return all records.

integer

default:"100"

Maximum number of records to return. Capped at 250.

All results are scoped to trade_category = hvac. To retrieve pricing for other trades use the equipment pricing endpoint.

Response Fields

array

Array of price observation objects.

Show Record fields

string

Unique record identifier.

string

Internal reference to the source document that produced this record.

string

Always hvac for this endpoint.

string

High-level equipment category (e.g., split_system_ac, heat_pump, air_handler).

string

Equipment manufacturer name.

string

Manufacturer model number.

string | null

Normalized SKU if a canonical match was resolved.

string | null

Descriptive product type label.

number | null

Rated cooling capacity in tons.

number | null

SEER2 efficiency rating.

number | null

HSPF2 heating efficiency rating.

string | null

Refrigerant designation (e.g., R-410A, R-32).

string

Type of price observation (e.g., msrp, street_price).

number | null

Point-estimate observed price in USD.

number | null

Low end of an observed price range, if applicable.

number | null

High end of an observed price range, if applicable.

string

Currency code. Always USD.

string | null

Human-readable name of the data source.

string | null

Direct URL to the source page or document.

string | null

Title of the source document.

string

Provenance category of this observation.

string | null

ISO 8601 timestamp when the price was observed at the source.

string

ISO 8601 timestamp when the record was ingested.

boolean

Whether this record meets the verification threshold for customer-facing use.

string | null

Confidence tier: high, medium, or low.

array | null

List of validation warning strings attached during ingest.

object | null

Additional source-specific key-value pairs.

object

Summary of the query result set.

Show Coverage fields

integer

Number of records returned.

string

Dataset identifier for this endpoint’s price observation records.

string

Description of which record types are held back from quote_safe: true.

third_party, public_market_observation, inferred_model, and public_benchmark source kinds are always returned with quote_safe: false regardless of other conditions. Do not use those records as authoritative pricing in customer quotes without independent verification.

Example Request

curl -G https://homeservicedata.org/api/v1/context/hvac/pricing \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "manufacturer=Carrier" \
  --data-urlencode "quote_safe=true" \
  --data-urlencode "limit=5"

Example Response

{
  "success": true,
  "data": {
    "records": [
      {
        "id": "obs_01hzk9a2bc3de4fg5hi6jk7lmn",
        "source_document_id": "doc_01hzk9a2bc3de4fg5hi6jk7aaa",
        "trade_category": "hvac",
        "equipment_category": "split_system_ac",
        "manufacturer": "Carrier",
        "model_number": "24ACC636A003",
        "matched_sku": "carrier-24acc636a003",
        "product_type": "Central Air Conditioner",
        "tonnage": 3,
        "seer2_rating": 15.2,
        "hspf2_rating": null,
        "refrigerant_type": "R-410A",
        "price_kind": "distributor_list",
        "observed_price": 1485.00,
        "observed_price_low": null,
        "observed_price_high": null,
        "currency": "USD",
        "source_name": "Carrier Authorized Distributor Portal",
        "source_url": "https://example-distributor.com/carrier",
        "source_title": "Carrier 2024 Price Sheet",
        "source_kind": "distributor_list",
        "observed_at": "2024-11-01T00:00:00Z",
        "captured_at": "2024-11-15T10:32:00Z",
        "quote_safe": true,
        "confidence": "high",
        "validation_warnings": [],
        "metadata": null
      }
    ],
    "coverage": {
      "returned": 1,
      "source": "current_equipment_price_observations",
      "quote_safe_rule": "third_party, public_market_observation, inferred_model, and public benchmark rows return as context only"
    }
  }
}

Overview

Search & Catalog

Finance

Equipment & Hardware

Context Datasets

Composite

Sync

GET /api/v1/context/hvac/pricing — Equipment Prices

Query Parameters

Response Fields

Example Request

Example Response

​Query Parameters

​Response Fields

​Example Request

​Example Response

Query Parameters

Response Fields

Example Request

Example Response