> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.
# West Virginia (US)
> Country-specific identifiers, data sources, and integration details
## 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.
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](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Entity Types](#entity-types)
* [Status Codes](#status-codes)
* [Data Availability](#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. |