Quick Start: Make Your First Home Service Data API Call

curl -X GET "https://homeservicedata.org/api/v1/finance/fees?trade=solar" \
  -H "x-api-key: YOUR_API_KEY"

{
  "data": [
    {
      "finance_program_version_id": "fpv_abc123",
      "financier_name": "Acme Lender",
      "financier_slug": "acme-lender",
      "product_title": "25-Year 0% APR",
      "payment_type": "loan",
      "term_months": 300,
      "fee_percentage": 28.5,
      "trade_category": "solar",
      "quote_safe": true,
      "last_verified_at": "2025-01-15T00:00:00Z"
    }
  ],
  "error": null,
  "meta": {
    "request_id": "req_01J...",
    "api_version": "2026-06-30",
    "dataset_version": null,
    "trust": {
      "endpoint": "/api/v1/finance/fees",
      "level": "quote_safe",
      "use_case": "Approved finance fee records for production quote workflows.",
      "data_rights_note": "Use only within your workspace entitlement.",
      "required_response_fields": ["quote_safe", "last_verified_at"]
    },
    "performance": {
      "target_ms": 250,
      "warn_ms": 500,
      "max_response_bytes": 65536,
      "basis": "server"
    }
  }
}

curl -X GET "https://homeservicedata.org/api/v1/finance/fees?trade=hvac&payment_type=loan" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch('https://homeservicedata.org/api/v1/finance/fees?trade=solar', {
  headers: { 'x-api-key': process.env.HSD_API_KEY! }
});
const { data } = await response.json();

// Filter to only quote-safe rows before displaying to customers
const quoteSafePrograms = data.filter((row: any) => row.quote_safe === true);