{ "openapi": "3.0.1", "info": { "title": "Oregon Contractor License Lookup & Export", "description": "Every active contractor licensed by the Oregon Construction Contractors Board (CCB), with phone, street address, county and bond on every row, measured. Export general and specialty construction or lead-paint renovation, or verify a list of names or licence numbers. Official register.", "version": "1.0", "x-build-id": "MwucuayVYV8PDt8jx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wellbuilt_zythem~oregon-contractor-license-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wellbuilt_zythem-oregon-contractor-license-lookup", "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/wellbuilt_zythem~oregon-contractor-license-lookup/runs": { "post": { "operationId": "runs-sync-wellbuilt_zythem-oregon-contractor-license-lookup", "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/wellbuilt_zythem~oregon-contractor-license-lookup/run-sync": { "post": { "operationId": "run-sync-wellbuilt_zythem-oregon-contractor-license-lookup", "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": { "mode": { "title": "Mode", "enum": [ "lookup", "export", "newBusinesses" ], "type": "string", "description": "Lookup verifies a list of names or licence numbers. Export downloads a whole state and trade. Full detail reads the CSLB licence page for each California licence number you pass: bond, workers' compensation carrier and policy, classifications, entity type and today's status. It is the only mode that answers for a licence that is expired, inactive, cancelled or not in the register at all, because the bulk California file publishes active licences only. New contractors reads the state business registry (Oregon, Connecticut) for construction companies registered in the last N days and says whether each one already holds a licence: the lead before the licence exists.", "default": "lookup" }, "queries": { "title": "Names or licence numbers to look up", "type": "array", "description": "One per line. A licence number matches exactly; a name matches any Oregon licensee or business containing it.", "items": { "type": "string" } }, "registeredWithinDays": { "title": "Registered within days (new contractors mode)", "minimum": 1, "maximum": 90, "type": "integer", "description": "New contractors mode only: businesses registered in the state business registry within this many days. Connecticut updates daily (587 construction registrations in 30 days, all with an email, measured September 2026). Oregon publishes the previous month in one batch, so the window counts back from the newest registration published, not from today (179 in the August batch, 170 with the owner's name).", "default": 30 }, "onlyUnlicensed": { "title": "Only businesses without a licence yet (new contractors mode)", "type": "boolean", "description": "New contractors mode only: keep the companies the licensing board does not know yet. That is the lead for insurance, bonding, software and training sellers. Matching is by exact business name against the whole state register, so a company licensed under another name shows as unlicensed.", "default": false }, "trades": { "title": "Trades", "type": "array", "description": "Leave empty for every trade the Oregon board licenses.", "items": { "type": "string", "enum": [ "construction-contractor", "specialty-contractor", "lead-paint-renovation-contractor", "home-inspector" ], "enumTitles": [ "Residential General Contractor / Commercial General Contractor Level 1 / Commercial General Contractor Level 2 / Residential Limited Contractor", "Residential Specialty Contractor / Commercial Specialty Contractor Level 1 / Commercial Specialty Contractor Level 2", "Lead Based Paint Renovation Contractor", "Oregon Certified Home Inspector / Home Inspector Services Contractor" ] }, "default": [] }, "onlyActive": { "title": "Only active licences", "type": "boolean", "description": "Drop expired, suspended and out-of-business licences.", "default": false }, "onlyWithPhone": { "title": "Only rows with a phone number", "type": "boolean", "description": "For calling lists.", "default": false }, "onlyExpiringSoon": { "title": "Only licences expiring within 60 days", "type": "boolean", "description": "The renewal window. Who sells bonds, insurance or continuing education wants exactly these.", "default": false }, "expiringWithinDays": { "title": "Expiring within N days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Keep only licences that expire in the next N days (1 to 365). The renewal list: whoever sells bonds, insurance or continuing education calls these first. Leave empty for no window. Overrides the fixed 60-day \"expiring soon\" switch when set." }, "issuedWithinDays": { "title": "Issued within N days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Keep only licences first issued in the last N days (1 to 365): newly licensed contractors, which is a new business needing suppliers, software, a truck and insurance. Uses the board's issue date; boards that do not publish one return nothing here rather than a guess." }, "maxResults": { "title": "Maximum rows", "minimum": 0, "type": "integer", "description": "0 for no limit.", "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 } } } } } } } } } }