{
  "openapi": "3.0.1",
  "info": {
    "title": "Connecticut Contractor License Leads",
    "description": "Connecticut licensed contractor lead lists from the official state registry: home improvement, new home construction, electrical, plumbing, HVAC and more, with business name, address and licence expiry. Filter by credential type, city or expiry. Business records only. No phone or email in source.",
    "version": "0.0",
    "x-build-id": "sn3JGUfzCqlB9o8rk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/yanairon~connecticut-contractor-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-yanairon-connecticut-contractor-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/yanairon~connecticut-contractor-leads/runs": {
      "post": {
        "operationId": "runs-sync-yanairon-connecticut-contractor-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/yanairon~connecticut-contractor-leads/run-sync": {
      "post": {
        "operationId": "run-sync-yanairon-connecticut-contractor-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": {
          "credentials": {
            "title": "Credential types",
            "uniqueItems": true,
            "type": "array",
            "description": "Limit to these contractor credentials. Leave empty for all contractor credentials.",
            "items": {
              "type": "string",
              "enum": [
                "HOME IMPROVEMENT CONTRACTOR",
                "NEW HOME CONSTRUCTION CONTRACTOR",
                "MAJOR CONTRACTOR",
                "DEMOLITION CONTRACTOR",
                "ELECTRICAL UNLIMITED CONTRACTOR",
                "ELECTRICAL LIMITED CONTRACTOR",
                "ELECTRICAL LIMITED SOLAR CONTRACTOR",
                "PLUMBING & PIPING UNLIMITED CONTRACTOR",
                "PLUMBING & PIPING LIMITED CONTRACTOR",
                "HEATING, PIPING & COOLING UNLIMITED CONTRACTOR",
                "HEATING, PIPING & COOLING LIMITED CONTRACTOR",
                "SHEET METAL LIMITED CONTRACTOR",
                "FIRE PROTECTION UNLIMITED CONTRACTOR",
                "FIRE PROTECTION LIMITED CONTRACTOR",
                "SWIMMING POOL BUILDER - IN GROUND",
                "FLAT GLASS UNLIMITED CONTRACTOR",
                "AUTOMOTIVE GLASS UNLIMITED CONTRACTOR",
                "MEDICAL GAS & VACUUM SYSTEMS CONTRACTOR",
                "ELEVATOR UNLIMITED CONTRACTOR",
                "SOLAR THERMAL CONTRACTOR"
              ]
            },
            "default": []
          },
          "businessOnly": {
            "title": "Businesses only",
            "type": "boolean",
            "description": "Keep only business entities (LLCs, corporations, partnerships). Sole-proprietor credentials are excluded and their name/address are never output. Recommended for lead generation.",
            "default": true
          },
          "includeExpired": {
            "title": "Include expired licences",
            "type": "boolean",
            "description": "Include credentials whose expiry date has passed. Off by default: only unexpired credentials are returned.",
            "default": false
          },
          "expiringWithinDays": {
            "title": "Expiring within (days)",
            "minimum": 1,
            "maximum": 1095,
            "type": "integer",
            "description": "Keep only licences expiring within this many days from today. Leave empty for all active licences.",
            "default": null
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Filter by city (case-insensitive exact match, e.g. HARTFORD). Optional.",
            "default": ""
          },
          "state": {
            "title": "State",
            "type": "string",
            "description": "Filter by registrant state (2-letter code). Many CT credential holders are out of state; use CT for Connecticut addresses.",
            "default": ""
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "full",
              "delta"
            ],
            "type": "string",
            "description": "Experimental: change tracking needs persistent storage and currently treats all records as new.",
            "default": "full"
          },
          "deltaDays": {
            "title": "Delta window (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Experimental: change tracking needs persistent storage and currently treats all records as new. Expiry window used in delta mode.",
            "default": 30
          },
          "maxRecords": {
            "title": "Max records",
            "minimum": 0,
            "type": "integer",
            "description": "Cap the number of output records. 0 = no cap. The example input is 25 so a first test run is quick; set 0 for the full list.",
            "default": 0
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}