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.com/api/v1/context/hvac/pricing
Query Parameters Filter by manufacturer name. Partial match, case-insensitive (e.g., Carrier, Lennox).
Filter by model number. Partial match, case-insensitive.
Narrow to a specific price observation type. Common values: msrp, distributor_list, street_price, installed_benchmark.
Filter by provenance category. Common values: public_market_observation, third_party, inferred_model, public_benchmark.
When true, returns only records cleared for use in customer-facing quotes. Omit to return all records.
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 of price observation objects. Unique record identifier.
Internal reference to the source document that produced this record.
Always hvac for this endpoint.
High-level equipment category (e.g., split_system_ac, heat_pump, air_handler).
Equipment manufacturer name.
Manufacturer model number.
Normalized SKU if a canonical match was resolved.
Descriptive product type label.
Rated cooling capacity in tons.
HSPF2 heating efficiency rating.
Refrigerant designation (e.g., R-410A, R-32).
Type of price observation (e.g., msrp, street_price).
Point-estimate observed price in USD.
Low end of an observed price range, if applicable.
High end of an observed price range, if applicable.
Currency code. Always USD.
Human-readable name of the data source.
Direct URL to the source page or document.
Title of the source document.
Provenance category of this observation.
ISO 8601 timestamp when the price was observed at the source.
ISO 8601 timestamp when the record was ingested.
Whether this record meets the verification threshold for customer-facing use.
Confidence tier: high, medium, or low.
List of validation warning strings attached during ingest.
Additional source-specific key-value pairs.
Summary of the query result set. Number of records returned.
Dataset identifier for this endpoint’s price observation records.
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.com/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" } } }
