> ## 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.
# Vermont
> Country-specific identifiers, data sources, and integration details
## Start here
This guide contains public integration notes for Vermont. 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)
* [Entity Statuses](#entity-statuses)
* [Data Availability](#data-availability)
**API access:** `US-VT` is not yet part of the public `countryCode` enum. Contact us to enable it on your workspace. Requests sent with `countryCode: "US-VT"` will otherwise return `400` until the enum is expanded.
## Data Sources
Vermont uses a single integration against the **Vermont Secretary of State Business Services Division**, available at `bizfilings.vermont.gov`. The portal covers every entity type filed in Vermont: domestic and foreign business corporations, nonprofit corporations, limited liability companies, limited partnerships, mutual benefit enterprises, cooperative associations, general partnerships, limited liability partnerships, unincorporated nonprofit associations, plus assumed names, reserved names, and registered names.
Every request resolves live against the SoS portal. Vermont does not publish a free open-data feed for business entities, so there is no non-authoritative fast path.
The Vermont SoS portal is the only source for Vermont entity data. The **Trade Register Extract** (a printed PDF rendered from the live structured profile) is included in the same call at no extra charge.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| ----------------- | ------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Record Number** | 1–6 digit numeric string, zero-padded to 6 digits | `074657` | Primary SoS-assigned identifier. Unique across all filing types. Both padded and unpadded forms accepted; Topograph standardises on the 6-digit zero-padded form. |
The Record Number is the identifier printed on SoS documents and shown on the portal search results page. Pass it as-is (with or without leading zeros) and Topograph will normalise it.
### Identifiers in API Response
| Identifier | Format | Example | Found In |
| -------------- | ---------------------------------- | -------------------------------------- | ------------ |
| `entityId` | 6-digit zero-padded numeric string | `074657` | All entities |
| `vtIdBusiness` | UUID | `3fa85f64-5717-4562-b3fc-2c963f66afa6` | All entities |
`vtIdBusiness` is the internal UUID used by the Vermont SoS portal to key the structured profile and filing-history endpoints. It is returned alongside the Record Number for reference but is not the primary identifier.
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| ------------------ | ----------- | -------------------- | --------------------------- | -------------------------------------------- |
| By Name (contains) | 2–100 chars | `"Vermont Creamery"` | Contains (case-insensitive) | Multiple results |
| By Record Number | 1–6 digits | `074657` | Exact | Exact match returned first (`matchType: id`) |
**Contains search.** Name search uses a contains strategy: it matches any entity whose name includes the query string. Results are capped at 25 per page. Use more specific strings to narrow the result set.
## Quirks & Gotchas
| Quirk | Details |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Record Number vs UUID** | The portal assigns two keys to every entity: the customer-facing Record Number (6-digit padded integer, e.g. `074657`) and an internal UUID. Topograph exposes both; use `entityId` for lookups and display, `vtIdBusiness` for reference only. |
| **No shareholders or UBO data** | Vermont does not publicly disclose equity ownership for corporations or LLCs. The SoS collects officers, directors, and members but not ownership percentages. |
| **No federal tax ID (FEIN)** | The federal Employer Identification Number is not disclosed through the Vermont public business register. |
| **Filing images not available** | Filing-history metadata (annual reports, articles of amendment, registered-agent changes) is returned in the structured response, but the underlying PDF images are not exposed by the public portal API. Only the Trade Register Extract is downloadable today. |
| **Free-text "Other" officer title** | When an officer holds a title that does not match a standard code, the portal stores it in a free-text slot. Topograph preserves the raw value in `role.localName` when no standard mapping applies. |
| **No open-data bulk extract** | Vermont does not publish a free bulk dataset of registered business entities. Every request resolves live against the portal. |
| **Assumed names and reserved names are indexed** | The search index includes assumed names (`Assumed Name` entity type), reserved names, and registered names alongside standard entity filings. Filter by `entityType` if you need only active registered businesses. |
| **Annual report drives officer freshness** | Officer data reflects the most recent annual report filing. Entities that have not filed recently may carry older officer records. |
## Mappings
### Legal Forms
Vermont recognises 18 entity types across the search and profile endpoints. The full table with Topograph standardized labels and ISO 20275 codes (where available) is on the pricing page.
| SoS Entity Type | Standardized |
| --------------------------------------------- | ----------------------- |
| Domestic Business Corporation | Corporation |
| Foreign Business Corporation | Corporation |
| Domestic Nonprofit Corporation | NonprofitOrganization |
| Foreign Nonprofit Corporation | NonprofitOrganization |
| Domestic Limited Liability Company | LimitedLiabilityCompany |
| Foreign Limited Liability Company | LimitedLiabilityCompany |
| Domestic Limited Partnership | Partnership |
| Foreign Limited Partnership | Partnership |
| Domestic Partnership | Partnership |
| Foreign Partnership | Partnership |
| Domestic Cooperative Association | Cooperative |
| Domestic Mutual Benefit Enterprise | NonprofitOrganization |
| Foreign Mutual Benefit Enterprise | NonprofitOrganization |
| Domestic Unincorporated Nonprofit Association | NonprofitOrganization |
| Foreign Unincorporated Nonprofit Association | NonprofitOrganization |
| Reserved Name | Other |
| Registered Name | Other |
| Assumed Name | Other |
Vermont also uses sub-classification election types for certain entities (Benefit Corporation, Professional, Low-Profit LLC, Blockchain-Based LLC, Worker Cooperative, etc.). These are surfaced as annotations where available.
### Officer Roles
The SoS portal carries a `titleDescription` field with a controlled set of values, plus a free-text `otherTitle` slot for non-standard titles. Topograph normalizes them to a standardized role label.
| Common Title | Standardized | Notes |
| --------------- | -------------- | ------------------------------------------------------------------------------------------------ |
| President | President | Statutory corporation officer |
| Vice President | VicePresident | |
| Secretary | Secretary | |
| Treasurer | Treasurer | |
| Director | Director | Corporation board member |
| Manager | Manager | LLC manager-managed structure |
| Managing Member | Member | LLC managing-member variant |
| Member | Member | LLC member (member-managed structures) |
| General Partner | GeneralPartner | Limited partnerships |
| Organizer | Incorporator | Initial organizer for LLCs and corporations |
| Other | AI-inferred | Free-text slot. Topograph preserves the raw value and infers a standardized role where possible. |
Officers and directors surface under `legalRepresentatives`. The registered agent and organizers (plus any principal whose title does not map to an executive role) surface under `otherKeyPersons`.
### Entity Statuses
The Vermont register exposes a rich status vocabulary. The broad families are:
| Status Family | Examples |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Active | Active - In Good Standing, Active - NOT In Good Standing |
| Inactive | Inactive - Voluntarily Dissolved, Inactive - Administratively Terminated, Inactive - Withdrawn, Inactive - Cancelled, Inactive - Cessated, Inactive - Dissolved, Inactive - Merged, Inactive - Revoked, Inactive - Expired |
| Pending | Pending (various sub-types) |
| Cancelled / Revoked | Cancelled, Revoked |
The full list of 37 distinct status values is on the [pricing page](https://topograph.co/pricing/us-vt).
## Data Availability
| Data Point | Available | Notes |
| ------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------- |
| Company name | Yes | Current legal name |
| Company status | Yes | 37-value status vocabulary from the SoS portal (Active - In Good Standing, Inactive - Voluntarily Dissolved, etc.) |
| Registration date | Yes | Date of incorporation / initial filing |
| Effective and termination dates | Yes | SoS-recorded effective date and termination/dissolution date where applicable |
| Legal address | Yes | Physical and mailing addresses; partnership addresses where applicable |
| Legal form | Yes | 18 SoS entity types, mapped to standardized labels |
| Legal representatives | Yes | Officers, directors, managers, and members with name, title, and contact address |
| Registered agent | Yes | Name, physical and mailing addresses; Commercial Registered Agent flag |
| Business organizers | Yes | Organizer list from the initial filing |
| Activity codes (NAICS) | Yes | NAICS codes where filed by the entity |
| Filing history | Yes | Metadata timeline (annual reports, articles of amendment, registered-agent changes, etc.) without underlying PDF images |
| Trade Register Extract | Yes | Printed PDF rendered from the live structured Vermont profile, included at no extra charge |
| Filing images (PDFs) | No | Not exposed by the public portal API; only filing-history metadata is available |
| Shareholders | No | Not published by the Vermont SoS |
| UBOs | No | No state beneficial-ownership register; the federal FinCEN database is restricted to authorised users |
| Tax ID (FEIN) | No | Not disclosed through the Vermont public business register |
| Financial data | No | Not collected |
## Example API Responses
### Search by Name
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-VT&query=Vermont+Creamery" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "012345",
"legalName": "VERMONT CREAMERY HOLDINGS, LLC",
"countryCode": "US-VT",
"matchReason": {
"matchType": "default"
},
"address": {
"region": "VT",
"countryCode": "US"
}
}
]
```
### Search by Record Number
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-VT&query=012345" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "012345",
"legalName": "VERMONT CREAMERY HOLDINGS, LLC",
"countryCode": "US-VT",
"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-VT", "id": "012345", "dataPoints": ["company", "legalRepresentatives"]}'
```
```json theme={null}
{
"company": {
"id": "012345",
"countryCode": "US-VT",
"identifiers": {
"entityId": "012345",
"vtIdBusiness": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
},
"legalName": "VERMONT CREAMERY HOLDINGS, LLC",
"registrationDate": "2010-03-15",
"status": {
"localName": "Active - In Good Standing",
"standardized": "Active"
},
"legalForm": {
"localName": "Domestic Limited Liability Company",
"standardized": "LimitedLiabilityCompany"
},
"legalAddress": {
"city": "Montpelier",
"region": "VT",
"postalCode": "05602",
"countryCode": "US"
}
},
"legalRepresentatives": [
{
"fullName": "Jane A. Smith",
"role": {
"localName": "Manager",
"standardized": "Manager"
}
}
]
}
```