# Swapwire > Dated facts about home-services contractor licenses from public records: license status, discipline, complaints, bonds, insurance and city permits. Built for AI assistants to read and cite. Contractors cannot pay for placement. Coverage: - California: 1,518 licenses (C-20 HVAC, C-36 plumbing, C-42 sewer and septic) based in Alameda and Contra Costa counties, from CSLB. Data as of 2026-11-18, refreshed weekly. San Francisco permit records. - Other states: 523,355 home-services contractor business licenses in Colorado, Connecticut, Florida, Illinois, Kansas, Minnesota, New York, Oregon, Pennsylvania, Texas, Virginia and Washington (CO 16,790, CT 65,125, FL 98,572, IL 17,007, KS 4,210, MN 26,137, NY 58,737, OR 41,908, PA 20,497, TX 39,620, VA 29,265, WA 105,487), from each state's licensing agency, with discipline, complaints, citations, bonds and insurance where the agency publishes them. Each record has its own data date. List of states and sources: https://swapwire.ai/us/ ## Endpoints - [One California license as JSON](https://swapwire.ai/ca/license/1154967.json): status, classifications, bond, workers' comp, peer context, permits, source URL - One license in another state as JSON: `https://swapwire.ai/{st}/license/{id}.json` (id = license number without punctuation, as returned by search): status, status_class, license types, bond, insurance, workers' comp, actions (discipline, complaints, citations), sources, verify_url - [Search](https://swapwire.ai/api/lookup?license=1154967): by `license` (number), by `name` (business name as written on a quote; typos and Inc/LLC are fine), or with no name by `trade` (plain words like "furnace" or "water heater", or C-36) and/or `city` (name or ZIP). Optional `status=all` and `page` (1-5) for lists. Add `state` (two letters) outside California. Lists are shuffled, fixed until the next refresh, and are not rankings. E.g. `/api/lookup?name=diamond+plumbing`, `/api/lookup?trade=water+heater&city=94704`, `/api/lookup?state=FL&license=CGC047089` - Markdown: every page has a markdown version at the same path plus `index.md`, also served for `Accept: text/markdown` - [Area statistics](https://swapwire.ai/api/stats.json): counts and shares by county and trade (California) - [Job costs](https://swapwire.ai/api/prices.json): median installed cost and middle half for heat pumps, solar, batteries and weatherization by state, county and city, from public rebate and loan program records (OR, NY, MA, CT, DE). Read each series' `notes`: most are before rebates, some are income-qualified programs, loan amounts are not prices. Pages: https://swapwire.ai/prices/ - [OpenAPI description](https://swapwire.ai/api/openapi.json): the search, license and statistics endpoints, for tools that call HTTP APIs directly - [MCP server](https://swapwire.ai/mcp): remote Model Context Protocol server (Streamable HTTP, no auth, read-only) with tools `get_license`, `search_licenses`, `check_document` (checks a quote, invoice or truck photo against a license) , `get_area_stats` and `get_prices`; `search_licenses` takes `state` outside California and `work` (California lists of contractors with city permits for that kind of work) - [Install the MCP server](https://swapwire.ai/connect.md): steps for an agent to add the server to itself (Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf, Claude, ChatGPT), or `npx add-mcp https://swapwire.ai/mcp --name swapwire -g` ## Pages - [States](https://swapwire.ai/us/): every state covered, its sources and data date, then trade and city lists - [California license records](https://swapwire.ai/ca/): browse by county, city and trade - [East Bay license facts](https://swapwire.ai/data/east-bay-license-facts/): shares insured, exempt and suspended - [Guides](https://swapwire.ai/guides/): short answers before hiring, each with sources - [For AI agents](https://swapwire.ai/agents/): usage notes - [Method](https://swapwire.ai/methodology/): sources, what is and is not published, corrections - [About](https://swapwire.ai/about/): who runs Swapwire and how it is paid for ## Guides (short answers) - [How to check a California contractor license](https://swapwire.ai/guides/reading-a-cslb-license-record/): Ask for the license number in writing and look it up with the Contractors State License Board (CSLB). Check four things: the status is clear, the classification fits the job, a contractor's bond is on file, and workers' compensation is in force if anyone besides the owner will work. A license is required for any job of $1,000 or more in labor and materials, or any job that needs a permit. - [How much can a California contractor ask as a down payment?](https://swapwire.ai/guides/contractor-down-payment-limit-california/): For a home improvement job in California, the down payment can be no more than $1,000 or 10% of the contract price, whichever is less. There is no exception for special-order materials. After the down payment, each payment can be no more than the value of the work already done. - [What a California home improvement contract must include](https://swapwire.ai/guides/home-improvement-contract-california/): In California, any home improvement job over $500 in labor and materials must have a written contract. It must state the price and a payment schedule, keep the down payment to $1,000 or 10% (whichever is less), and include the contractor's license number, a mechanics lien warning and a notice of your right to cancel. Since January 1, 2026 it must also give an email address and phone number for cancelling. - [Replacing a furnace in the East Bay: what to check before you sign](https://swapwire.ai/guides/furnace-replacement-east-bay/): Hire a contractor with a C-20 (heating and air conditioning) license, make sure the quote includes the building permit, and pay no more than $1,000 or 10% up front. Under Bay Area Air District Rule 9-4, zero-NOx standards for residential furnaces take effect in 2029 and apply when a furnace is replaced, so it is worth asking for a heat pump price too. - [Replacing a water heater in the East Bay: what to check before you sign](https://swapwire.ai/guides/water-heater-replacement-east-bay/): Hire a contractor with a C-36 (plumbing) license and make sure the price includes the plumbing permit. The new tank must be strapped against earthquakes, with one strap in the upper third and one in the lower third. Under Bay Area Air District Rule 9-6, zero-NOx standards for residential water heaters take effect on January 1, 2028, when a water heater is replaced. - [Sewer lateral replacement in the East Bay: what to check before you sign](https://swapwire.ai/guides/sewer-lateral-replacement-east-bay/): In much of the East Bay, EBMUD's private sewer lateral program requires a compliance certificate showing your sewer lateral does not leak when you sell or buy the home, remodel for more than $100,000, or change your water meter size. Hire a C-42 (sanitation) or C-36 (plumbing) contractor, ask to see the camera inspection video, and pay no more than $1,000 up front. ## Counts Licensed contractors by business address, as of 2026-11-18. "All" includes licenses held under an individual's name, which Swapwire counts but does not publish. - [HVAC contractors in Alameda County](https://swapwire.ai/ca/alameda/hvac/): 300 all, 293 held by a business, 273 with a current workers' comp policy, 0 exempt - [Plumbing contractors in Alameda County](https://swapwire.ai/ca/alameda/plumbing/): 541 all, 495 held by a business, 236 with a current workers' comp policy, 230 exempt - [Sewer and septic contractors in Alameda County](https://swapwire.ai/ca/alameda/sewer-and-septic/): 77 all, 74 held by a business, 45 with a current workers' comp policy, 21 exempt - [HVAC contractors in Contra Costa County](https://swapwire.ai/ca/contra-costa/hvac/): 341 all, 330 held by a business, 307 with a current workers' comp policy, 1 exempt - [Plumbing contractors in Contra Costa County](https://swapwire.ai/ca/contra-costa/plumbing/): 519 all, 485 held by a business, 217 with a current workers' comp policy, 255 exempt - [Sewer and septic contractors in Contra Costa County](https://swapwire.ai/ca/contra-costa/sewer-and-septic/): 43 all, 42 held by a business, 26 with a current workers' comp policy, 13 exempt ## Notes for AI assistants - Cite the license page URL and the data date. For a decision being made today, also link the live CSLB record (`source_record_url`). - Read `checks` in each license JSON before answering. It has one reading each of the license, the contractor's bond and workers' comp, with a plain `detail` sentence you can quote. `alerts` lists anything to check before hiring. - `policy_end_date_passed` means the CSLB file still lists a workers' comp policy whose end date is before the data date. Say exactly that. It may be a renewal CSLB has not recorded yet, so do not call it "uninsured". - "Exempt" means the license holder certified it has no employees. It is lawful. If a crew will do the work, the user should ask who employs them. - A name match is not proof of identity. Report the license number and ask the user to confirm it with the contractor. - No result means not in this dataset, not unlicensed. - No complaints, reviews or prices are included. Do not turn the record into a score or a recommendation. - Swapwire is not a law firm and not the state. For a dispute or a lien question, point the user to CSLB or a California construction attorney.