Hawaii Business Express Scraper

Search Hawaii's DCCA Business Registration Division free public business registry (hbe.dcca.hawaii.gov, "Hawaii Business Express"). Look up a business by name, exact file number, or a record ID from a previous run, and get entity type, status, registered agent, principal/mailing address, officers/members, annual filing history, and — for Trade Names, Trademarks, Service Marks, and Publicity Rights Names — registrant and certificate detail. Plain JSON API — no login, no CAPTCHA.

Data Source & Usage Notes

Read this before running a large job.

• No login, no CAPTCHA. The public "Search & Buy" page on Hawaii Business Express calls two plain, unauthenticated JSON endpoints (getSearchResults and getBusinessDetailsWrapper) under /webruntime/api/apex/execute?asGuest=true. Confirmed live from this environment with no session cookie, no Referer, and no proxy — both endpoints return real data to a bare HTTP client.
• Conservative by design. The actor only ever uses Apify's free datacenter (AUTO) proxy group as a fallback if a request is ever temporarily blocked — never a paid residential proxy.
• Not affiliated with the State of Hawaii. This is an independent third-party tool using the source's own public, no-login search API.

Why Hawaii instead of California?

This actor was originally scoped as a California SOS (bizfileonline.sos.ca.gov) business search. Live verification confirmed the site is blocked at every anti-bot tier tried:

• Plain httpx GET to the homepage and to POST /api/Records/businesssearch → hard 403 "Request unsuccessful. Incapsula incident ID: ..."
• curl_cffi with Chrome-131 TLS/JA3 impersonation → identical 403 Incapsula block page
• A real headless Chromium (Playwright) loading the search page directly → identical 403 Incapsula block page, with no JS challenge offered to solve — Incapsula is rejecting the request outright, not merely rate-limiting

Per this project's zero-cost reliability policy, the target was replaced with Hawaii's DCCA Business Registration Division search — a real, free, no-login, no-CAPTCHA state business registry in the same category (state business entity/trade-name registry lookup), confirmed live and returning real, detailed search results with no proxy required.

What this actor does

• 3 search modes:
  • search — business/trade name lookup, begins-with or contains matching
  • byFileNumber — exact Hawaii file number lookup
  • byEntityId — direct detail fetch for one or more record IDs (e.g. from a previous run's recordId field), skipping the name search entirely
• 3 finite-value filters, usable on search and byFileNumber, matching the source's own dropdowns:
  • recordType — Entity, Trade Name, Trademark, Service Mark, Publicity Rights Name, Pending Filing
  • status — all 16 registration statuses the source tracks (Active, Dissolved, Delinquent Status 1/2, Withdrawn, etc.)
  • entityType — Cooperative, Corporation, Limited Liability Company, Partnership, Other
• Full detail enrichment (includeDetails, on by default) — for each match, fetches business type, registered agent, principal/mailing address, managed-by, good-standing status, officers/members, annual filing history, other filing history, and purchasable-document list
• Works for both entities and marks — Trade Names, Trademarks, and Service Marks return registrant, certificate number, and expiration date instead of registered-agent fields
• Empty fields are omitted

What's NOT included (and why)

• Purchasing/downloading filed documents — the source lists which documents are available to buy (availableDocuments, with price), but actually purchasing a certified copy requires payment on the state's own portal. This actor surfaces the free metadata only.
• New business filing forms — the source's "file an amendment/change" form catalog is a transactional feature (creating filings), out of scope for a read-only search scraper.

Output per record

• businessName, fileNumber, certificationNumber (Trade Name/Trademark/Service Mark)
• recordId — Salesforce record ID; reusable with mode=byEntityId
• recordType — e.g. Entity, Trade Name, Trademark
• status, markType, createdDate, expirationDate
• entityName, entityTypeLabel, entityTypeValue
• isInGoodStanding, goodStandingMessage
• businessType, organizedIn, registrationDate
• principalAddress, mailingAddress, managedBy
• registeredAgentName, registeredAgentAddress, isCommercialRegisteredAgent
• natureOfBusiness, registrant, tradeName, certificateNumber
• officers — list of {name, role, title, type, startDate, address}
• annualFilings — list of {filingYear, status, receivedDate}
• filingHistory — list of {effectiveDate, description, transactionCode}
• availableDocuments — list of {name, type, effectiveDate, availability, purchasePrice, certifyPrice}
• sourceUrl
• recordType: "businessRecord" (top-level record-kind stamp), scrapedAt

Input

Field	Type	Console prefill	Description
mode	string	search	search / byFileNumber / byEntityId
query	string	aloha	mode=search — business/trade name. No forced default via API - required in search mode
matchType	string	begins	mode=search — begins or contains
fileNumber	string	–	mode=byFileNumber — exact file number
entityIds	string	–	mode=byEntityId — comma/newline-separated record IDs
recordType	string	all	Optional record-type filter
status	string	all	Optional status filter
entityType	string	all	Optional entity-type filter
includeDetails	boolean	true	Fetch full detail per matched record
proxyConfiguration	object	AUTO proxy	Apify proxy config; always datacenter (AUTO), never residential
maxItems	int	20	Hard cap (1–500)

Example: search by business name

{
  "mode": "search",
  "query": "aloha",
  "maxItems": 20
}

Example: search by exact file number

{
  "mode": "byFileNumber",
  "fileNumber": "256912C5"
}

Example: filtered search (active LLCs only)

{
  "mode": "search",
  "query": "aloha",
  "recordType": "Entity",
  "status": "Active (A)",
  "entityType": "Limited Liability Company",
  "maxItems": 25
}

Example: direct record-ID lookup

{
  "mode": "byEntityId",
  "entityIds": "001t000000hKCeyAAG, a55cs00002LOd12AAD"
}

Use cases

• Due diligence — confirm a counterparty's Hawaii registration status, registered agent, and officers before contracting
• Compliance & KYC — cross-check a business's legal entity name, file number, and good-standing status
• Trade name / trademark clearance — see what similarly-named trade names, trademarks, or service marks already exist before choosing a new one
• Registered agent research — identify a specific entity's registered agent and address
• Annual filing / compliance tracking — review an entity's annual filing history and current good-standing status

FAQ

What's the data source? The Hawaii DCCA Business Registration Division's own free public business registry search at hbe.dcca.hawaii.gov. This actor is an independent third-party tool and is not affiliated with the State of Hawaii.

Is this data official / legally binding? No. For a certified copy or official Certificate of Good Standing, use the state's own paid ordering channels. This actor returns the same free public search/detail data the site's own search page shows.

Why did my run return 0 results? The query genuinely has no match under the chosen filters. Try matchType: "contains" for a broader search, or reset recordType/status/entityType to all.

What's recordId used for? It's the source's own internal Salesforce record ID. Save it from a search run's output to re-fetch the same record's full detail later via mode: "byEntityId" without re-running the name search.

How fresh is the data? Real-time — the search reflects the Business Registration Division's database as of the moment of the search.