--- type: "firecrawl-provider" description: "Oregon's open data portal (data.oregon.gov) for contractor licensing: the Construction Contractors Board's active licences, with endorsements, surety bonds, liability insurance and responsible managing individuals, and the Building Codes Division's active electrical, plumbing, boiler, elevator, prefab and manufactured dwelling licences and inspector certifications. Search by name, licence number, city, ZIP, county or licence type, poll CCB for licences registered since a date, and read one licence in full." use_when: "Oregon's open data portal (data.oregon.gov) for contractor licensing: the Construction Contractors Board's active licences, with endorsements, surety bonds, liability insurance and responsible managing individuals, and the Building Codes Division's active electrical, plumbing, boiler, elevator, prefab and manufactured dwelling licences and inspector certifications. Search by name, licence number, city, ZIP, county or licence type, poll CCB for licences registered since a date, and read one licence in full." categories: "Real estate" capabilities: 2 credits_per_call: 5 --- # Oregon Open Data Portal on Firecrawl Alexandria Oregon's open data portal (data.oregon.gov) for contractor licensing: the Construction Contractors Board's active licences, with endorsements, surety bonds, liability insurance and responsible managing individuals, and the Building Codes Division's active electrical, plumbing, boiler, elevator, prefab and manufactured dwelling licences and inspector certifications. Search by name, licence number, city, ZIP, county or licence type, poll CCB for licences registered since a date, and read one licence in full. - Categories: Real estate - Category index: [Real estate category](https://firecrawl.dev/alexandria/agents/categories/real-estate) - Provider key: `data-oregon-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/data-oregon-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/data-oregon-gov/openapi.json) ## Capabilities - [Get license](https://firecrawl.dev/alexandria/agents/providers/data-oregon-gov/licenses/get_license): Read one active Oregon licence by number. source ccb returns the CCB licence with every endorsement row joined: endorsement codes, names and dates, surety bonds, liability insurance, responsible managing individual and related home inspector certificates. source bcd returns the Building Codes Division licence. Both include the source rows as raw. A number absent from these active-only datasets (expired, lapsed, suspended or never issued) is not_found. - [Search contractors](https://firecrawl.dev/alexandria/agents/providers/data-oregon-gov/licenses/search_contractors): Search Oregon's active contractor licences. source ccb (default) is the Construction Contractors Board register (dataset g77e-6bhs, reloaded daily): one record per licence with its endorsements (residential or commercial general, specialty, limited, developer and others, lead-based paint renovation, home inspector and locksmith certificates), bonds, insurance and responsible managing individual, newest registration first. source bcd is the Building Codes Division register (vhbr-cuaq, monthly): electrical, plumbing, boiler, elevator, prefab and manufactured dwelling licences and inspector certifications, by name. Both list active licences only, so every status is active and there is no inactive filter. Filters combine with AND; on ccb each filter matches one endorsement row. Empty results are a successful empty page. ## 1. Choose this provider when Oregon's open data portal (data.oregon.gov) for contractor licensing: the Construction Contractors Board's active licences, with endorsements, surety bonds, liability insurance and responsible managing individuals, and the Building Codes Division's active electrical, plumbing, boiler, elevator, prefab and manufactured dwelling licences and inspector certifications. Search by name, licence number, city, ZIP, county or licence type, poll CCB for licences registered since a date, and read one licence in full. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "data-oregon-gov", "capability": "licenses/get_license", "options": { "license_number": "28417" } } ``` ## 3. Add provider options Use only the options needed for the task: - `license_number` (string, required): Licence number, exact (CCB `28417` or `5001OCLS`, BCD `26-45C`); case-insensitive. Pattern: ^[A-Za-z0-9-]+$. Example: `28417` - `license_type` (string): ccb only. `OCHI` reads the Oregon Certified Home Inspector certificate that can share its number with a contractor licence; any other value, such as a record's license_type, reads the contractor licence. Default: the contractor licence when both exist. Example: `` - `source` (string): `ccb`: Construction Contractors Board active licences (g77e-6bhs, daily). `bcd`: Building Codes Division active trade licences and certifications (vhbr-cuaq, monthly). Example: `ccb` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "data-oregon-gov", capability: "licenses/get_license", options: { license_number: "28417", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "data-oregon-gov", "capability": "licenses/get_license", "options": { "license_number": "28417" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "data-oregon-gov", "capability": "licenses/get_license", "options": { "license_number": "28417" } } }' ``` ### CLI ```sh firecrawl scrape 'data-oregon-gov/licenses/get_license' \ --options '{"license_number":"28417"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "data-oregon-gov", "capability": "licenses/get_license", "options": { "license_number": "28417" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "data-oregon-gov", "capability": "licenses/get_license", "options": { "license_number": "28417" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "address": "5500 MEADOWS RD. STE 500", "bonds": [ { "amount_usd": 80000, "company": "FEDERAL INS CO", "effective_date": null, "expiration_date": "2028-04-07" }, { "amount_usd": 25000, "company": "FEDERAL INS CO", "effective_date": null, "expiration_date": "2028-04-07" } ], "business_name": "HOFFMAN CONSTRUCTION COMPANY OF OREGON", "city": "LAKE OSWEGO", "county": "Clackamas", "dataset": { "id": "g77e-6bhs", "name": "CCB Active Licenses", "portal": "data.oregon.gov", "updated_at": "2026-10-27T17:04:21Z", "url": "https://data.oregon.gov/d/g77e-6bhs" }, "dba_names": null, "discipline": null, "effective_date": null, "endorsements": [ { "code": "CGC1", "expiration_date": "2028-04-07", "issue_date": "1979-04-25", "name": "Commercial General Contractor Level 1" }, { "code": "RGC", "expiration_date": "2028-04-07", "issue_date": "1979-04-25", "name": "Residential General Contractor" } ], "expiration_date": "2028-04-07", "insurance": [ { "amount_usd": 5000000, "company": "RRG - AMERICAN CONTRACTORS INS CO", "expiration_date": "2027-06-01" } ], "issue_date": "1979-04-25", "license": { "attribution": "Oregon Construction Contractors Board, CCB Active Licenses (data.oregon.gov dataset g77e-6bhs)", "name": "Public Domain U.S. Government", "url": "https://www.usa.gov/government-works" }, "license_number": "28417", "license_type": "CGC1, RGC", "observed_at_ms": 1793141720624, "person_name": null, "phone": "5032218811", "principals": [ { "name": "LEANNE HOIYEE LEGARE", "title": "Responsible Managing Individual" } ], "raw": { "rows": [ { "address": "5500 MEADOWS RD. STE 500", "bond_amount": "80000", "bond_company": "FEDERAL INS CO", "bond_exp_date": "04/07/2028", "city": "LAKE OSWEGO", "county_code": "3", "county_name": "Clackamas", "endorsement_text": "Commercial General Contractor Level 1", "exempt_text": "Nonexempt", "full_name": "HOFFMAN CONSTRUCTION COMPANY OF OREGON", "ins_amount": "5000000", "ins_company": "RRG - AMERICAN CONTRACTORS INS CO", "ins_exp_date": "06/01/2027", "lic_exp_date": "04/07/2028", "license_number": "28417", "license_type": "CGC1", "orig_regis_date": "04/25/1979", "phone_number": "5032218811", "rmi_name": "LEANNE HOIYEE LEGARE", "state": "OR", "zip_code": "97035" }, { "address": "5500 MEADOWS RD. STE 500", "bond_amount": "25000", "bond_company": "FEDERAL INS CO", "bond_exp_date": "04/07/2028", "city": "LAKE OSWEGO", "county_code": "3", "county_name": "Clackamas", "endorsement_text": "Residential General Contractor", "exempt_text": "Nonexempt", "full_name": "HOFFMAN CONSTRUCTION COMPANY OF OREGON", "ins_amount": "5000000", "ins_company": "RRG - AMERICAN CONTRACTORS INS CO", "ins_exp_date": "06/01/2027", "lic_exp_date": "04/07/2028", "license_number": "28417", "license_type": "RGC", "orig_regis_date": "04/25/1979", "phone_number": "5032218811", "rmi_name": "LEANNE HOIYEE LEGARE", "state": "OR", "zip_code": "97035" } ] }, "registry_id": null, "related_licenses": [], "source_url": "https://data.oregon.gov/resource/g77e-6bhs.json?license_number=28417", "specialties": [ "Commercial General Contractor Level 1", "Residential General Contractor" ], "state": "OR", "status": "active", "suspend_date": null, "zip": "97035" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get license - Capability: `licenses/get_license` - Description: Read one active Oregon licence by number. source ccb returns the CCB licence with every endorsement row joined: endorsement codes, names and dates, surety bonds, liability insurance, responsible managing individual and related home inspector certificates. source bcd returns the Building Codes Division licence. Both include the source rows as raw. A number absent from these active-only datasets (expired, lapsed, suspended or never issued) is not_found. - Instructions: Check that an Oregon contractor is currently licensed and read its endorsements, bonds, insurance and expiration dates. - Cost: 5 credits per call - Capability file: [Get license](https://firecrawl.dev/alexandria/agents/providers/data-oregon-gov/licenses/get_license) Accepted options: - `license_number` (string, required): Licence number, exact (CCB `28417` or `5001OCLS`, BCD `26-45C`); case-insensitive. Pattern: ^[A-Za-z0-9-]+$. Example: `28417` - `license_type` (string): ccb only. `OCHI` reads the Oregon Certified Home Inspector certificate that can share its number with a contractor licence; any other value, such as a record's license_type, reads the contractor licence. Default: the contractor licence when both exist. Example: `` - `source` (string): `ccb`: Construction Contractors Board active licences (g77e-6bhs, daily). `bcd`: Building Codes Division active trade licences and certifications (vhbr-cuaq, monthly). Example: `ccb` Response schema example: ```json { "address": "5500 MEADOWS RD. STE 500", "bonds": [ { "amount_usd": 80000, "company": "FEDERAL INS CO", "effective_date": null, "expiration_date": "2028-04-07" }, { "amount_usd": 25000, "company": "FEDERAL INS CO", "effective_date": null, "expiration_date": "2028-04-07" } ], "business_name": "HOFFMAN CONSTRUCTION COMPANY OF OREGON", "city": "LAKE OSWEGO", "county": "Clackamas", "dataset": { "id": "g77e-6bhs", "name": "CCB Active Licenses", "portal": "data.oregon.gov", "updated_at": "2026-10-27T17:04:21Z", "url": "https://data.oregon.gov/d/g77e-6bhs" }, "dba_names": null, "discipline": null, "effective_date": null, "endorsements": [ { "code": "CGC1", "expiration_date": "2028-04-07", "issue_date": "1979-04-25", "name": "Commercial General Contractor Level 1" }, { "code": "RGC", "expiration_date": "2028-04-07", "issue_date": "1979-04-25", "name": "Residential General Contractor" } ], "expiration_date": "2028-04-07", "insurance": [ { "amount_usd": 5000000, "company": "RRG - AMERICAN CONTRACTORS INS CO", "expiration_date": "2027-06-01" } ], "issue_date": "1979-04-25", "license": { "attribution": "Oregon Construction Contractors Board, CCB Active Licenses (data.oregon.gov dataset g77e-6bhs)", "name": "Public Domain U.S. Government", "url": "https://www.usa.gov/government-works" }, "license_number": "28417", "license_type": "CGC1, RGC", "observed_at_ms": 1793141720624, "person_name": null, "phone": "5032218811", "principals": [ { "name": "LEANNE HOIYEE LEGARE", "title": "Responsible Managing Individual" } ], "raw": { "rows": [ { "address": "5500 MEADOWS RD. STE 500", "bond_amount": "80000", "bond_company": "FEDERAL INS CO", "bond_exp_date": "04/07/2028", "city": "LAKE OSWEGO", "county_code": "3", "county_name": "Clackamas", "endorsement_text": "Commercial General Contractor Level 1", "exempt_text": "Nonexempt", "full_name": "HOFFMAN CONSTRUCTION COMPANY OF OREGON", "ins_amount": "5000000", "ins_company": "RRG - AMERICAN CONTRACTORS INS CO", "ins_exp_date": "06/01/2027", "lic_exp_date": "04/07/2028", "license_number": "28417", "license_type": "CGC1", "orig_regis_date": "04/25/1979", "phone_number": "5032218811", "rmi_name": "LEANNE HOIYEE LEGARE", "state": "OR", "zip_code": "97035" }, { "address": "5500 MEADOWS RD. STE 500", "bond_amount": "25000", "bond_company": "FEDERAL INS CO", "bond_exp_date": "04/07/2028", "city": "LAKE OSWEGO", "county_code": "3", "county_name": "Clackamas", "endorsement_text": "Residential General Contractor", "exempt_text": "Nonexempt", "full_name": "HOFFMAN CONSTRUCTION COMPANY OF OREGON", "ins_amount": "5000000", "ins_company": "RRG - AMERICAN CONTRACTORS INS CO", "ins_exp_date": "06/01/2027", "lic_exp_date": "04/07/2028", "license_number": "28417", "license_type": "RGC", "orig_regis_date": "04/25/1979", "phone_number": "5032218811", "rmi_name": "LEANNE HOIYEE LEGARE", "state": "OR", "zip_code": "97035" } ] }, "registry_id": null, "related_licenses": [], "source_url": "https://data.oregon.gov/resource/g77e-6bhs.json?license_number=28417", "specialties": [ "Commercial General Contractor Level 1", "Residential General Contractor" ], "state": "OR", "status": "active", "suspend_date": null, "zip": "97035" } ``` ### Search contractors - Capability: `licenses/search_contractors` - Description: Search Oregon's active contractor licences. source ccb (default) is the Construction Contractors Board register (dataset g77e-6bhs, reloaded daily): one record per licence with its endorsements (residential or commercial general, specialty, limited, developer and others, lead-based paint renovation, home inspector and locksmith certificates), bonds, insurance and responsible managing individual, newest registration first. source bcd is the Building Codes Division register (vhbr-cuaq, monthly): electrical, plumbing, boiler, elevator, prefab and manufactured dwelling licences and inspector certifications, by name. Both list active licences only, so every status is active and there is no inactive filter. Filters combine with AND; on ccb each filter matches one endorsement row. Empty results are a successful empty page. - Instructions: Find an Oregon contractor by business or person name, licence number, city, ZIP, county or licence type, or poll CCB for licences and endorsements registered since a date. Call get_license with a record's license_number and source for its source rows. - Cost: 5 credits per call - Capability file: [Search contractors](https://firecrawl.dev/alexandria/agents/providers/data-oregon-gov/licenses/search_contractors) Accepted options: - `city` (string): City, exact and case-insensitive (`Portland`). Example: `` - `county` (string): County, exact and case-insensitive; a trailing `County` is ignored. CCB also uses `Out of State`. Example: `` - `cursor` (string): next_cursor from a previous call with the same filters. Example: `` - `expires_after` (string): Only licences with an endorsement (ccb) or licence (bcd) expiring after this date, YYYY-MM-DD. BCD rows without an expiration (most certifications) are excluded. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `issued_since` (string): ccb only. Licences with an endorsement first registered on or after this date, YYYY-MM-DD. Results are newest registration first, so this polls for new licences and endorsements. Both datasets are reloaded wholesale, so per-row update times cannot track changes. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `license_number` (string): Licence number, exact (CCB `28417` or `5001OCLS`, BCD `26-45C`); case-insensitive. Pattern: ^[A-Za-z0-9-]+$. Example: `28417` - `license_type` (string): Case-insensitive substring. ccb: endorsement code, e.g. RGC (residential general), RSC (residential specialty), CGC1/CGC2 (commercial general), CSC1/CSC2, RLC, LBPR (lead-based paint), OCHI (home inspector), OCLS (locksmith). bcd: licence type, e.g. `Plumbing Contractor`, `JP-Journeyman Plumber`, `C-Electrical Contractor`. Example: `Plumbing Contractor` - `limit` (number): Licences per page. Example: `25` - `name` (string): Case-insensitive substring of the licensee name; ccb also matches the responsible managing individual, bcd also DBA names. Must not contain % or _. Example: `` - `source` (string): `ccb`: Construction Contractors Board active licences (g77e-6bhs, daily). `bcd`: Building Codes Division active trade licences and certifications (vhbr-cuaq, monthly). Example: `ccb` - `specialty` (string): Case-insensitive substring. ccb: endorsement name (`Residential General`, `Home Inspector`). bcd: profession (Electrical, Plumbing, Boiler, Elevator, Prefab, Certification, Combo License, RV and Manuf Dwellings). Example: `Residential General` - `zip` (string): Five-digit ZIP code; also matches ZIP+4 entries. Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "count": 2, "dataset": { "id": "g77e-6bhs", "name": "CCB Active Licenses", "portal": "data.oregon.gov", "updated_at": "2026-10-27T17:04:21Z", "url": "https://data.oregon.gov/d/g77e-6bhs" }, "license": { "attribution": "Oregon Construction Contractors Board, CCB Active Licenses (data.oregon.gov dataset g77e-6bhs)", "name": "Public Domain U.S. Government", "url": "https://www.usa.gov/government-works" }, "next_cursor": null, "observed_at_ms": 1793141719581, "records": [ { "address": "5500 MEADOWS RD. STE 500", "bonds": [ { "amount_usd": 80000, "company": "FEDERAL INS CO", "effective_date": null, "expiration_date": "2028-04-07" }, { "amount_usd": 25000, "company": "FEDERAL INS CO", "effective_date": null, "expiration_date": "2028-04-07" } ], "business_name": "HOFFMAN CONSTRUCTION COMPANY OF OREGON", "city": "LAKE OSWEGO", "county": "Clackamas", "dba_names": null, "discipline": null, "effective_date": null, "endorsements": [ { "code": "CGC1", "expiration_date": "2028-04-07", "issue_date": "1979-04-25", "name": "Commercial General Contractor Level 1" }, { "code": "RGC", "expiration_date": "2028-04-07", "issue_date": "1979-04-25", "name": "Residential General Contractor" } ], "expiration_date": "2028-04-07", "insurance": [ { "amount_usd": 5000000, "company": "RRG - AMERICAN CONTRACTORS INS CO", "expiration_date": "2027-06-01" } ], "issue_date": "1979-04-25", "license": { "attribution": "Oregon Construction Contractors Board, CCB Active Licenses (data.oregon.gov dataset g77e-6bhs)", "name": "Public Domain U.S. Government", "url": "https://www.usa.gov/government-works" }, "license_number": "28417", "license_type": "CGC1, RGC", "person_name": null, "phone": "5032218811", "principals": [ { "name": "LEANNE HOIYEE LEGARE", "title": "Responsible Managing Individual" } ], "registry_id": null, "related_licenses": [], "source_url": "https://data.oregon.gov/resource/g77e-6bhs.json?license_number=28417", "specialties": [ "Commercial General Contractor Level 1", "Residential General Contractor" ], "state": "OR", "status": "active", "suspend_date": null, "zip": "97035" }, { "address": "5500 MEADOWS RD STE 500", "bonds": [ { "amount_usd": 80000, "company": "FEDERAL INS CO", "effective_date": null, "expiration_date": "2028-03-18" } ], "business_name": "HOFFMAN CONSTRUCTION COMPANY OF AMERICA", "city": "LAKE OSWEGO", "county": "Clackamas", "dba_names": null, "discipline": null, "effective_date": null, "endorsements": [ { "code": "CGC1", "expiration_date": "2028-03-18", "issue_date": "1972-07-01", "name": "Commercial General Contractor Level 1" } ], "expiration_date": "2028-03-18", "insurance": [ { "amount_usd": 5000000, "company": "RRG - AMERICAN CONTRACTORS INS CO", "expiration_date": "2027-06-01" } ], "issue_date": "1972-07-01", "license": { "attribution": "Oregon Construction Contractors Board, CCB Active Licenses (data.oregon.gov dataset g77e-6bhs)", "name": "Public Domain U.S. Government", "url": "https://www.usa.gov/government-works" }, "license_number": "3783", "license_type": "CGC1", "person_name": null, "phone": "5032218811", "principals": [ { "name": "LEANNE HOIYEE LEGARE", "title": "Responsible Managing Individual" } ], "registry_id": null, "related_licenses": [], "source_url": "https://data.oregon.gov/resource/g77e-6bhs.json?license_number=3783", "specialties": [ "Commercial General Contractor Level 1" ], "state": "OR", "status": "active", "suspend_date": null, "zip": "97035" } ], "source": "ccb", "source_url": "https://data.oregon.gov/resource/g77e-6bhs.json?%24select=license_number%2C+license_type+%3D+%27OCHI%27+AS+ochi%2C+max%28orig_regis_date%3A%3Afloating_timestamp%29+AS+latest&%24where=%28upper%28full_name%29+like+%27%25HOFFMAN+CONSTRUCTION+COMPANY%25%27+OR+upper%28rmi_name%29+like+%27%25HOFFMAN+CONSTRUCTION+COMPANY%25%27%29&%24group=license_number%2C+ochi&%24order=latest+DESC+NULL+LAST%2C+license_number%2C+ochi&%24limit=26" } ```