# Flipvo Contractor License Search

> Flipvo Contractor License Search is a paid API for AI agents from api.flipvo.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-02).

Search licensed contractors by trade and location (city or ZIP) in Florida or Oregon, returning license number, name, type, status, expiry, and address.

## Facts

- Endpoint: POST https://api.flipvo.com/v1/license/search?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/flipvo-contractor-license-search-cc9db41f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s9tK-dkZcMFyhQfCILzPc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability flipvo-contractor-license-search-cc9db41f -d '<json body>'
```

Example prompt: Can you find me active roofing contractors in Tampa, FL? Pull up their license numbers, status, and addresses — up to 25 results.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/flipvo-contractor-license-search-cc9db41f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.flipvo.com](https://www.zero.xyz/host/api.flipvo.com/llms.txt)