{"slug":"api-flipvo-com-v1-license-search-00dd8d","title":"Licensed contractors by trade and city or zip","host":"api.flipvo.com","method":"POST","resource":"https://api.flipvo.com/v1/license/search","category":"search","description":"Licensed contractors by trade and city or zip: license number, name, license type, status, expiry, address. Served states: FL, OR; the trade field's enum lists each state's trades. Up to 25 results, active first, with total_matches; empty results is a paid 200. Exact city or 5-digit zip, no fuzzy or","price_listed":0.1,"price_asked":0.1,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":598,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"city":"Tampa","state":"FL","trade":"roofing"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"description":"Every input rule lives here, so an invalid body is refused before the 402 (#118).","properties":{"active_only":{"default":true,"title":"Active Only","type":"boolean"},"city":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Exact match after normalizing case and spaces, on addresses in the requested state. Exactly one of city or zip.","examples":["Tampa"],"title":"City"},"limit":{"default":25,"maximum":25,"minimum":1,"title":"Limit","type":"integer"},"state":{"enum":["FL","OR"],"examples":["FL"],"maxLength":2,"minLength":2,"title":"State","type":"string"},"trade":{"description":"Offered per state. FL: electrical, general, hvac, plumbing, pool, roofing, underground_utility; OR: commercial_general, commercial_specialty, home_inspector, lead_paint, locksmith, residential_general, residential_specialty.","enum":["commercial_general","commercial_specialty","electrical","general","home_inspector","hvac","lead_paint","locksmith","plumbing","pool","residential_general","residential_specialty","roofing","underground_utility"],"examples":["roofing"],"maxLength":40,"title":"Trade","type":"string"},"zip":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"5-digit ZIP (ZIP+4 accepted; the first 5 digits match).","examples":["33602"],"title":"Zip"}},"required":["state","trade"],"title":"LicenseSearchRequest","type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"coverage":{"title":"Coverage","type":"string"},"data_as_of":{"additionalProperties":{"type":"string"},"title":"Data As Of","type":"object"},"query":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"integer"}]},"title":"Query","type":"object"},"results":{"items":{"properties":{"active":{"title":"Active","type":"boolean"},"city":{"title":"City","type":"string"},"dba_name":{"title":"Dba Name","type":"string"},"expires":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"title":"Expires"},"license_number":{"title":"License Number","type":"string"},"license_type":{"title":"License Type","type":"string"},"name":{"title":"Name","type":"string"},"state":{"description":"The license holder's address state.","title":"State","type":"string"},"status":{"description":"As the state gives it: FL primary status 'C'/'P'/'S'; OR 'active'/'expired'.","title":"Status","type":"string"},"trade":{"title":"Trade","type":"string"},"zip":{"title":"Zip","type":"string"}},"required":["license_number","name","dba_name","license_type","trade","status","active","expires","city","zip","state"],"title":"SearchResultOut","type":"object"},"title":"Results","type":"array"},"source":{"title":"Source","type":"string"},"state":{"title":"State","type":"string"},"total_matches":{"description":"Matches before the limit.","title":"Total Matches","type":"integer"},"truncated":{"description":"total_matches is more than the results returned.","title":"Truncated","type":"boolean"}},"required":["state","query","results","total_matches","truncated","data_as_of","source","coverage"],"title":"LicenseSearchResponse","type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.1,"price_match":true,"latency_ms":598,"error":null}],"description_full":"Licensed contractors by trade and city or zip: license number, name, license type, status, expiry, address. Served states: FL, OR; the trade field's enum lists each state's trades. Up to 25 results, active first, with total_matches; empty results is a paid 200. Exact city or 5-digit zip, no fuzzy or radius search. Oregon covers active licenses only. data_as_of is required.","last_updated":"2026-09-24T14:01:48.151Z","schemes":["exact"]}