Skip to main content

​
Table of Contents

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

​
Data Sources

New York State uses two complementary integrations against the New York Department of State, Division of Corporations. Both serve the same underlying database of ~4.2M active business entities.
  • Public Inquiry portal (live, authoritative). The official interactive register at apps.dos.ny.gov. Returns the richest record: authorized stock share info, next biennial statement due date, and four separated addresses (service-of-process, registered agent, principal executive office, entity location). Used for mode: "verification" requests.
  • NYS Open Data snapshot (fast, non-authoritative). A daily refresh of the same DOS database published at data.ny.gov. Used for sub-second onboarding checks, company search, and former and assumed name matching. Lag is at most one day.
Mode-based routing. Onboarding requests (mode: "onboarding") hit the cached snapshot for speed. Verification requests (mode: "verification") hit both sources in parallel and merge the richer live fields on top of the snapshot.
Biennial cadence. New York corporations file a biennial statement every two years. Officer and CEO data can lag up to 24 months behind ground truth. The next statement due date field (verification mode only) surfaces when the entity is next due to refresh its information.

​
Company Identifiers

​
Query Identifiers

Identifier TypeFormatExampleNotes
DOS ID6-8 digits30059NY Department of State primary identifier
The DOS ID is the only identifier supported for company retrieval. To find a DOS ID from a name, use the search endpoint first.

​
Identifiers in API Response

IdentifierFormatExampleFound In
dosId6-8 digits30059All entities

​
Search Capabilities

Search TypePatternExampleMatch TypeExpected Results
By Name2-100 chars"International Busi"FuzzyMultiple results
By Former Name2-100 chars"Bell Atlantic"FuzzyMultiple results
By Assumed Name2-100 chars"Verizon"FuzzyMultiple results
By DOS ID6-8 digits30059ExactSingle company
Former name search. Entities often change legal names. Searching for a former name (for example "Bell Atlantic") will surface the current entity ("Verizon Communications Inc.") via the DOS name history dataset.

​
Quirks & Gotchas

QuirkDetails
No LLC officer dataNew York DOS does not collect or publish LLC member, manager, or officer information. For LLC entities the legal-representatives response will always be empty.
Corporations disclose CEO onlyBiennial statements only disclose the CEO of a corporation. Directors, Vice Presidents, Secretaries, and other officers are not published by DOS.
No shareholder or UBO registerNew York does not publish shareholders or beneficial owners for any entity type.
No activity codesDOS does not collect NAICS or industry codes. The NY Department of Taxation and Finance holds NAICS for tax purposes but does not publish it openly.
DBAs live at county clerksAssumed name (DBA) filings go to the county clerk, not DOS. A mandatory 2-newspaper-for-6-weeks publication requirement makes many small businesses skip formal DBA filing.
Certified documents are paid + mailCertified copies of formation documents (~10each)andGoodStandingcertificates( 10 each) and Good Standing certificates (~25 to $40) are delivered by mail only. No free electronic download exists.
Registered agent vs SOP agentIn verification mode the response separates three distinct roles: the registered agent (formal service), the SOP agent (service of process on the DOS), and the CEO from the biennial statement.

​
Mappings

​
Company Status

Status comes from the DOS entity status field. Dissolution, merger, and surrender statuses are all mapped to active: false.
Source ValueMapped StatusActive
ACTIVEActivetrue
INACTIVE - Dissolution by ProclamationDissolvedfalse
INACTIVE - Merged OutMergedfalse
INACTIVE - Voluntary DissolutionDissolvedfalse
INACTIVE - Surrender of AuthorityWithdrawnfalse
Legal form is derived from the DOS entity_type field. Closed vocabulary of ~20 values covering domestic and foreign variants of every supported entity class.
DOS Entity TypeStandardizedISO 20275
DOMESTIC BUSINESS CORPORATIONCorporationC5K7
FOREIGN BUSINESS CORPORATIONCorporationC5K7
DOMESTIC LIMITED LIABILITY COMPANYLimited Liability CompanyWYG5
FOREIGN LIMITED LIABILITY COMPANYLimited Liability CompanyWYG5
DOMESTIC LIMITED PARTNERSHIPLimited PartnershipFE1L
FOREIGN LIMITED PARTNERSHIPLimited Partnership
DOMESTIC LIMITED LIABILITY PARTNERSHIPLimited Liability PartnershipLA8V
FOREIGN LIMITED LIABILITY PARTNERSHIPLimited Liability Partnership
DOMESTIC NOT-FOR-PROFIT CORPORATIONNon-Profit OrganizationOGSS
FOREIGN NOT-FOR-PROFIT CORPORATIONNon-Profit Organization
DOMESTIC PROFESSIONAL CORPORATIONProfessional Corporation9AAS

​
Officer Roles

New York discloses only three named roles per entity. There is no free-text field, so all three are deterministic (no AI enrichment required).
DOS RoleStandardizedNotes
CEOChief Executive OfficerBiennial statement, corporations only
Registered AgentOtherStatutory service-of-process contact
SOP AgentOtherService-of-process on the DOS itself
Registered Agent and SOP Agent are classified as Other Key Persons, not Legal Representatives. They have no statutory authority to bind the entity.

​
Data Availability

Data PointAvailableNotes
Company nameYesCurrent legal name plus former legal names (searchable)
Former namesYesFrom DOS name history dataset. Indexed for search.
Assumed namesYesDOS-filed assumed names only. County-clerk DBAs are out of scope.
Company statusYesACTIVE plus 8 INACTIVE variants mapped to standardized statuses
Registration dateYesDOS initial filing date
Legal addressYesVerification mode returns four separated addresses: SOP, registered agent, principal executive, location.
Legal formYesClosed DOS entity-type vocabulary with ISO 20275 mapping
Authorized stockYes*Verification mode only. Includes stock type, par value, quantity.
Next biennial due dateYes*Verification mode only. Indicates when officer and address data will next refresh.
Filing historyYesEvery filing event against the entity (20.5M-row dataset)
Merger historyYesConstituents of merger filings
Legal representativesYes*Corporations return the CEO. LLCs, LPs, and not-for-profits return none.
Other key personsYesRegistered Agent and SOP Agent
Activity codesNoNot collected by DOS
ShareholdersNoNot published
UBOsNoNot published (federal CTA/FinCEN is a separate system)
DocumentsNoCertified copies are paid and mailed only
Financial dataNoNot collected

​
Example API Responses

​
Search by Name

curl -X POST "https://api.topograph.co/v2/search?country=US-NY&query=INTERNATIONAL+BUSINESS+MACHINES" \
  -H "x-api-key: YOUR_API_KEY"

[
  {
    "id": "30059",
    "legalName": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
    "countryCode": "US-NY",
    "matchReason": {
      "matchType": "default"
    },
    "address": {
      "region": "NY",
      "countryCode": "US"
    }
  }
]

​
Search by Former Name

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

[
  {
    "id": "1898443",
    "legalName": "VERIZON COMMUNICATIONS INC.",
    "countryCode": "US-NY",
    "matchReason": {
      "matchType": "previousName"
    }
  }
]

​
Company Profile (Onboarding Mode)

curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-NY", "id": "30059", "dataPoints": ["company", "legalRepresentatives"], "mode": "onboarding"}'

{
  "company": {
    "id": "30059",
    "countryCode": "US-NY",
    "identifiers": { "dosId": "30059" },
    "legalName": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
    "registrationDate": "1911-06-16",
    "status": { "localName": "Active", "active": true },
    "legalForm": {
      "localName": "DOMESTIC BUSINESS CORPORATION",
      "standardized": "Corporation",
      "iso20275Code": "C5K7"
    },
    "legalAddress": {
      "city": "ARMONK",
      "region": "NY",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": []
}

​
Company Profile (Verification Mode)

Verification mode adds authorized stock, next biennial due date, and four separated addresses from the authoritative live portal. 
curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-NY", "id": "30059", "dataPoints": ["company", "legalRepresentatives"], "mode": "verification"}'