{
  "x402Version": 2,
  "id": 36156,
  "slug": "36156",
  "resource": "https://api.flipvo.com/v1/license/search",
  "description": "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.",
  "type": "http",
  "serviceName": "tollbooth",
  "resourceType": "Blockchain Data",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x849610c11c1e9b309235932faab6368cee7f7c57",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "50000",
      "amountUsd": 0.05,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "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"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "city": "Tampa",
            "state": "FL",
            "trade": "roofing"
          },
          "bodyType": "json",
          "method": "POST",
          "type": "http"
        },
        "output": {
          "example": {
            "coverage": "Florida data covers active and inactive licenses.",
            "data_as_of": {
              "dbpr": "2026-09-23T00:00:00Z"
            },
            "query": {
              "active_only": true,
              "city": "TAMPA",
              "limit": 25,
              "trade": "roofing"
            },
            "results": [
              {
                "active": true,
                "city": "TAMPA",
                "dba_name": "SMITH ROOFING LLC",
                "expires": "2026-08-31",
                "license_number": "CCC1331234",
                "license_type": "CCC",
                "name": "SMITH JOHN A",
                "state": "FL",
                "status": "C",
                "trade": "roofing",
                "zip": "33602"
              }
            ],
            "source": "Florida DBPR public records",
            "state": "FL",
            "total_matches": 1,
            "truncated": false
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "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": {
            "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"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "compliance",
    "licensing",
    "contractors",
    "bazaar"
  ],
  "sourceHost": "api.flipvo.com",
  "lastUpdated": "2026-10-08T05:34:58.642Z",
  "quality": {
    "calls30d": 2,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-08T05:34:58.437Z"
  },
  "metadata": {
    "serviceName": "tollbooth",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "body": {
              "city": "Tampa",
              "state": "FL",
              "trade": "roofing"
            },
            "bodyType": "json",
            "method": "POST",
            "type": "http"
          },
          "output": {
            "example": {
              "coverage": "Florida data covers active and inactive licenses.",
              "data_as_of": {
                "dbpr": "2026-09-23T00:00:00Z"
              },
              "query": {
                "active_only": true,
                "city": "TAMPA",
                "limit": 25,
                "trade": "roofing"
              },
              "results": [
                {
                  "active": true,
                  "city": "TAMPA",
                  "dba_name": "SMITH ROOFING LLC",
                  "expires": "2026-08-31",
                  "license_number": "CCC1331234",
                  "license_type": "CCC",
                  "name": "SMITH JOHN A",
                  "state": "FL",
                  "status": "C",
                  "trade": "roofing",
                  "zip": "33602"
                }
              ],
              "source": "Florida DBPR public records",
              "state": "FL",
              "total_matches": 1,
              "truncated": false
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "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": {
              "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"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.flipvo.com",
    "manifest_name": "api.flipvo.com",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {
      "coverage": "string",
      "data_as_of": {},
      "query": {},
      "results": [
        {
          "active": true,
          "city": "string",
          "class_code": null,
          "dba_name": "string",
          "expires": null,
          "license_number": "string",
          "license_type": "string",
          "name": "string",
          "state": "string",
          "status": "string",
          "trade": "string",
          "zip": "string"
        }
      ],
      "source": "string",
      "state": "string",
      "total_matches": 0,
      "truncated": true
    },
    "type": "string"
  }
}