> ## Documentation Index > Fetch the complete documentation index at: https://docs.homeservicedata.org/docs/llms.txt > Use this file to discover all available pages before exploring further. # GET /api/v1/context/climate — County Climate Data > Fetch IECC climate zone, degree days, and NOAA design-temperature context by state, county name, or FIPS code for HVAC load and equipment sizing. 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.org/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. Two-letter state code. County name. 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. NOAA station identifier. 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. Canonical source URL. ISO 8601 timestamp of last verification. Always `climate_design_context`. Query summary metadata. State filter applied. County filter applied. FIPS filter applied. 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 ```bash cURL theme={null} curl -G https://homeservicedata.org/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 ```json theme={null} { "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." } } } ```