> ## 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.
# Virginia
> Country-specific identifiers, data sources, and integration details
## 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.
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)
* [Legal Forms](#legal-forms)
* [Officer Roles](#officer-roles)
* [Data Availability](#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](https://topograph.co/pricing/us-va).
### 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
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-VA&query=Markel" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "02937985",
"legalName": "MARKEL AMERICAN INSURANCE COMPANY",
"countryCode": "US-VA",
"matchReason": {
"matchType": "default"
},
"address": {
"region": "VA",
"countryCode": "US"
}
}
]
```
### Search by SCC ID
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-VA&query=02937985" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "02937985",
"legalName": "MARKEL AMERICAN INSURANCE COMPANY",
"countryCode": "US-VA",
"matchReason": {
"matchType": "id"
}
}
]
```
### Company Profile
```bash theme={null}
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"]}'
```
```json theme={null}
{
"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](https://topograph.co/pricing/us-va).