contractors.fyi

Which cities and kinds of work contractors.fyi covers, with the dates each list covers. Call this before the other tools to get valid city and kind_of_work values.

{
  "type": "object",
  "properties": {}
}

Contractors ranked by how many jobs of this kind their city permit record shows. Returns name, license where the state publishes one, job count, typical stated job value, the ZIP codes they work in most, and a profile URL. Ranking is by volume on the public record, not quality or reviews.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "los-angeles",
        "san-francisco",
        "seattle",
        "new-york",
        "austin",
        "philadelphia",
        "chicago",
        "nashville",
        "sacramento",
        "boulder",
        "las-vegas",
        "new-orleans",
        "baton-rouge",
        "raleigh",
        "buffalo",
        "cleveland",
        "somerville",
        "cambridge",
        "minneapolis",
        "bellevue",
        "cary",
        "elk-grove",
        "anaheim",
        "arlington-va",
        "greensboro",
        "naperville",
        "everett",
        "chattanooga",
        "orlando",
        "tacoma",
        "riverside",
        "pittsburgh",
        "miami-dade"
      ],
      "description": "City id from list_coverage, e.g. los-angeles, new-york, austin"
    },
    "kind_of_work": {
      "type": "string",
      "enum": [
        "addition",
        "adu",
        "electrical-panel",
        "ev-charger",
        "heat-pump",
        "pool",
        "remodel",
        "roofing",
        "seismic-retrofit",
        "solar"
      ],
      "description": "Kind of work, e.g. roofing, solar, adu, remodel"
    },
    "limit": {
      "default": 10,
      "description": "How many to return, up to 25",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "city",
    "kind_of_work"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

What city permits for this kind of work stated as the job value: median and middle half, with the number of permits and their dates. Give a ZIP to get that ZIP's figure where the site publishes one. The value stated on the city permit, not the price paid.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "los-angeles",
        "san-francisco",
        "seattle",
        "new-york",
        "austin",
        "philadelphia",
        "chicago",
        "nashville",
        "sacramento",
        "boulder",
        "las-vegas",
        "new-orleans",
        "baton-rouge",
        "raleigh",
        "buffalo",
        "cleveland",
        "somerville",
        "cambridge",
        "minneapolis",
        "bellevue",
        "cary",
        "elk-grove",
        "anaheim",
        "arlington-va",
        "greensboro",
        "naperville",
        "everett",
        "chattanooga",
        "orlando",
        "tacoma",
        "riverside",
        "pittsburgh",
        "miami-dade"
      ],
      "description": "City id from list_coverage, e.g. los-angeles, new-york, austin"
    },
    "kind_of_work": {
      "type": "string",
      "enum": [
        "addition",
        "adu",
        "electrical-panel",
        "ev-charger",
        "heat-pump",
        "pool",
        "remodel",
        "roofing",
        "seismic-retrofit",
        "solar"
      ],
      "description": "Kind of work, e.g. roofing, solar, adu, remodel"
    },
    "zip": {
      "description": "Five-digit ZIP code",
      "type": "string",
      "pattern": "^\\d{5}$"
    }
  },
  "required": [
    "city",
    "kind_of_work"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Days from permit application to issue, and from issue to final inspection, from the dates on city permits, with the number of permits and the dates they cover. Final-inspection times count finished jobs only.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "los-angeles",
        "san-francisco",
        "seattle",
        "new-york",
        "austin",
        "philadelphia",
        "chicago",
        "nashville",
        "sacramento",
        "boulder",
        "las-vegas",
        "new-orleans",
        "baton-rouge",
        "raleigh",
        "buffalo",
        "cleveland",
        "somerville",
        "cambridge",
        "minneapolis",
        "bellevue",
        "cary",
        "elk-grove",
        "anaheim",
        "arlington-va",
        "greensboro",
        "naperville",
        "everett",
        "chattanooga",
        "orlando",
        "tacoma",
        "riverside",
        "pittsburgh",
        "miami-dade"
      ],
      "description": "City id from list_coverage, e.g. los-angeles, new-york, austin"
    },
    "kind_of_work": {
      "type": "string",
      "enum": [
        "addition",
        "adu",
        "electrical-panel",
        "ev-charger",
        "heat-pump",
        "pool",
        "remodel",
        "roofing",
        "seismic-retrofit",
        "solar"
      ],
      "description": "Kind of work, e.g. roofing, solar, adu, remodel"
    }
  },
  "required": [
    "city",
    "kind_of_work"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Look a contractor up by business name across every city covered: the city, how many permitted jobs are on its record there, and its profile URL. This searches the permit record; it does not verify a license today.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 3,
      "maxLength": 100,
      "description": "Business name or part of it"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Size a home solar system from the monthly electric bill (or its kWh, or, with neither, the home and what runs on electricity), plus anything the home plans to add such as electric cars, then give the price range homeowners in that city paid for a system that size (Berkeley Lab records, before any tax credit, no battery), yearly savings and payback. Output per kW, heating and cooling use and the default price per kWh are rough city figures.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "austin",
        "los-angeles",
        "new-york",
        "san-francisco"
      ]
    },
    "home_size": {
      "default": "medium",
      "description": "small: under 1,500 sq ft; medium: 1,500 to 3,000; large: over 3,000",
      "type": "string",
      "enum": [
        "small",
        "medium",
        "large"
      ]
    },
    "uses": {
      "default": [],
      "description": "What runs on electricity besides lights, fridge and outlets",
      "maxItems": 7,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Central air conditioning",
          "Heat pump or electric heat",
          "Heat pump water heater",
          "Electric dryer",
          "Electric stove and oven",
          "Pool pump",
          "Hot tub"
        ]
      }
    },
    "electric_cars": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 5
    },
    "miles_per_car": {
      "default": 12000,
      "description": "Miles a year, each car",
      "type": "number",
      "minimum": 0,
      "maximum": 60000
    },
    "price_per_kwh": {
      "description": "Dollars per kWh from the bill; default is a typical city figure",
      "type": "number",
      "minimum": 0,
      "maximum": 5
    },
    "monthly_kwh": {
      "description": "From the bill; replaces the estimate",
      "type": "number",
      "minimum": 1,
      "maximum": 20000
    },
    "monthly_bill": {
      "description": "Monthly electric bill in dollars",
      "type": "number",
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "city"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Where a solar quote's price falls among what homeowners in the same city paid for a system of the same size (Berkeley Lab records, homeowner-owned systems, no battery, before incentives): a percentile, the local typical price and range, and the quote's price per watt.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "austin",
        "los-angeles",
        "new-york",
        "san-francisco"
      ]
    },
    "price": {
      "type": "number",
      "minimum": 1,
      "maximum": 1000000,
      "description": "Quoted cash price in dollars, before incentives"
    },
    "kw": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 100,
      "description": "System size in kW (DC)"
    }
  },
  "required": [
    "city",
    "price",
    "kw"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The smallest common home standby generator size, with 10% to spare, for the things that must run in an outage: running watts plus the biggest motor's start. Also what generator permits stated as job value, by size, where a city has enough of them. Typical appliance figures; an electrician's load calculation beats them.

{
  "type": "object",
  "properties": {
    "loads": {
      "minItems": 1,
      "maxItems": 14,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Refrigerator",
          "Sump pump",
          "Furnace fan",
          "Well pump",
          "Central air, 3 ton",
          "Heat pump, 3 ton",
          "Electric water heater",
          "Electric oven",
          "Microwave",
          "Electric dryer",
          "Washer",
          "Lights and outlets",
          "TV, internet, computers",
          "Space heater"
        ]
      },
      "description": "What must run in an outage"
    }
  },
  "required": [
    "loads"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}