Virginia - Topograph

Start here

This guide contains public integration notes for 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, roles, and status values is the pricing page.

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
- Legal Forms
- Officer Roles
Data Availability

API access: US-VA is not yet part of the public countryCode enum. Contact us to enable it on your workspace. Requests sent with countryCode: "US-VA" will otherwise return 400 until the enum is expanded.

Data Sources

Virginia uses a single integration against the Virginia State Corporation Commission (SCC) Clerk’s Information System (CIS) at https://cis.scc.virginia.gov/. The public search interface is available without authentication and covers every entity on file with the SCC. The entity detail page returns the entity name, SCC ID, entity type, status and reason for status, formation date, Virginia qualification date, period of duration, industry code, jurisdiction, principal office address, and the current registered agent. For stock corporations, the detail page additionally publishes the officer and director roster (title, name, address, last-updated date) and total share count. For limited liability companies and limited partnerships, only the registered agent is published. Data is retrieved live from the SCC portal on every request. There is no open-data extract or snapshot for Virginia: both onboarding and verification mode use the same live source.

Company Identifiers

Query Identifiers

Identifier Type	Format	Example	Notes
SCC ID	Alphanumeric, up to 8 characters	`02937985`	Primary identifier assigned by the Virginia SCC.

The SCC ID format varies by entity family. Records created through the modern CIS pipeline carry a one-letter prefix followed by a 7-digit serial: S for domestic LLCs, T for foreign LLCs, F for foreign stock corporations, and M for limited partnerships. Older domestic stock and nonstock corporations use a prefix-free numeric form with leading zeros preserved (for example, 02937985). Always pass the full canonical form including any leading zeros or letter prefix.

Identifiers in API Response

Identifier	Format	Example	Found In
`entityId`	Alphanumeric, up to 8 characters	`02937985`	All entities

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By Name	2-100 chars	`"Markel"`	Starts-with (case-insensitive)	Multiple results
By SCC ID	Alphanumeric, up to 8 chars	`02937985`	Exact	Exact match returned first (`matchType: id`); other results may follow

Starts-with search. Name search anchors on the beginning of the legal name and is case-insensitive. Use fuller query strings to narrow the result set, which is capped at 50 matches.

Legal name casing. The SCC stores LLC names in title case and stock corporation names in uppercase. Search results normalize everything to uppercase; the company profile returns the name in the casing stored by the register.

Quirks & Gotchas

Quirk	Details
SCC ID is alphanumeric	The identifier is not always numeric. Domestic LLCs begin with `S`, foreign LLCs with `T`, foreign stock corporations with `F`, and limited partnerships with `M`. Older domestic corporations use a prefix-free 8-digit numeric form. Pass the full form exactly as returned by search.
Leading zeros are significant	Older domestic corporations (no letter prefix) have IDs such as `02937985` with leading zeros. These must be preserved. `02937985` and `2937985` are not equivalent.
Officer disclosure varies by entity type	Stock corporations publish officers, directors, and total share count. Limited liability companies and limited partnerships publish only the registered agent. Members, managers, and general partners are not disclosed by the Virginia register for any entity type.
No open-data extract	The Virginia SCC does not publish the business entity register as open data. Every request fetches live data from the SCC portal.
No shareholders or UBOs	Shareholder lists and beneficial ownership information are not published by the Virginia register for any entity type.
Industry code is coarse	The SCC publishes a single-digit industry code (for example, `35 - Insurance Agencies`) rather than NAICS, NACE, or ISIC codes.
Fictitious names roll up to a parent entity	Fictitious name registrations in Virginia are tied to a parent entity and resolved through it. They are not indexed as standalone entities.
Name casing differs between search and profile	The search grid normalizes all names to uppercase. The profile response returns the stored casing, which is uppercase for corporations and title case for LLCs.

Mappings

Legal Forms

The SCC publishes an open-vocabulary entity type label on every entity. Observed values include Stock Corporation, Nonstock Corporation, Limited Liability Company, Series LLC, Limited Partnership, and their foreign equivalents. Each value surfaces verbatim as legalForm.localName and is mapped to a standardized Topograph category. A full list of observed entity types is available on the pricing page.

Officer Roles

Officer titles on stock corporation detail pages are open vocabulary (for example, President, Vice President, Secretary, Treasurer, Director). Each raw title is mapped to a standardized role label through AI enrichment. The registered agent is classified as an Other Key Person; it receives service of process and is disclosed for every entity type regardless of the entity’s officer-disclosure ceiling.

For LLCs and limited partnerships, legalRepresentatives contains only the registered agent. There is no separate officer or manager disclosure for these entity types in the Virginia register.

Data Availability

Data Point	Available	Notes
Company name	Yes	Current legal name as stored by the SCC
Company status	Yes	Active or inactive, with reason for status
Registration / formation date	Yes	SCC initial filing date
Virginia qualification date	Yes	Date a foreign entity qualified to do business in Virginia
Legal address	Yes	Principal office address
Legal form	Yes	SCC entity type label with standardized mapping
Registered agent	Yes	Name and address of the current registered agent
Officers / directors	Yes (stock corps only)	Not disclosed for LLCs or limited partnerships
Total shares	Yes (stock corps only)	Not disclosed for other entity types
Activity codes	Partial	Coarse single-digit SCC industry code only; no NAICS / NACE / ISIC
Trade Register Extract	Yes	Printed PDF of the SCC entity detail page, included at no extra charge
Certificate of Good Standing	No	Ordered separately from the SCC; not yet available through Topograph
Shareholders	No	Not published by the Virginia register
UBOs	No	No public beneficial ownership register at the Virginia state level
Financial data	No	Not collected by the SCC
Tax ID (EIN)	No	Held by the Virginia Department of Taxation; not disclosed publicly

Example API Responses

Search by Name

curl -X POST "https://api.topograph.co/v2/search?country=US-VA&query=Markel" \
  -H "x-api-key: YOUR_API_KEY"

[
  {
    "id": "02937985",
    "legalName": "MARKEL AMERICAN INSURANCE COMPANY",
    "countryCode": "US-VA",
    "matchReason": {
      "matchType": "default"
    },
    "address": {
      "region": "VA",
      "countryCode": "US"
    }
  }
]

Search by SCC ID

curl -X POST "https://api.topograph.co/v2/search?country=US-VA&query=02937985" \
  -H "x-api-key: YOUR_API_KEY"

[
  {
    "id": "02937985",
    "legalName": "MARKEL AMERICAN INSURANCE COMPANY",
    "countryCode": "US-VA",
    "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-VA", "id": "02937985", "dataPoints": ["company", "legalRepresentatives"]}'

{
  "company": {
    "id": "02937985",
    "countryCode": "US-VA",
    "identifiers": { "entityId": "02937985" },
    "legalName": "SAMPLE INSURANCE COMPANY",
    "registrationDate": "1988-01-15",
    "legalForm": {
      "localName": "Stock Corporation",
      "standardized": "Corporation"
    },
    "status": {
      "localName": "Active",
      "standardized": "Active"
    },
    "legalAddress": {
      "street": "4521 Corporate Drive",
      "city": "Glen Allen",
      "region": "VA",
      "postalCode": "23060",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [
    {
      "name": "Jane A. Smith",
      "role": {
        "localName": "President",
        "standardized": "President"
      }
    }
  ]
}

Data Availability

The full list of supported datapoints, documents, modes, and sources is on the Virginia pricing page.

​Start here

Virginia coverage, pricing, and sources

​Table of Contents

​Data Sources

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Search Capabilities

​Quirks & Gotchas

​Mappings

​Legal Forms

​Officer Roles

​Data Availability

​Example API Responses

​Search by Name

​Search by SCC ID

​Company Profile

​Data Availability

Start here

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Legal Forms

Officer Roles

Data Availability

Example API Responses

Search by Name

Search by SCC ID

Company Profile

Data Availability