{"name":"TradesAPI","description":"Unified US contractor-license verification API. One request returns a normalized result (valid, licensee name, expiration, status, disciplinary history) for any supported jurisdiction.","canonical_url":"https://www.tradesapi.com/","schema_version":"1","coverage":{"state_jurisdictions":{"count":51,"note":"all 50 US states plus the District of Columbia","states":[{"code":"AK","name":"Alaska","guide_url":"https://www.tradesapi.com/guides/alaska-contractor-license-lookup"},{"code":"AL","name":"Alabama","guide_url":"https://www.tradesapi.com/guides/alabama-contractor-license-lookup"},{"code":"AR","name":"Arkansas","guide_url":"https://www.tradesapi.com/guides/arkansas-contractor-license-lookup"},{"code":"AZ","name":"Arizona","guide_url":"https://www.tradesapi.com/guides/arizona-contractor-license-lookup"},{"code":"CA","name":"California","guide_url":"https://www.tradesapi.com/guides/california-contractor-license-lookup"},{"code":"CO","name":"Colorado","guide_url":"https://www.tradesapi.com/guides/colorado-contractor-license-lookup"},{"code":"CT","name":"Connecticut","guide_url":"https://www.tradesapi.com/guides/connecticut-contractor-license-lookup"},{"code":"DC","name":"District of Columbia","guide_url":"https://www.tradesapi.com/guides/district-of-columbia-contractor-license-lookup"},{"code":"DE","name":"Delaware","guide_url":"https://www.tradesapi.com/guides/delaware-contractor-license-lookup"},{"code":"FL","name":"Florida","guide_url":"https://www.tradesapi.com/guides/florida-contractor-license-lookup"},{"code":"GA","name":"Georgia","guide_url":"https://www.tradesapi.com/guides/georgia-contractor-license-lookup"},{"code":"HI","name":"Hawaii","guide_url":"https://www.tradesapi.com/guides/hawaii-contractor-license-lookup"},{"code":"IA","name":"Iowa","guide_url":"https://www.tradesapi.com/guides/iowa-contractor-license-lookup"},{"code":"ID","name":"Idaho","guide_url":"https://www.tradesapi.com/guides/idaho-contractor-license-lookup"},{"code":"IL","name":"Illinois","guide_url":"https://www.tradesapi.com/guides/illinois-contractor-license-lookup"},{"code":"IN","name":"Indiana","guide_url":"https://www.tradesapi.com/guides/indiana-contractor-license-lookup"},{"code":"KS","name":"Kansas","guide_url":"https://www.tradesapi.com/guides/kansas-contractor-license-lookup"},{"code":"KY","name":"Kentucky","guide_url":"https://www.tradesapi.com/guides/kentucky-contractor-license-lookup"},{"code":"LA","name":"Louisiana","guide_url":"https://www.tradesapi.com/guides/louisiana-contractor-license-lookup"},{"code":"MA","name":"Massachusetts","guide_url":"https://www.tradesapi.com/guides/massachusetts-contractor-license-lookup"},{"code":"MD","name":"Maryland","guide_url":"https://www.tradesapi.com/guides/maryland-contractor-license-lookup"},{"code":"ME","name":"Maine","guide_url":"https://www.tradesapi.com/guides/maine-contractor-license-lookup"},{"code":"MI","name":"Michigan","guide_url":"https://www.tradesapi.com/guides/michigan-contractor-license-lookup"},{"code":"MN","name":"Minnesota","guide_url":"https://www.tradesapi.com/guides/minnesota-contractor-license-lookup"},{"code":"MO","name":"Missouri","guide_url":"https://www.tradesapi.com/guides/missouri-contractor-license-lookup"},{"code":"MS","name":"Mississippi","guide_url":"https://www.tradesapi.com/guides/mississippi-contractor-license-lookup"},{"code":"MT","name":"Montana","guide_url":"https://www.tradesapi.com/guides/montana-contractor-license-lookup"},{"code":"NC","name":"North Carolina","guide_url":"https://www.tradesapi.com/guides/north-carolina-contractor-license-lookup"},{"code":"ND","name":"North Dakota","guide_url":"https://www.tradesapi.com/guides/north-dakota-contractor-license-lookup"},{"code":"NE","name":"Nebraska","guide_url":"https://www.tradesapi.com/guides/nebraska-contractor-license-lookup"},{"code":"NH","name":"New Hampshire","guide_url":"https://www.tradesapi.com/guides/new-hampshire-contractor-license-lookup"},{"code":"NJ","name":"New Jersey","guide_url":"https://www.tradesapi.com/guides/new-jersey-contractor-license-lookup"},{"code":"NM","name":"New Mexico","guide_url":"https://www.tradesapi.com/guides/new-mexico-contractor-license-lookup"},{"code":"NV","name":"Nevada","guide_url":"https://www.tradesapi.com/guides/nevada-contractor-license-lookup"},{"code":"NY","name":"New York","guide_url":"https://www.tradesapi.com/guides/new-york-contractor-license-lookup"},{"code":"OH","name":"Ohio","guide_url":"https://www.tradesapi.com/guides/ohio-contractor-license-lookup"},{"code":"OK","name":"Oklahoma","guide_url":"https://www.tradesapi.com/guides/oklahoma-contractor-license-lookup"},{"code":"OR","name":"Oregon","guide_url":"https://www.tradesapi.com/guides/oregon-contractor-license-lookup"},{"code":"PA","name":"Pennsylvania","guide_url":"https://www.tradesapi.com/guides/pennsylvania-contractor-license-lookup"},{"code":"RI","name":"Rhode Island","guide_url":"https://www.tradesapi.com/guides/rhode-island-contractor-license-lookup"},{"code":"SC","name":"South Carolina","guide_url":"https://www.tradesapi.com/guides/south-carolina-contractor-license-lookup"},{"code":"SD","name":"South Dakota","guide_url":"https://www.tradesapi.com/guides/south-dakota-contractor-license-lookup"},{"code":"TN","name":"Tennessee","guide_url":"https://www.tradesapi.com/guides/tennessee-contractor-license-lookup"},{"code":"TX","name":"Texas","guide_url":"https://www.tradesapi.com/guides/texas-contractor-license-lookup"},{"code":"UT","name":"Utah","guide_url":"https://www.tradesapi.com/guides/utah-contractor-license-lookup"},{"code":"VA","name":"Virginia","guide_url":"https://www.tradesapi.com/guides/virginia-contractor-license-lookup"},{"code":"VT","name":"Vermont","guide_url":"https://www.tradesapi.com/guides/vermont-contractor-license-lookup"},{"code":"WA","name":"Washington","guide_url":"https://www.tradesapi.com/guides/washington-contractor-license-lookup"},{"code":"WI","name":"Wisconsin","guide_url":"https://www.tradesapi.com/guides/wisconsin-contractor-license-lookup"},{"code":"WV","name":"West Virginia","guide_url":"https://www.tradesapi.com/guides/west-virginia-contractor-license-lookup"},{"code":"WY","name":"Wyoming","guide_url":"https://www.tradesapi.com/guides/wyoming-contractor-license-lookup"}]},"municipal_boards":{"count":16,"boards":[{"jurisdiction_code":"CA_losangeles","city":"Los Angeles","state":"California","state_code":"CA","guide_url":"https://www.tradesapi.com/guides/los-angeles-california-contractor-license-lookup"},{"jurisdiction_code":"CO_denver","city":"Denver","state":"Colorado","state_code":"CO","guide_url":"https://www.tradesapi.com/guides/denver-colorado-contractor-license-lookup"},{"jurisdiction_code":"FL_jacksonville","city":"Jacksonville","state":"Florida","state_code":"FL","guide_url":"https://www.tradesapi.com/guides/jacksonville-florida-contractor-license-lookup"},{"jurisdiction_code":"GA_atlanta","city":"Atlanta","state":"Georgia","state_code":"GA","guide_url":"https://www.tradesapi.com/guides/atlanta-georgia-contractor-license-lookup"},{"jurisdiction_code":"IL_chicago","city":"Chicago","state":"Illinois","state_code":"IL","guide_url":"https://www.tradesapi.com/guides/chicago-illinois-contractor-license-lookup"},{"jurisdiction_code":"IN_indianapolis","city":"Indianapolis","state":"Indiana","state_code":"IN","guide_url":"https://www.tradesapi.com/guides/indianapolis-indiana-contractor-license-lookup"},{"jurisdiction_code":"MI_detroit","city":"Detroit","state":"Michigan","state_code":"MI","guide_url":"https://www.tradesapi.com/guides/detroit-michigan-contractor-license-lookup"},{"jurisdiction_code":"NV_lasvegas","city":"Las Vegas","state":"Nevada","state_code":"NV","guide_url":"https://www.tradesapi.com/guides/las-vegas-nevada-contractor-license-lookup"},{"jurisdiction_code":"NY_nyc","city":"New York City","state":"New York","state_code":"NY","guide_url":"https://www.tradesapi.com/guides/new-york-city-new-york-contractor-license-lookup"},{"jurisdiction_code":"OH_columbus","city":"Columbus","state":"Ohio","state_code":"OH","guide_url":"https://www.tradesapi.com/guides/columbus-ohio-contractor-license-lookup"},{"jurisdiction_code":"PA_philadelphia","city":"Philadelphia","state":"Pennsylvania","state_code":"PA","guide_url":"https://www.tradesapi.com/guides/philadelphia-pennsylvania-contractor-license-lookup"},{"jurisdiction_code":"TN_nashville","city":"Nashville","state":"Tennessee","state_code":"TN","guide_url":"https://www.tradesapi.com/guides/nashville-tennessee-contractor-license-lookup"},{"jurisdiction_code":"TX_dallas","city":"Dallas","state":"Texas","state_code":"TX","guide_url":"https://www.tradesapi.com/guides/dallas-texas-contractor-license-lookup"},{"jurisdiction_code":"TX_elpaso","city":"El Paso","state":"Texas","state_code":"TX","guide_url":"https://www.tradesapi.com/guides/el-paso-texas-contractor-license-lookup"},{"jurisdiction_code":"TX_sanantonio","city":"San Antonio","state":"Texas","state_code":"TX","guide_url":"https://www.tradesapi.com/guides/san-antonio-texas-contractor-license-lookup"},{"jurisdiction_code":"WA_seattle","city":"Seattle","state":"Washington","state_code":"WA","guide_url":"https://www.tradesapi.com/guides/seattle-washington-contractor-license-lookup"}]},"trades":["electrical","general","hvac","plumbing"],"status_url":"https://www.tradesapi.com/status"},"pricing":{"currency":"USD","free_tier":{"verifications":50,"price_usd":0,"note":"included with every new API key"},"usage_tiers":[{"name":"Starter","verifications":400,"price_usd":99,"per_verification_usd":0.2475},{"name":"Growth","verifications":1500,"price_usd":349,"per_verification_usd":0.2327},{"name":"Business","verifications":5000,"price_usd":999,"per_verification_usd":0.1998}],"monitoring":{"price_usd_per_month":99,"included_monitors":50,"note":"continuous re-verification with webhook alerts on change"},"enterprise":{"contact":"hello@tradesapi.com","note":"custom volume pricing and SLA"},"billing_note":"1 credit per successful verification; failed lookups are not charged"},"endpoints":[{"method":"GET","path":"/verify","url":"https://www.tradesapi.com/verify","auth":"X-API-Key header","description":"Verify one license by state + number (optional trade / city)."},{"method":"GET","path":"/search","url":"https://www.tradesapi.com/search","auth":"X-API-Key header","description":"Find licenses by name when the number is unknown (state + name, optional trade / city / limit); 2 credits per search."},{"method":"POST","path":"/batch","url":"https://www.tradesapi.com/batch","auth":"X-API-Key header","description":"Verify up to 200 licenses in one call; 1 credit per success."},{"method":"POST","path":"/monitor","url":"https://www.tradesapi.com/monitor","auth":"X-API-Key header","description":"Continuously watch a license; webhook alerts on status change."}],"mcp":{"hosted_endpoint":"https://www.tradesapi.com/mcp","auth":"OAuth 2.1","npm_client":"contractor-license-mcp-server","compatible_with":["Claude","Cursor","OpenAI","any MCP client"],"source":"https://github.com/Noquarter6/contractor-license-mcp-server"},"references":{"openapi":"https://www.tradesapi.com/openapi.json","llms_txt":"https://www.tradesapi.com/llms.txt","llms_full_txt":"https://www.tradesapi.com/llms-full.txt","docs":"https://www.tradesapi.com/docs","sandbox":"https://www.tradesapi.com/sandbox","guides":"https://www.tradesapi.com/guides","sitemap":"https://www.tradesapi.com/sitemap.xml"},"compliance_note":"For business verification only. TradesAPI is not a consumer reporting agency and may not be used for any purpose governed by the Fair Credit Reporting Act."}