Skip to main content

​
Start here

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

West Virginia 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.

​
Table of Contents

​
Data Sources

West Virginia uses a single integration against the West Virginia Secretary of State, Business Organization Register. The register covers domestic and foreign corporations (for-profit, non-profit, and benefit), limited liability companies, professional LLCs, limited partnerships, general partnerships, voluntary associations, cooperatives, business trusts, and a set of administrative form types (trade names, name reservations, fictitious names, insurance companies, public corporations).
  • West Virginia Secretary of State, Business Organization Register (verification, primary). The official public register served by the Online Data Services portal. Each query reads live against the register and returns legal name, organization number, organization type, charter type (domestic / foreign), profit / non-profit / benefit class, effective and filing dates, status with termination reason, business purpose (a NAICS-based industry code with a full description), authorized shares, capital stock and par value, the registered office and registered-agent addresses, officers and directors with their addresses, registered trade names (DBAs), mergers, amendments, and annual-report filing history.
Sole proprietors and most general partnerships are out of scope at the state level. Trade names (DBAs) and mergers appear on the parent entity’s record rather than as standalone records.

​
Company Identifiers

​
Query Identifiers

Use the organization number as it appears on the portal, digits only. Input with a prefix such as WV- is not accepted.

​
Identifiers in API Response

GLEIF is the supplementary data source for this identifier. company.identifiers.lei is returned when a company identifier has a unique match against this jurisdiction’s registration or validation references in GLEIF. An LEI (Legal Entity Identifier) has 20 uppercase letters and digits, ending in two check digits. Coverage varies by entity. The field is omitted when no unambiguous match is available. Lapsed or retired LEIs may be returned; annulled records are excluded.

​
Search Capabilities

Name search returns up to 50 rows per query. Narrow with fuller query strings when the top of the result list looks too broad. The wildcard character % is also accepted (for example, %Gas Company%).

​
Active companies only

Search can return companies that are no longer active. Each result carries the register’s status, so activeOnly=true removes the inactive ones.

​
Quirks & Gotchas

​
Mappings

​
Entity Types

The Secretary of State uses a fixed organization-type taxonomy. Codes and labels are stable; the live mapping to standardized legal forms is on the pricing page. The register also lists administrative and regulated filing types outside this taxonomy (for example exempt entities, insurance companies, public corporations, sole proprietors, trademark holders, and fictitious names). When their label names a corporation, limited liability company, or partnership, that sets the standardized form; otherwise only the local name is returned, with no standardized form.

​
Status Codes

For an inactive entity, status.localName holds the termination reason recorded on the register (for example Dissolution by Court Order, Merger, Voluntary Dissolution (Domestic), LLC Termination (Domestic), Revoked (Failure to File Annual Report), Pending). When the register records a termination date but no reason, status.localName is Not Active. In both cases status.active is false.

​
Officer Roles

The Secretary of State records officers, directors, and other role-holders on each entity. We surface them as either legalRepresentatives (declared officer and management context, with company-specific powers unverified) or otherKeyPersons (the registered agent, LLC members, organizers, and incorporators). The registered agent (recorded on the entity as the “Notice of Process” address) is also surfaced as an otherKeyPersons entry with the standardized role Registered Agent.

​
Data Availability