{
  "openapi": "3.0.1",
  "info": {
    "title": "Contractor License Lookup & Leads: 9 US State Registries",
    "description": "Contractor license lookup and lead lists from official WA, OR, TX, CT, NY, NYC, DE and CA registries: business, license no., trade, status, expiry, phone, address, bond and insurance. New-licenses filter for B2B sales teams.",
    "version": "0.1",
    "x-build-id": "njYjzCfTAdbgR69rZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/quarrylane-data~us-contractor-license-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-quarrylane-data-us-contractor-license-leads",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/quarrylane-data~us-contractor-license-leads/runs": {
      "post": {
        "operationId": "runs-sync-quarrylane-data-us-contractor-license-leads",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/quarrylane-data~us-contractor-license-leads/run-sync": {
      "post": {
        "operationId": "run-sync-quarrylane-data-us-contractor-license-leads",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "sources": {
            "title": "States / registries",
            "type": "array",
            "description": "Official registries to pull from. Leave empty for all of them.",
            "items": {
              "type": "string",
              "enum": [
                "WA",
                "OR",
                "OR-BCD",
                "TX",
                "CT",
                "NY",
                "NYC",
                "DE",
                "FL",
                "CA"
              ],
              "enumTitles": [
                "Washington – L&I contractor licenses (≈162k, phone)",
                "Oregon – CCB construction contractors (≈46k, phone, bond & insurance)",
                "Oregon – BCD electrical/plumbing/boiler businesses",
                "Texas – TDLR A/C, electrical, elevator, sign & appliance contractors (phone)",
                "Connecticut – DCP home improvement & trade contractors",
                "New York State – DOL public-work Contractor Registry (phone, MWBE)",
                "New York City – DCWP Home Improvement Contractors (phone)",
                "Delaware – resident & non-resident contractor business licenses",
                "Florida – DBPR construction licences (official CSV; may be blocked from some cloud IPs)",
                "California – CSLB contractor licences (official Public Data Portal CSV, phone, bond & workers’ comp)"
              ]
            }
          },
          "trades": {
            "title": "Trades",
            "type": "array",
            "description": "Keep only licences in these trades (matched against licence type, class, endorsement and specialty). Leave empty for all trades. Registries that don't publish trade detail (NY State registry, Delaware) are skipped when a trade is selected.",
            "items": {
              "type": "string",
              "enum": [
                "general",
                "home-improvement",
                "electrical",
                "plumbing",
                "hvac",
                "roofing",
                "solar",
                "pool",
                "elevator",
                "fire-protection",
                "demolition",
                "excavation",
                "concrete-masonry",
                "carpentry",
                "painting",
                "flooring",
                "landscaping",
                "sign",
                "asbestos-lead",
                "specialty"
              ],
              "enumTitles": [
                "General / building contractor",
                "Home improvement / handyman",
                "Electrical",
                "Plumbing",
                "HVAC / mechanical / A-C",
                "Roofing & gutters",
                "Solar",
                "Pool & spa",
                "Elevator / conveyor",
                "Fire protection / sprinklers",
                "Demolition",
                "Excavation / underground utility",
                "Concrete, masonry & paving",
                "Carpentry, framing & drywall",
                "Painting",
                "Flooring & tile",
                "Landscaping, tree & irrigation",
                "Signs",
                "Asbestos, lead & pollutant storage",
                "Specialty contractor (other)"
              ]
            }
          },
          "licenseTypeKeywords": {
            "title": "Licence type keywords",
            "type": "array",
            "description": "Extra free-text match on licence type / specialty, e.g. 'fence', 'insulation', 'garage door'. Combined with Trades using OR.",
            "items": {
              "type": "string"
            }
          },
          "businessNameContains": {
            "title": "Business name contains",
            "type": "string",
            "description": "Case-insensitive match on business, DBA or principal name (useful for verifying one company)."
          },
          "cities": {
            "title": "Cities",
            "type": "array",
            "description": "Exact city names, e.g. 'Seattle', 'Portland', 'Houston'.",
            "items": {
              "type": "string"
            }
          },
          "zipCodes": {
            "title": "ZIP codes or prefixes",
            "type": "array",
            "description": "5-digit ZIPs or prefixes, e.g. '98101' or '981' (all of Seattle area).",
            "items": {
              "type": "string"
            }
          },
          "activeOnly": {
            "title": "Active licences only",
            "type": "boolean",
            "description": "Skip expired, suspended, inactive and out-of-business licences.",
            "default": true
          },
          "requirePhone": {
            "title": "Only licences with a phone number",
            "type": "boolean",
            "description": "Keep only records with a published business phone. Registries that publish no phones (CT, DE, OR-BCD) are skipped.",
            "default": false
          },
          "newLicensesWithinDays": {
            "title": "New licences only: issued in the last N days",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Fresh-lead mode: only licences first issued (or, for WA and NY, issued/effective) in the last N days. Billed as the premium 'new-license-lead' event. Registries without issue dates (TX, DE, OR-BCD) are skipped."
          },
          "onlyNew": {
            "title": "Monitor mode: only licences not delivered before",
            "type": "boolean",
            "description": "Remembers every licence delivered under the monitor key and skips it next time, so a scheduled run returns (and charges for) only new records.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Label for this saved monitor (plain text, not a password or API key). When \"Only new\" monitor mode is on, the Actor remembers which records it has already delivered under this name and returns only new ones next time. Use a different name per filter set or client, for example \"client-a-weekly\". Older inputs that use monitorKey still work.",
            "default": "default"
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Upper limit of licences to return across all registries (Free Apify plan: 15 per run).",
            "default": 1000
          },
          "maxItemsPerSource": {
            "title": "Max results per registry",
            "minimum": 1,
            "type": "integer",
            "description": "Optional cap per registry so one big state doesn't use the whole budget."
          },
          "enrichWebsiteContacts": {
            "title": "Enrich contacts from the business website",
            "type": "boolean",
            "description": "When a registry record already includes the firm's own website, fetch the homepage plus likely /contact and /about pages (lightweight HTTP only, robots.txt respected, short timeouts). Adds websiteEmails, websitePhones and websiteSocials. Charges an extra $0.02 contact-enriched event only when an email or phone is found. Records with no website are skipped; domains are never guessed. Most official contractor registries do not publish a website, so this is a no-op unless a source provides one.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}