West Virginia (US)

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.

Data Sources
Company Identifiers
Search Capabilities
Quirks & Gotchas
Mappings
- Entity Types
- Status Codes
Data Availability

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.

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

Identifier Type	Format	Example	Notes
WV Organization Number	Numeric, up to 10 digits, no separators	`20122`	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).

Identifiers in API Response

Identifier	Format	Example	Found In
`orgNumber`	Numeric, up to 10 digits	`20122`	All entities

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By Name	2-200 characters	`"Mountaineer Gas"`	Substring (case-insensitive)	Up to 50
By WV Organization Number	Up to 10 digits	`20122`	Exact	Exact match returned first (matchType: id); other results may follow

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%).

Quirks & Gotchas

Quirk	Details
Organization number is numeric	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.

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.

Code	Label	Standardized Form
`C`	Corporation	Corporation
`LLC`	Limited Liability Company	Limited Liability Company
`PLC`	Professional Limited Liability Company	Limited Liability Company
`LP`	Limited Partnership	Partnership
`GP`	General Partnership	Partnership
`LLP`	Limited Liability Partnership	Partnership
`VA`	Voluntary Association	Other
`BC`	Benefit Corporation	Corporation
`BT`	Business Trust	Trust
`CA`	Cooperative Association	Cooperative
`EC`	Exempt Corporation	Corporation
`ELLC`	Exempt Limited Liability Company	Limited Liability Company
`ELP`	Exempt Limited Partnership	Partnership
`IC`	Insurance Company	Corporation
`LRA`	Land Reuse Agency	Other
`LCF`	Litigation Financier	Other
`PC`	Public Corporation	Corporation
`PFP`	Purchaser of Future Payments	Other
`SP`	Sole Proprietor	Sole Proprietor
`TM`	Trademark Holder	Other (name reservation)
`UNO`	Unincorporated Non-profit Organization	Nonprofit Organization
`CSO`	Credit Service Organization	Other
`DC`	Debt Collector	Other
`FN`	Fictitious Name	Other (name reservation)

Status Codes

Code	Local Name	Active
`Active`	Active	Yes
`Not Active`	Not Active	No

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.

Officer Roles

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.

Data Availability

Datapoint	Available	Notes
Company profile	Yes	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.

Europe

North America

Asia

Offshore Centers

West Virginia (US)

Start here

West Virginia coverage, pricing, and sources

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Entity Types

Status Codes

Officer Roles

Data Availability

​Start here

West Virginia coverage, pricing, and sources

​Table of Contents

​Data Sources

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Search Capabilities

​Quirks & Gotchas

​Mappings

​Entity Types

​Status Codes

​Officer Roles

​Data Availability

Start here

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Entity Types

Status Codes

Officer Roles

Data Availability