tollbooth
Licensed contractors by trade and city, zip or county: license number, name, type, status, expiry, address. Served states: CA, FL, MN, OR, TX, VA, WA; GET /v1/license/trades (free) lists each state's trades. Up to 25 results, active first, with total_matches; empty results is a paid 200. City, zip or county (where offered); no fuzzy or radius search. Oregon covers active licenses only; most Washington builders register as general, so a narrow WA trade can undercount. data_as_of is required.
Offering
- Provider
- api.flipvo.com
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Legal And Compliance
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.flipvo.com/v1/license/search- MIME type
- Not provided
- First seen
- 2026-10-16T01:50:38.788Z
- Last seen
- Tags
- compliance, licensing, contractors
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "50000",
"payTo": "0x849610c11c1e9b309235932faab6368cee7f7c57"
}
]Observed health
- Status
- Reachable
- Latest latency
- 49 ms
- Average latency
- 1015 ms
- HTTP status
- 405
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"additionalProperties": false,
"properties": {
"body": {
"description": "A two-letter state, a trade from that state's list, and a city, 5-digit zip, or county.",
"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, zip or county.",
"examples": [
"Tampa"
],
"title": "City"
},
"county": {
"anyOf": [
{
"maxLength": 40,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Offered only where a state lists it. Exactly one of city, zip or county.",
"examples": [
"Harris"
],
"title": "County"
},
"limit": {
"default": 25,
"maximum": 25,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"state": {
"enum": [
"CA",
"FL",
"MN",
"OR",
"TX",
"VA",
"WA"
],
"examples": [
"FL"
],
"maxLength": 2,
"minLength": 2,
"title": "State",
"type": "string"
},
"trade": {
"description": "A trade slug. Each state offers its own list: GET /v1/license/trades (free)",
"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). Exactly one of city, zip or county.",
"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 schema
{
"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"
},
"class_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). CA: the license's first classification in the trade (e.g. plumbing is C36). Null for OR and TX.",
"title": "Class Code"
},
"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'; CA primary status, e.g. 'CLEAR'; OR, TX and VA 'active'/'expired'; WA the L&I status, e.g. 'ACTIVE'.",
"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"
}