The climate context endpoint returns county-level climate and weather-normal data used to support HVAC equipment sizing, load calculations, and incentive eligibility checks. Records draw from DOE/PNNL county climate-zone assignments and NOAA 1991–2020 station normals. The primary fields — IECC climate zone, HDD/CDD, and design temperatures — are quote_safe: true when backed by confirmed station matches. Design-temperature proxy values derived from NOAA hourly percentiles are provided as supplemental context and always carry quote_safe: false.
Endpoint GET https://homeservicedata.com/api/v1/context/climate
Query Parameters Two-letter state code (e.g., TX, MN). Case-insensitive.
County name. Partial match, case-insensitive (e.g., Travis, Cook).
5-digit county FIPS code (e.g., 48453 for Travis County, TX). Exact match.
When true, returns only records verified for quote use. When false, returns unverified/context-only records.
Maximum number of records to return. Capped at 500.
Response Fields Array of county climate context objects. Unique record identifier.
Geographic identifiers for the county. 5-digit county FIPS code.
Climate zone and weather-normal values. IECC 2021 climate zone designation (e.g., 3A, 5B).
DOE Building America climate region label.
Moisture regime: dry, moist, marine, or unknown.
Whether the county qualifies as a cold or very cold climate zone.
NOAA normal period used (e.g., 1991-2020).
Annual heating degree days base 65°F.
Annual cooling degree days base 65°F.
ACCA Manual J design heating temperature in °F (quote-safe when station-matched).
ACCA Manual J design cooling temperature in °F (quote-safe when station-matched).
NOAA hourly percentile proxy values — supplemental context only, never quote-safe. Heating design temperature proxy derived from NOAA hourly normals.
Cooling design temperature proxy derived from NOAA hourly normals.
Percentile method used to derive the proxy value.
Always false for proxy values.
List of unresolved conditions preventing quote-safe status.
Details of the matched NOAA weather station. Show station_match fields
Human-readable station name.
Distance in miles from the county centroid to the matched station.
Station-matching method used.
Confidence tier for this station match.
URL to the station data source.
ISO 8601 timestamp of last station-match verification.
URLs to underlying source documents. URL to the county climate-zone context source.
URL to NOAA annual normals data.
URL to NOAA monthly normals data.
URL to NOAA hourly normals data (basis of proxy values).
List of conditions preventing this record from reaching quote_safe: true.
Whether this record is cleared for use in customer-facing quotes.
Confidence tier: high, medium, or low.
Source traceability metadata. Internal source document reference.
ISO 8601 timestamp of last verification.
Always climate_design_context.
Query summary metadata. Number of records returned.
Whether results were restricted to quote-safe records.
Description of the trust model for this dataset.
design_temperature_proxy values inside each record are derived from NOAA hourly percentile data and are always quote_safe: false. Do not use them as authoritative design temperatures in Manual J load calculations without independent verification.
Example Request curl -G https://homeservicedata.com/api/v1/context/climate \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode "state=TX" \ --data-urlencode "county=Travis" \ --data-urlencode "quote_safe=true"
Example Response { "success" : true , "data" : { "records" : [ { "record_id" : "clm_01hzka1bc2de3fg4hi5jk6abcd" , "geography" : { "state_code" : "TX" , "county_name" : "Travis" , "county_fips" : "48453" }, "climate" : { "iecc_climate_zone" : "2A" , "building_america_region" : "Hot-Humid" , "moisture_regime" : "moist" , "cold_climate_flag" : false , "noaa_normal_period" : "1991-2020" , "hdd_65" : 1648 , "cdd_65" : 3114 , "design_heating_temp_f" : 26.0 , "design_cooling_temp_f" : 99.0 , "design_temperature_proxy" : { "heating_temp_f" : 24.5 , "cooling_temp_f" : 100.2 , "basis" : "noaa_hourly_p99" , "quote_safe" : false , "unresolved_requirements" : [ "proxy_values_not_verified_for_quote_use" ] } }, "station_match" : { "nearest_station_id" : "USW00013958" , "nearest_station_name" : "Austin Bergstrom International Airport" , "distance_miles" : 4.7 , "method" : "centroid_nearest" , "confidence" : "high" , "source_url" : "https://www.ncei.noaa.gov/" , "last_verified_at" : "2024-09-01T00:00:00Z" }, "source_links" : { "county_context_url" : "https://www.energy.gov/eere/buildings/climate-zones" , "noaa_annual_normals_url" : "https://www.ncei.noaa.gov/access/us-climate-normals/" , "noaa_monthly_normals_url" : null , "noaa_hourly_normals_url" : null }, "unresolved_requirements" : [], "quote_safe" : true , "confidence" : "high" , "provenance" : { "source_document_id" : "doc_01hzka1bc2de3fg4hi5jk6xyz" , "source_url" : "https://www.energy.gov/eere/buildings/climate-zones" , "last_verified_at" : "2024-09-01T00:00:00Z" , "trust_basis" : "climate_design_context" } } ], "coverage" : { "state" : "TX" , "county" : "Travis" , "county_fips" : null , "records_returned" : 1 , "quote_safe_only" : true , "trust_basis" : "DOE/PNNL county climate-zone context plus NOAA 1991-2020 station normals. NOAA hourly percentile values are exposed only as non-quote-safe design-temperature proxies." } } }
