{"uid":"cap_s9tK-dkZcMFyhQfCILzPc","slug":"flipvo-contractor-license-search-cc9db41f","name":"Flipvo Contractor License 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 radius search. Oregon covers active licenses only. data_as_of is required.","url":"https://api.flipvo.com/v1/license/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"zip":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Zip","default":null,"examples":["33602"],"description":"5-digit ZIP (ZIP+4 accepted; the first 5 digits match). Exactly one of city, zip or county."},"city":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"City","default":null,"examples":["Tampa"],"description":"Exact match after normalizing case and spaces, on addresses in the requested state. Exactly one of city, zip or county."},"limit":{"type":"integer","title":"Limit","default":25,"maximum":25,"minimum":1},"state":{"enum":["CA","FL","OR","TX","VA","WA"],"type":"string","title":"State","examples":["FL"],"maxLength":2,"minLength":2},"trade":{"type":"string","title":"Trade","examples":["roofing"],"maxLength":40,"description":"A trade slug. Each state offers its own list: GET /v1/license/trades (free)"},"county":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"County","default":null,"examples":["Harris"],"description":"Offered only where a state lists it. Exactly one of city, zip or county."},"active_only":{"type":"boolean","title":"Active Only","default":true}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OKNdQBI6q-h3JYs0dLwxO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search licensed contractors by trade and location (city or ZIP) in Florida or Oregon, returning license number, name, type, status, expiry, and address.","exampleAgentPrompt":"Can you find me active roofing contractors in Tampa, FL? Pull up their license numbers, status, and addresses — up to 25 results.","exampleUseCases":[{"title":"Vet a contractor before hiring","prompt":"I'm about to hire a plumber in Portland, OR — can you check if there are any active licensed plumbers in the 97201 zip code and show me their license numbers and expiry dates?"},{"title":"Pre-qualify vendors for a project","prompt":"We need to shortlist licensed HVAC contractors in Orlando, FL for a commercial bid — find all active HVAC licenses in the city of Orlando and give me their names and license details."},{"title":"Compliance audit for contractor roster","prompt":"I need to verify our contractor list — can you look up active electrical contractors in the state of FL for zip code 33602 and tell me their license status and expiration dates?"}],"resultDescription":"Returns up to 25 contractor records (active first) including license number, contractor name, license type, status, expiry date, and address, plus a total_matches count and data_as_of timestamp. An empty result set with a 200 response is a valid paid response indicating no matches.","failureModes":["Invalid or unsupported state returns an error — only FL and OR are supported","Trade enum mismatch — not all trades are available in both states; FL and OR have separate trade lists","Providing both city and zip, or neither, causes a validation error — exactly one is required","Fuzzy or partial city names are not supported — exact city name (case-insensitive) required","Non-5-digit ZIP codes may not match unless using ZIP+4 format","Oregon only returns active licenses — active_only=false has no effect for OR","Empty 200 response is a valid paid outcome when no contractors match the query","Missing data_as_of field may cause request rejection"],"whenToPreferThis":"Choose this endpoint when you need structured contractor license data for Florida or Oregon, specifically by trade and exact city or ZIP code. It is purpose-built for license lookup and verification workflows, returning active-first results with expiry and address details. Prefer this over general business registry lookups when trade-specific contractor licensing is the focus. Not suitable for fuzzy location search, radius-based queries, or states other than FL and OR.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:36:13.948Z","isFirstParty":false,"canonicalSlug":"flipvo-contractor-license-search-cc9db41f"}