Vermont - Topograph

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.

Vermont 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
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.

All 18 Vermont entity types

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.

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

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

[
  {
    "id": "012345",
    "legalName": "VERMONT CREAMERY HOLDINGS, LLC",
    "countryCode": "US-VT",
    "matchReason": {
      "matchType": "default"
    },
    "address": {
      "region": "VT",
      "countryCode": "US"
    }
  }
]

Search by Record Number

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

[
  {
    "id": "012345",
    "legalName": "VERMONT CREAMERY HOLDINGS, LLC",
    "countryCode": "US-VT",
    "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-VT", "id": "012345", "dataPoints": ["company", "legalRepresentatives"]}'

{
  "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"
      }
    }
  ]
}

​Start here

Vermont 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

​Entity Statuses

​Data Availability

​Example API Responses

​Search by Name

​Search by Record Number

​Company Profile

Start here

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Legal Forms

Officer Roles

Entity Statuses

Data Availability

Example API Responses

Search by Name

Search by Record Number

Company Profile