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.
API access:US-WV is not yet part of the public countryCode enum. Contact us to enable it on your workspace. Requests sent with countryCode: "US-WV" will otherwise return 400 until the enum is expanded.
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.
Assigned by the Secretary of State at filing. Also shown as “Org Id” on the portal.
Use the organization number as it appears on the portal. The number is numeric only and is normalized to digits before search (any WV- prefix or whitespace is stripped).
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%).
West Virginia does not use a letter prefix on its organization number (unlike states such as Montana or Wisconsin). The plain digit string returned in the response is the canonical identifier.
No shareholder or UBO register
West Virginia does not publish shareholders or beneficial owners for any entity type. Federal FinCEN beneficial-ownership records are restricted and are not part of this dataset.
LLC member and manager rosters are filed
For LLCs, the Secretary of State records each member, manager, and organizer on the formation filing. They are surfaced as otherKeyPersons rather than as shareholders, since no ownership percentages are collected.
Business purpose uses a NAICS-based code
The “Business Purpose” field on the record is a four-digit code with a three-level description, drawn from the North American Industry Classification System. Standardized NACE / ISIC codes are not collected by the state.
Charter type Domestic vs Foreign
Every entity is flagged as either Domestic (formed in West Virginia) or Foreign (formed elsewhere and registered to transact business in West Virginia). Foreign entities carry the charter state on the record.
Termination reason carries the detail
The top-level status is binary (Active / Not Active), so the termination reason is the richer signal: Dissolution by Court Order, Merger, Voluntary Dissolution, LLC Termination, Revoked (Failure to File Annual Report), Pending, and others.
Certificate of Existence eligibility
The official Certificate of Existence can only be issued for entities that are Active and in good standing on the register. Inactive, revoked, or non-compliant entities are not eligible. Pricing and availability are on the live pricing page.
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 richer signal comes from the termination reason, present only on inactive records: Dissolution by Court Order, Merger, Voluntary Dissolution (Domestic), LLC Termination (Domestic), Revoked (Failure to File Annual Report), Pending.
The Secretary of State records officers, directors, and other role-holders on each entity. We surface them as either legalRepresentatives (the people with binding signing authority) or otherKeyPersons (the registered agent, LLC members, organizers, and incorporators).
Local Role
Mapped To
President
legalRepresentatives
Vice-President
legalRepresentatives
Secretary
legalRepresentatives
Treasurer
legalRepresentatives
Director
legalRepresentatives
Manager
otherKeyPersons
Member
otherKeyPersons
Organizer
otherKeyPersons
Incorporator
otherKeyPersons
The registered agent (recorded on the entity as the “Notice of Process” address) is also surfaced as an otherKeyPersons entry with the role registeredAgent.
Legal name, organization number, type, charter type, profit / non-profit / benefit class, dates, status, business purpose, capital, addresses.
Registered agent
Yes
Returned as otherKeyPersons with the role registeredAgent. Includes name and full address.
Legal representatives
Yes
Officers and directors (President, Vice-President, Secretary, Treasurer, Director) are surfaced as legalRepresentatives with their addresses.
Other key persons
Yes
LLC members, managers, organizers, incorporators, and the registered agent.
Shareholders
No
Not collected by West Virginia at the state level.
Ultimate beneficial owners
No
West Virginia does not maintain a public beneficial-ownership register.
Activity codes
Partial
A NAICS-based “Business Purpose” code with description is returned as a local code. Standardized NACE / ISIC mappings are not part of the state record.
Trade Register Extract
Yes
Printable PDF of the Secretary of State entity detail page, captured at request time. Bundled with the company-data block at no extra charge.
Certificate of Existence
Yes
Official PDF issued by the Secretary of State for entities that are Active and in good standing. Pricing and availability are on the live pricing page.
