# Flipvo Tollbooth – Contractor License Verify

> Flipvo Tollbooth – Contractor License Verify is a paid API for AI agents from api.flipvo.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-30).

Verifies a contractor's license status in FL or OR and returns the matching business-entity record for that license.

## Facts

- Endpoint: POST https://api.flipvo.com/v1/license/verify?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/flipvo-tollbooth-contractor-license-verify-303e525d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GTdgKLl-erRvdZtv0I6vS

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-tollbooth-contractor-license-verify-303e525d -d '<json body>'
```

Example prompt: Can you check if contractor 'Sunshine Build LLC' in Florida with license number CGC1234567 is currently licensed and in good standing, and pull their business entity record?

## When to prefer this

Use this endpoint when you need to verify a contractor's license status combined with their business entity record in Florida or Oregon. It is purpose-built for contractor license validation (not general professional licenses) and uniquely pairs the license record with the state business-entity filing. Prefer this over generic business-registry lookups when the contractor's trade license status is specifically needed, or over general search endpoints when you have a name or license number to anchor the query.

## Known failure modes

- Empty licenses array (paid 200) when no matching license exists for the given name/state/number combination
- Unsupported state: only FL and OR are currently served; other states will return an error or empty result
- Missing required state field causes validation error
- License number or name typo results in no match (empty paid 200)
- Service unavailable or timeout on upstream state registry fetch

## How this service works

Contractor license status plus matching business-entity record. Currently served: FL, OR. Empty licenses is a paid 200. data_as_of is required.

## Output

Returns the contractor's current license status, license type, expiry, and a matching state business-entity record (formation date, status, principal address). An empty licenses array with HTTP 200 indicates a paid response with no matching license found. Includes a data_as_of timestamp indicating data freshness.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 200
    },
    {
     "type": "null"
    }
   ],
   "title": "Name",
   "default": null
  },
  "state": {
   "type": "string",
   "title": "State",
   "pattern": "^[A-Za-z]{2}$",
   "examples": [
    "FL"
   ],
   "maxLength": 2,
   "minLength": 2
  },
  "profession": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 32
    },
    {
     "type": "null"
    }
   ],
   "title": "Profession",
   "default": null,
   "description": "FL or TX only: a licensed profession instead of a contractor. GET /v1/license/professions?state=FL|TX (free) lists them. Omit for contractors."
  },
  "license_number": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 32
    },
    {
     "type": "null"
    }
   ],
   "title": "License Number",
   "default": null
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/flipvo-tollbooth-contractor-license-verify-303e525d/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)