# Home Service Data

## Docs

- [GET /api/v1/benchmarks — Market Pricing Benchmarks](https://docs.homeservicedata.org/docs/api-reference/benchmarks.md): Retrieve statistical distributions — avg, median, p25, p75, min, max, and stddev — for dealer fees, inverter costs, and interest rates.
- [GET /api/v1/catalog/equipment — Equipment Catalog](https://docs.homeservicedata.org/docs/api-reference/catalog-equipment.md): Browse the full equipment catalog with filters for trade, category, manufacturer, and SKU — paginated with category-specific spec objects.
- [GET /api/v1/context/ahri-matches — System Ratings](https://docs.homeservicedata.org/docs/api-reference/context-ahri.md): Look up AHRI matched-system efficiency ratings by outdoor model, indoor model, or reference number. Returns SEER2, EER2, and HSPF2 with quote-safe flags.
- [GET /api/v1/context/climate — County Climate Data](https://docs.homeservicedata.org/docs/api-reference/context-climate.md): Fetch IECC climate zone, degree days, and NOAA design-temperature context by state, county name, or FIPS code for HVAC load and equipment sizing.
- [GET /api/v1/context/electricity-rates — EIA Rates](https://docs.homeservicedata.org/docs/api-reference/context-electricity-rates.md): Retrieve EIA regional electricity rate averages by state, census division, or national scope for market context in solar, HVAC, and electrification quotes.
- [GET /api/v1/context/hvac/pricing — Equipment Prices](https://docs.homeservicedata.org/docs/api-reference/context-hvac.md): Retrieve published HVAC equipment price observations by manufacturer, model, and source kind — used to benchmark quotes and populate cost assumptions.
- [GET /api/v1/context/incentives — Program Incentives](https://docs.homeservicedata.org/docs/api-reference/context-incentives.md): Query program-level incentive records across trades and jurisdictions — federal, state, utility, and local — with quote-safe and status filters.
- [GET /api/v1/context/labor — Labor Rates and Adders](https://docs.homeservicedata.org/docs/api-reference/context-labor.md): Access BLS OEWS regional wage data by trade and occupation code, plus per-task labor adder ranges for HVAC, roofing, solar, and other home-service trades.
- [GET /api/v1/context/permits — Permit Requirements](https://docs.homeservicedata.org/docs/api-reference/context-permits.md): Query permit requirements, inspection rules, and fee schedules by trade, state, county, and city from official jurisdiction portals with quote-safe flags.
- [GET /api/v1/context/roofing — Materials and Labor](https://docs.homeservicedata.org/docs/api-reference/context-roofing.md): Retrieve roofing material specs — warranty, wind rating, fire class, and impact rating — plus optional BLS regional labor rates for roofing crews.
- [GET /api/v1/context/utility-territory — Lookup API](https://docs.homeservicedata.org/docs/api-reference/context-utility-territory.md): Browse utility service territories by state, city, or coordinates, or resolve a postal address to its utility provider with quote-safe confidence.
- [API Error Codes and How to Handle Them](https://docs.homeservicedata.org/docs/api-reference/errors.md): HTTP status codes, error response shape, real error messages, rate-limit headers, and a retry strategy for the Home Service Data REST API.
- [GET /api/v1/context/finance-eligibility — Eligibility Records](https://docs.homeservicedata.org/docs/api-reference/finance-eligibility.md): Retrieve scoped lender and PACE eligible-product records with permit requirements, term limits, and county-level criteria for home-service financing workflows.
- [GET /api/v1/finance/fees — Dealer Fee Records](https://docs.homeservicedata.org/docs/api-reference/finance-fees.md): Retrieve quote-safe dealer-fee and finance-program rows for solar, HVAC, and other home-service quoting tools. Requires production access.
- [GET /api/v1/pricing/finance — Finance Pricing Context](https://docs.homeservicedata.org/docs/api-reference/finance-pricing.md): Retrieve finance pricing context records with dealer fee ranges across lenders and payment types — for comparison, enrichment, and pre-quote research workflows.
- [GET /api/v1/context/finance-products — Lender Context](https://docs.homeservicedata.org/docs/api-reference/finance-products.md): Fetch lender and finance-program quick-fact context records — loan limits, APR ranges, eligible measures — kept separate from quote-safe dealer-fee tables.
- [GET /api/v1/hardware/inverters — Solar Inverter Data](https://docs.homeservicedata.org/docs/api-reference/hardware-inverters.md): Retrieve paginated solar inverter specs, SKU-level pricing context, and cost adjustment fields for use in quoting and CRM workflows.
- [Home Service Data REST API Overview](https://docs.homeservicedata.org/docs/api-reference/overview.md): A complete reference for the Home Service Data REST API — base URL, authentication, response envelope, versioning, trades, and endpoint groups.
- [GET /api/v1/quote-context — Bundled Quote Context](https://docs.homeservicedata.org/docs/api-reference/quote-context.md): Single endpoint bundling finance products, equipment, incentives, climate data, labor adders, permits, and utility territory for any home-service quote.
- [GET /api/v1/search — Search Across All Datasets](https://docs.homeservicedata.org/docs/api-reference/search.md): Unified search endpoint that queries equipment, finance, pricing, incentive, utility, permit, labor, and dataset records in a single request.
- [GET /api/v1/sync/changes — Incremental Dataset Changes](https://docs.homeservicedata.org/docs/api-reference/sync-changes.md): Fetch only the records that changed in a dataset since a given cursor, enabling lightweight delta sync without re-downloading full snapshots.
- [GET /api/v1/sync/snapshot — Full Dataset Snapshot](https://docs.homeservicedata.org/docs/api-reference/sync-snapshot.md): Download a complete, versioned snapshot of any Home Service Data dataset and receive a cursor to begin incremental sync with the changes endpoint.
- [Authentication: API Keys and Access Scopes Explained](https://docs.homeservicedata.org/docs/authentication.md): Home Service Data uses API keys for authentication. Learn how to create keys, pass them in requests, and understand access level scopes.
- [API Access Levels: Sample, Sandbox, and Production](https://docs.homeservicedata.org/docs/concepts/access-levels.md): none, sample, sandbox, and production scope your API key's data access. Entitlement sets the ceiling; keys can be narrowed to any lower level.
- [Data Packets: How Home Service Data Organizes Datasets](https://docs.homeservicedata.org/docs/concepts/data-packets.md): Named, versioned datasets in finance, equipment, and context domains. Each packet has its own API endpoint, access scope, and quote-safe coverage.
- [Quote-Safe Data: When Data Is Ready for Customer Quotes](https://docs.homeservicedata.org/docs/concepts/quote-safe.md): The quote_safe flag marks records that passed source review and verification. Context-only records must not appear in live customer quote calculations.
- [Dataset Sync: Snapshots, Deltas, and Cursors Explained](https://docs.homeservicedata.org/docs/concepts/sync-model.md): Snapshot a dataset once, then poll for delta changes with a cursor. Your local store stays current without re-downloading the entire dataset on every poll.
- [Create, Scope, and Revoke Home Service Data API Keys](https://docs.homeservicedata.org/docs/dashboard/api-keys.md): Create, scope, and revoke API keys from the dashboard to control which datasets and access levels each application or environment can reach.
- [Browse, Access, and Manage Datasets in the Data Catalog](https://docs.homeservicedata.org/docs/dashboard/catalog.md): Use the Data Catalog to discover available datasets, review your access level, locate endpoint paths, and request upgrades for the packets your app needs.
- [Test API Calls in the Home Service Data Playground](https://docs.homeservicedata.org/docs/dashboard/playground.md): Use the Playground to run live API calls, inspect responses, diagnose key scopes and entitlements, and copy ready-to-use curl or fetch requests.
- [Use Compare Hub to Evaluate Finance and Equipment Options](https://docs.homeservicedata.org/docs/guides/compare-hub.md): Evaluate finance programs, solar inverters, solar modules, and HVAC equipment side by side with scenario inputs, trust indicators, and source context.
- [Push Home Service Data into CRM and Field Service Tools](https://docs.homeservicedata.org/docs/guides/crm-integration.md): Sync source-verified finance eligibility, incentives, and equipment data into CRM platforms like ServiceTitan and Jobber to keep lead records accurate.
- [Integrate Home Service Data into Your Quoting Tool](https://docs.homeservicedata.org/docs/guides/quoting-tools.md): Pull current lender rates, equipment specs, and local context into your quoting flow with a single bundled API call per quote session.
- [Sync Home Service Data Datasets to Your Database](https://docs.homeservicedata.org/docs/guides/sync-integration.md): Keep a local database mirror of any HSD dataset using snapshot and delta endpoints for low-latency, offline-resilient quote paths.
- [Get Notified When Home Service Data Datasets Update](https://docs.homeservicedata.org/docs/guides/webhooks.md): Receive webhook events the moment a dataset is published or updated so your local cache and CRM records stay current without polling.
- [Home Service Data: Verified Data for Home Service Quoting](https://docs.homeservicedata.org/docs/introduction.md): Home Service Data delivers source-verified datasets for solar, HVAC, roofing, finance, and utility—ready to use in quoting tools and CRMs via REST API.
- [Quick Start: Make Your First Home Service Data API Call](https://docs.homeservicedata.org/docs/quickstart.md): Learn how to make your first Home Service Data API call. Fetch verified finance programs and equipment data in under five minutes.