New York (US)

This guide is outdated and will be removed on 1 November 2026. The up-to-date New York (US) reference is on the New York (US) country page.

Start here

This guide contains public integration notes for New York. 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.

New York 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
Statutory Filings
Data Availability

Data Sources

New York State data comes from the New York Department of State, Division of Corporations.

NYS Open Data snapshot. A daily refresh of the DOS business entity database published at data.ny.gov. Used for company data, company search, and former name matching. Lag is at most one day.

Live register access is temporarily unavailable. Both mode: "prefill" and mode: "verification" are currently served from the daily snapshot, so a filing made since the last daily publication is not yet reflected. Work is underway to restore live access.

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.

Company Identifiers

Query Identifiers

Identifier Type	Format	Example	Notes
DOS ID	1 to 7 digits, no leading zeros	`30059`	NY Department of State primary identifier. Most entities have 6 or 7 digits; the oldest have fewer (e.g. `3707`).

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

Identifier	Format	Example	Found In
`dosId`	1 to 7 digits, no leading zeros	`30059`	All entities

Legal Entity Identifier (LEI)

GLEIF is the supplementary data source for this identifier. company.identifiers.lei is returned when a company identifier has a unique match against this jurisdiction’s registration or validation references in GLEIF. An LEI (Legal Entity Identifier) has 20 uppercase letters and digits, ending in two check digits. Coverage varies by entity. The field is omitted when no unambiguous match is available. Lapsed or retired LEIs may be returned; annulled records are excluded.

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By Name	2-200 chars	`"International Busi"`	Fuzzy	Multiple results
By Former Name	2-200 chars	`"Bell Atlantic"`	Fuzzy	Multiple results
By Assumed Name	2-200 chars	`"Verizon"`	Fuzzy	Multiple results
By DOS ID	1-8 digits	`30059`	Exact	Exact match returned first (matchType: id); other results may follow

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.

Active companies only

Search can return companies that are no longer active, but their status is not known at search time, so activeOnly=true has no effect. Check company.status on the company profile. Name searches mostly draw on the register list of active companies, but inactive companies can still appear, notably in registration-number lookups and older name matches, and are not filtered out.

Quirks & Gotchas

Quirk	Details
No LLC officer data	New 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 only	Biennial statements only disclose the CEO of a corporation. Directors, Vice Presidents, Secretaries, and other officers are not published by DOS.
No shareholder or UBO register	New York does not publish shareholders or beneficial owners for any entity type.
No activity codes	DOS 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 clerks	Assumed 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 + mail	Certified copies of formation documents and Good Standing certificates are paid (see pricing) and delivered by mail only. No electronic download of certified copies exists.
Registered agent vs SOP address	The registered agent is returned as an other key person. The service-of-process entry is an address, not a party: for most entities the register records the entity itself there (“THE CORPORATION”, “THE LLC”), meaning process is mailed to the company, so no agent is returned from it.

Mappings

Company Status

Status comes from the DOS entity status field, which uses four values. The value is returned as published in localName.

Source Value	Active
`Active`	`true`
`Inactive`	`false`
`Suspended`	`false`
`Discontinued`	`false`

Legal Forms

Legal form is derived from the DOS entity_type field. Closed vocabulary of 84 values covering domestic and foreign variants of every supported entity class. ISO 20275 ELF codes are not mapped for New York.

Common DOS entity types

DOS Entity Type	Standardized
DOMESTIC BUSINESS CORPORATION	Corporation
FOREIGN BUSINESS CORPORATION	Corporation
DOMESTIC LIMITED LIABILITY COMPANY	Limited Liability Company
FOREIGN LIMITED LIABILITY COMPANY	Limited Liability Company
DOMESTIC LIMITED PARTNERSHIP	Partnership
FOREIGN LIMITED PARTNERSHIP	Partnership
DOMESTIC REGISTERED LIMITED LIABILITY PARTNERSHIP	Partnership
NEW YORK REGISTERED FOREIGN LIMITED LIABILITY PARTNERSHIP	Partnership
DOMESTIC NOT-FOR-PROFIT CORPORATION	Nonprofit Organization
FOREIGN NOT-FOR-PROFIT CORPORATION	Nonprofit Organization
DOMESTIC PROFESSIONAL SERVICE CORPORATION	Corporation

Officer Roles

The supported New York sources provide two named-contact categories, mapped deterministically: CEO and Registered Agent. The CEO office does not establish unrestricted signing authority; powers depend on bylaws and board authorization under BCL §715(g). Sole or joint authority is not inferred.

DOS Role	Standardized	Notes
CEO	Chief Executive Officer	Biennial statement, corporations only
Registered Agent	Registered Agent	Statutory service-of-process contact. Available for every entity type.

The Registered Agent is classified as an Other Key Person, not a Legal Representative, because it has no statutory authority to bind the entity.An agent may be a corporate service firm (returned under company) or a named individual (returned under individual), and both are common: large corporations typically appoint a firm, while small LLCs frequently name their own owner, attorney, or accountant. New York publishes the agent name without stating which it is, so we derive the distinction from the name. Expect it to be occasionally wrong for a firm whose name carries no company designator.

Statutory Filings

New York entities file a biennial report confirming the entity’s particulars are current. The register publishes “Next Statement Due Date”. New York files a biennial statement, not an annual report, returned on the cross-country statutoryFilings field as next.dueDate.

statutoryFilings is not returned for New York while live register access is unavailable. The daily snapshot does not carry the next statement due date.

{
  "statutoryFilings": {
    "annualFiling": {
      "cadence": "biennial",
      "next": { "dueDate": "2027-03-31" },
      "source": "ny_dos"
    }
  }
}

US states publish no statutory accounts, so the accounts obligation is absent rather than returned empty. An empty object would read as “we looked and found nothing”, which is a different claim. Placeholder cells such as N/A or Inactive, Not Applicable are dropped rather than parsed as dates, so an entity with no obligation simply has no statutoryFilings.

Data Availability

Data Point	Available	Notes
Company name	Yes	Current legal name plus former legal names (searchable)
Former names	Yes	From DOS name history dataset. Indexed for search.
Assumed names	No	Not returned in company data. County-clerk DBAs are out of scope.
Company status	Yes	4-value DOS status vocabulary
Registration date	Yes	DOS initial filing date
Legal address	Yes	A single address: principal executive office where published, otherwise the service-of-process or registered agent address.
Legal form	Yes	Closed DOS entity-type vocabulary; no ISO 20275 mapping
Authorized stock	No	Not currently available while live register access is unavailable
Next biennial due date	No	Not currently available while live register access is unavailable
Filing history	No	Not returned
Merger history	No	Not returned
Legal representatives	Yes*	Corporations return the CEO. LLCs, LPs, and not-for-profits return none.
Other key persons	Yes	The registered agent, with its address. Available for LLCs, LPs and LLPs, which disclose no officers.
Activity codes	No	Not collected by DOS
Shareholders	No	Not published
UBOs	No	Not published (federal CTA/FinCEN is a separate system)
Documents	Partial	A Trade Register Extract (printable DOS entity page) comes with company data at no extra charge. Certified copies and Good Standing certificates are paid and mailed only.
Financial data	No	Not 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": "default"
    }
  }
]

Company Profile (Prefill 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": "prefill"}'

{
  "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"
    },
    "legalAddress": {
      "city": "ARMONK",
      "region": "NY",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": []
}

Company Profile (Verification Mode)

Verification mode is currently served from the same daily snapshot as prefill mode and returns the same fields.

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"}'

Europe

North America

Asia

Offshore Centers

Start here

New York coverage, pricing, and sources

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Legal Entity Identifier (LEI)

Search Capabilities

Active companies only

Quirks & Gotchas

Mappings

Company Status

Legal Forms

Officer Roles

Statutory Filings

Data Availability

Example API Responses

Search by Name

Search by Former Name

Company Profile (Prefill Mode)

Company Profile (Verification Mode)

​Start here

New York coverage, pricing, and sources

​Table of Contents

​Data Sources

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Legal Entity Identifier (LEI)

​Search Capabilities

​Active companies only

​Quirks & Gotchas

​Mappings

​Company Status

​Legal Forms

​Officer Roles

​Statutory Filings

​Data Availability

​Example API Responses

​Search by Name

​Search by Former Name

​Company Profile (Prefill Mode)

​Company Profile (Verification Mode)

Start here

Table of Contents

Data Sources

Company Identifiers

Query Identifiers

Identifiers in API Response

Legal Entity Identifier (LEI)

Search Capabilities

Active companies only

Quirks & Gotchas

Mappings

Company Status

Legal Forms

Officer Roles

Statutory Filings

Data Availability

Example API Responses

Search by Name

Search by Former Name

Company Profile (Prefill Mode)

Company Profile (Verification Mode)