Hawaii

Start here

This guide contains public integration notes for Hawaii. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

Hawaii coverage, pricing, and sources

Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.

This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.

Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.

Data Sources
Company Identifiers
Search Capabilities
Quirks & Gotchas
Mappings
Ownership coverage
Data Availability

API access: Hawaii is in beta. US-HI is accepted by /v2/company and /v2/search, but it is not yet listed in the public countryCode enum of the OpenAPI spec.

Data Sources

Hawaii uses a single integration against the Hawaii Department of Commerce and Consumer Affairs, Business Registration Division (DCCA / BREG), surfaced through the Hawaii Business Express (HBE) portal. The register covers every entity type filed under the Hawaii Revised Statutes: domestic and foreign profit corporations, nonprofit corporations, professional corporations, sustainable business corporations, limited liability companies, general partnerships, limited partnerships, limited liability partnerships, limited liability limited partnerships, agricultural and consumer cooperatives, and the special Corporation Sole form.

DCCA / BREG detail page (live, authoritative). Every profile (legal name, file number, business type, status, registration date, principal and mailing addresses, term, registered agent, and the officer / director / manager / member / general partner roster) is read directly from the register at request time. Officers are on the public record per DCCA policy and appear without any paid order. The same record carries the ownership roster for the entity types where Hawaii publishes one, so shareholders costs no extra call — see Ownership coverage.

There is no open-data bulk feed for Hawaii. The Hawaii Open Data Portal entry for “Business Name Search” links back to the live HBE web search; no downloadable dataset exists. All data is fetched live from the register.

Company Identifiers

Query Identifiers

Identifier Type	Format	Example	Notes
Hawaii BREG File Number	1–7 digits followed by a two-character suffix (one letter + one digit)	`100001 D1`	Assigned by DCCA / BREG. The suffix encodes the entity type and domestic/foreign status (see table below).

The portal accepts both the display form with a space between the digits and the suffix (100001 D1) and the URL form without the space (100001D1). Both are valid when querying the Topograph API.

File Number Suffix Codes

The two-character suffix encodes both entity type and domestic vs. foreign status:

Suffix	Entity Type
`D1`	Domestic Profit Corporation
`D2`	Domestic Nonprofit Corporation
`D9`	Domestic Corporation Sole
`P1`	Professional Corporation
`S1`	Sustainable Business Corporation
`F1`	Foreign Profit Corporation
`F2`	Foreign Nonprofit Corporation
`C5`	Domestic Limited Liability Company
`C6`	Foreign Limited Liability Company
`G5`	Domestic General Partnership
`G6`	Foreign General Partnership
`L5`	Domestic Limited Partnership
`L6`	Foreign Limited Partnership
`K5`	Domestic Limited Liability Partnership
`K6`	Foreign Limited Liability Partnership
`Q5`	Domestic Limited Liability Limited Partnership
`Q6`	Foreign Limited Liability Limited Partnership
`A1`	Agricultural Cooperative With Stock
`A2`	Agricultural Cooperative Without Stock
`C1`	Consumer Cooperative With Stock
`C2`	Consumer Cooperative Without Stock

Q5 / Q6 are limited liability limited partnerships — limited partnerships that elected the status — not professional partnerships. The suffix therefore tells you whether ownership is published: see Ownership coverage below.

Identifiers in API Response

Identifier	Format	Example	Found In
`fileNumber`	1–7 digits + two-character suffix (compact form, no space)	`100001D1`	All entities

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By Name	2–200 chars	`"Aloha Holdings"`	Begins-with (case-insensitive)	Multiple results
By File Number	Digits + suffix	`100001D1`	Exact	Exact match returned first (`matchType: id`)

Name search matches the beginning of the entity’s master name. Using a more specific query string narrows the result set.

Quirks & Gotchas

Quirk	Details
File number suffix is load-bearing	The two-character suffix (`D1`, `C5`, etc.) is part of the identifier and encodes the legal form. Passing a bare numeric string without the suffix returns no match.
Space vs. no-space forms both work	The portal renders file numbers with a space (`100001 D1`); the URL omits it (`100001D1`). The API accepts both. The response uses the compact form without a space (`100001D1`).
Status carries the register’s code	The register renders each status as a label followed by a one-character code in parentheses, such as `Active (A)` or `Delinquent Status 1 (1)`. The string is returned as-is in `status.localName`, and `status.active` is derived from the code. Delinquent statuses (an overdue annual report) are still active.
”Not in good standing” is separate from status	An entity can have status `Active (A)` and still carry a “not in good standing” flag (for example, when the most recent annual report is delinquent). The standing flag does not change the `status` field.
LLC legal-form label has a lowercase suffix	The BREG page renders LLC types as `Domestic Limited Liability Company (llc)`. Topograph strips the `(llc)` suffix when mapping to the standardized legal form.
Officer codes are combinable	BREG concatenates codes with `/` when one person holds multiple roles (`P/D` = President + Director, `MGR/MEM` = Manager + Member). Each combined record is split into separate role entries in the API response.
Ownership depends on the entity type	Hawaii names owners for member-managed LLCs, general partnerships and limited liability partnerships, and for nobody else — a manager-managed LLC files only its managers and a member count, a corporation files aggregate share counts with no holder, and a limited partnership files only its general partners. Requesting `shareholders` for one of those returns an explanatory error rather than an empty list. No Hawaii filing carries an ownership percentage. UBO data is federal only (FinCEN BOI) and not public. See Ownership coverage.
No activity codes	The BREG does not collect NAICS, SIC, or any other industry classification code. The register only captures a free-text purpose field.
Annual filings are on the public record	Each entity shows a year-by-year filing history (Processed / Delinquent / Not Filed) on the BREG detail page. It appears on the Trade Register Extract, not as a field in the API response.
Paid documents: Certificate of Good Standing and Annual Filings	The Trade Register Extract is bundled with the company profile. Two paid documents are available separately: a Certificate of Good Standing (entities currently in good standing only) and the filed Annual Report for any year on record, ordered per year (see pricing page). Both are register-issued PDFs; the annual report is a scan of the filed form.

Mappings

Legal Forms

Legal form is derived from the BUSINESS TYPE field on the BREG detail page, a closed set of 21 entity types. The two-character file-number suffix independently encodes the same legal form.

All 21 Hawaii entity types

BREG Entity Type	Standardized	ISO 20275
Domestic Profit Corporation	Corporation	`L2QV`
Foreign Profit Corporation	Corporation	`L2QV`
Professional Corporation	Corporation
Sustainable Business Corporation	Corporation
Domestic Nonprofit Corporation	Nonprofit Organization	`DX2N`
Foreign Nonprofit Corporation	Nonprofit Organization	`DX2N`
Domestic Corporation Sole	Other
Domestic Limited Liability Company	Limited Liability Company	`VPBH`
Foreign Limited Liability Company	Limited Liability Company	`VPBH`
Domestic General Partnership	Partnership
Foreign General Partnership	Partnership
Domestic Limited Partnership	Partnership	`T91T`
Foreign Limited Partnership	Partnership	`T91T`
Domestic Limited Liability Partnership	Partnership
Foreign Limited Liability Partnership	Partnership
Domestic Limited Liability Limited Partnership	Partnership
Foreign Limited Liability Limited Partnership	Partnership
Agricultural Cooperative With Stock	Cooperative
Agricultural Cooperative Without Stock	Cooperative
Consumer Cooperative With Stock	Cooperative
Consumer Cooperative Without Stock	Cooperative

The ISO 20275 column is for reference: the API does not return iso20275Code for Hawaii. The full legal form table, including provenance, is on the pricing page.

Officer Roles

BREG uses a closed set of 22 base office codes, with additional ordinal variants for vice-president positions (1V–9V). Codes are concatenated with / when an officer holds multiple roles; the API splits compound entries into separate records.

Office Code	Role	Notes
`P`	President
`S`	Secretary
`T`	Treasurer
`D`	Director
`C`	Chairman / Chairwoman of the Board
`CEO`	Chief Executive Officer
`CFO`	Chief Financial Officer
`CO`	Comptroller / Controller
`AC`	Assistant Comptroller / Controller
`AS`	Assistant Secretary
`AT`	Assistant Treasurer
`EV`	Executive Vice President
`SRV`	Senior Vice President
`V`	Vice President
`1V`–`9V`	1st–9th Vice President
`VC`	Vice Chairman
`G`	General Partner
`L`	Limited Partner
`MGR`	Manager
`MEM`	Member	LLC-only; not in the BREG code legend but appears in compound codes
`R`	Trustee

Managers (MGR), Members (MEM), and General Partners (G) are all returned as Legal Representatives. Members and partners are additionally returned as shareholders where Hawaii law makes the published list a complete ownership list — see Ownership coverage. Managers never are: state law defines a manager as a person “whether or not a member”, so the title carries control, not equity. The registered agent is returned separately as an other key person and holds no statutory authority to bind the entity.

Entity Statuses

BREG Status	Active	Notes
`New (Y)`	Yes
`Active (A)`	Yes
`Delinquent Status 1 (1)`	Yes	Annual report overdue
`Delinquent Status 2 (2)`	Yes	Annual report overdue
`Adm. Terminated (V)`	No	Administratively terminated
`Terminated (T)`	No
`Withdrawn (W)`	No	Foreign entity withdrawn from Hawaii
`Cancelled (C)`	No
`Dissolved (D)`	No	Voluntarily dissolved
`Inv. Revoked (R)`	No	Involuntarily revoked
`Inv. Cancelled (X)`	No	Involuntarily cancelled
`Inv. Dissolved (7)`	No	Involuntarily dissolved
`Merged (M)`	No
`Converted (9)`	No	Converted to a different entity type
`Expired (E)`	No
`Inactive (I)`	No

The full status table with provenance is on the pricing page.

Ownership coverage

Hawaii publishes owners only where a statute both makes the title an ownership interest and requires the filing to name every holder. Where it does, the owners come back on the shareholders datapoint at no extra charge — they are read from the same entity record as the company profile.

Entity type	`shareholders` returns
Member-managed LLC (`C5` / `C6`)	Every member. The annual report of a member-managed company must give the name and address of each member, so the list is complete. A single member is reported at 100%
General partnership (`G5` / `G6`)	Every partner. The registration statement and every annual statement must name each partner
Limited liability partnership (`K5` / `K6`)	Every partner. The annual report must name each partner
Manager-managed LLC (`C5` / `C6`)	An explanatory error. A manager-managed company files its managers and the number of its members, never their names. The managers are returned under `legalRepresentatives`
Corporation (`D1` / `F1` / `P1` / `S1`)	An explanatory error. The annual report carries directors, officers and the total authorised and issued share counts by class — never a holder. Directors and officers are returned under `legalRepresentatives`
Limited partnership and LLLP (`L5` / `L6` / `Q5` / `Q6`)	An explanatory error. Only the general partners are filed; the limited partners are named in a partnership agreement that is never filed
Cooperative (`A1` / `A2` / `C1` / `C2`)	An explanatory error. A cooperative reports only how many members or shareholders it has
Non-profit corporation (`D2` / `F2`)	A not-applicable result — a non-profit has no share capital. Officers and board members are returned under `legalRepresentatives`

The paid Annual Filing adds no ownership detail. The filed report lists its members by name and address and carries no percentage, share count or capital contribution — there is no such field on the form — so shareholders already returns everything it discloses. Order it as evidence of what was filed, not to obtain ownership data.The filing does state the date its contents are effective from (“as of” the quarterly anchor date set by the entity’s registration quarter). That date is not currently returned on the shareholders datapoint.

A member-managed LLC that has filed no member — a missing annual report, or a record whose management designation and filed roster disagree — returns the same explanatory error rather than an empty list. The people it has filed are still returned under legalRepresentatives.

No percentages exist. No Hawaii filing carries an ownership percentage, a share count or a capital amount for an LLC or a partnership, so sharePercentage is empty — with one exception: the single member of a member-managed LLC is reported at 100%, because state law makes that filed list the complete membership. Two or more owners are returned with no split. A general partnership or LLP whose public roster names only one partner is refused rather than reported as a sole owner.

Data Availability

Data Point	Available	Notes
Company name	Yes	Current legal name (master name on the BREG record)
Company status	Yes	BREG status label with its code, plus an `active` flag
Registration date	Yes	Initial filing date with DCCA / BREG
Legal address	Yes	Principal address (street, city, state, ZIP)
Mailing address	Partial	Used as the legal address only when no principal address is filed; not returned separately
Legal form	Yes	Closed 21-value BREG taxonomy with a standardized category
Legal representatives	Yes	Officers, directors, managers, general partners, and members filed with the entity
Registered agent	Yes	Returned as an other key person (name, type, and address)
Trade Register Extract	Yes	Register-issued PDF of the BREG detail page, bundled with the company profile at no extra charge
Certificate of Good Standing	Yes (paid)	Issued by DCCA / BREG for entities currently in good standing; available as a paid document (see pricing page)
Annual filing history	No	Not returned as a field. The year-by-year filing status appears on the Trade Register Extract
Annual Filing (filed report PDF)	Yes (paid)	The register’s own scan of a filed annual report, orderable per year for every year on record. Useful as evidence of what was filed; it carries no ownership detail beyond what `shareholders` already returns (see pricing page)
Activity codes	No	Not collected by the BREG
Shareholders	Partial	Members of member-managed LLCs, and partners of general and limited liability partnerships. Never for corporations, manager-managed LLCs, limited partnerships or cooperatives — see Ownership coverage
UBOs	No	Not published at the state level; federal FinCEN BOI records are restricted
Financial data	No	Not collected

Example API Responses

Search by Name

curl -X GET "https://api.topograph.co/v2/search?country=US-HI&query=Aloha+Holdings" \
  -H "x-api-key: YOUR_API_KEY"

[
  {
    "id": "100001D1",
    "legalName": "ALOHA HOLDINGS, INC.",
    "countryCode": "US-HI",
    "matchReason": {
      "matchType": "default"
    }
  }
]

Search by File Number

curl -X GET "https://api.topograph.co/v2/search?country=US-HI&query=100001D1" \
  -H "x-api-key: YOUR_API_KEY"

[
  {
    "id": "100001D1",
    "legalName": "ALOHA HOLDINGS, INC.",
    "countryCode": "US-HI",
    "matchReason": {
      "matchType": "id"
    }
  }
]

Company Profile

curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-HI", "id": "100001 D1", "dataPoints": ["company", "legalRepresentatives"]}'

{
  "company": {
    "id": "100001D1",
    "countryCode": "US-HI",
    "identifiers": { "fileNumber": "100001D1" },
    "legalName": "ALOHA HOLDINGS, INC.",
    "status": {
      "localName": "Active (A)",
      "active": true
    },
    "registrationDate": "2005-06-01",
    "legalForm": {
      "localName": "Domestic Profit Corporation",
      "englishTranslation": "Domestic Profit Corporation",
      "standardized": "Corporation"
    },
    "legalAddress": {
      "addressLine1": "1 Example Street",
      "city": "Honolulu",
      "region": "HI",
      "postalCode": "96813",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": { "localName": "President", "standardized": "President" },
      "individual": { "name": { "fullName": "Jane K. Sample" } }
    },
    {
      "type": "individual",
      "role": { "localName": "Director", "standardized": "Director" },
      "individual": { "name": { "fullName": "Jane K. Sample" } }
    }
  ]
}

Europe

North America

Asia

Offshore Centers

Start here

Hawaii coverage, pricing, and sources

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

File Number Suffix Codes

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Legal Forms

Officer Roles

Entity Statuses

Ownership coverage

Data Availability

Example API Responses

Search by Name

Search by File Number

Company Profile

​Start here

Hawaii coverage, pricing, and sources

​Table of Contents

​Data Sources

​Company Identifiers

​Query Identifiers

​File Number Suffix Codes

​Identifiers in API Response

​Search Capabilities

​Quirks & Gotchas

​Mappings

​Legal Forms

​Officer Roles

​Entity Statuses

​Ownership coverage

​Data Availability

​Example API Responses

​Search by Name

​Search by File Number

​Company Profile

Start here

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

File Number Suffix Codes

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Legal Forms

Officer Roles

Entity Statuses

Ownership coverage

Data Availability

Example API Responses

Search by Name

Search by File Number

Company Profile