/new_york/companies

curl --request POST \
  --url https://api.anysite.io/api/new_york/companies \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "dos_id": "<string>",
  "timeout": 300
}
'

[
  {
    "dos_id": "<string>",
    "name": "<string>",
    "@type": "@new_york_company",
    "foreign_legal_name": "<string>",
    "fictitious_name": "<string>",
    "company_type": "<string>",
    "entity_status": "<string>",
    "reason_for_status": "<string>",
    "section_of_law": "<string>",
    "duration_date": "<string>",
    "jurisdiction": "<string>",
    "county": "<string>",
    "nfp_category": "<string>",
    "statement_status": "<string>",
    "initial_dos_filing_date": "<string>",
    "effective_initial_filing_date": "<string>",
    "foreign_formation_date": "<string>",
    "inactive_date": "<string>",
    "next_statement_due_date": "<string>",
    "latest_dissolution_date": "<string>",
    "electronic_service_of_process_status": "<string>",
    "is_farm_corporation": true,
    "registered_agent": {
      "@type": "@new_york_contact",
      "name": "<string>",
      "address": {
        "@type": "@new_york_address",
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "country": "<string>"
      }
    },
    "ceo": {
      "@type": "@new_york_contact",
      "name": "<string>",
      "address": {
        "@type": "@new_york_address",
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "country": "<string>"
      }
    },
    "principal_executive_office_address": {
      "@type": "@new_york_address",
      "street": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>",
      "country": "<string>"
    },
    "service_of_process": {
      "@type": "@new_york_contact",
      "name": "<string>",
      "address": {
        "@type": "@new_york_address",
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "country": "<string>"
      }
    },
    "stock_shares": []
  }
]

/new_york/companies

Get a New York business entity by its DOS ID from the NY Department of State Corporation & Business Entity Database: legal name, foreign legal name, fictitious name, entity type and status, reason for status, section of law, duration date, jurisdiction, county, statement status and next-statement due date, initial DOS filing date, effective and foreign-formation dates, inactive and dissolution dates, registered agent (name + address), chief executive officer (name + address), principal executive office address, service-of-process recipient and stock/share classes.

Price: 1 credit

💡 AI Hint: Get one New York business entity by its DOS ID (numeric). Returns one item with dos_id, name, foreign_legal_name, fictitious_name, company_type, entity_status (Active/Inactive), reason_for_status, section_of_law, duration_date, jurisdiction, county, nfp_category, statement_status, initial_dos_filing_date, effective_initial_filing_date, foreign_formation_date, inactive_date, next_statement_due_date, latest_dissolution_date, electronic_service_of_process_status, is_farm_corporation, registered_agent (name, address), ceo (name, address), principal_executive_office_address, service_of_process (name, address) and stock_shares (list of stock_type, par_value, quantity). Dates are ISO YYYY-MM-DD. NY publishes the CEO but not a full officers/directors roster. Use new_york/companies/search to find the DOS ID by name.

⚠️ Common errors: 412: Entity not found (well-formed but nonexistent DOS ID)

POST

api

new_york

companies

/new_york/companies

curl --request POST \
  --url https://api.anysite.io/api/new_york/companies \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "dos_id": "<string>",
  "timeout": 300
}
'

[
  {
    "dos_id": "<string>",
    "name": "<string>",
    "@type": "@new_york_company",
    "foreign_legal_name": "<string>",
    "fictitious_name": "<string>",
    "company_type": "<string>",
    "entity_status": "<string>",
    "reason_for_status": "<string>",
    "section_of_law": "<string>",
    "duration_date": "<string>",
    "jurisdiction": "<string>",
    "county": "<string>",
    "nfp_category": "<string>",
    "statement_status": "<string>",
    "initial_dos_filing_date": "<string>",
    "effective_initial_filing_date": "<string>",
    "foreign_formation_date": "<string>",
    "inactive_date": "<string>",
    "next_statement_due_date": "<string>",
    "latest_dissolution_date": "<string>",
    "electronic_service_of_process_status": "<string>",
    "is_farm_corporation": true,
    "registered_agent": {
      "@type": "@new_york_contact",
      "name": "<string>",
      "address": {
        "@type": "@new_york_address",
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "country": "<string>"
      }
    },
    "ceo": {
      "@type": "@new_york_contact",
      "name": "<string>",
      "address": {
        "@type": "@new_york_address",
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "country": "<string>"
      }
    },
    "principal_executive_office_address": {
      "@type": "@new_york_address",
      "street": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>",
      "country": "<string>"
    },
    "service_of_process": {
      "@type": "@new_york_contact",
      "name": "<string>",
      "address": {
        "@type": "@new_york_address",
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip": "<string>",
        "country": "<string>"
      }
    },
    "stock_shares": []
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

dos_id

string

required

New York DOS ID (numeric entity identifier)

Minimum string length: 1

Examples:

"1453447"

"1767613"

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

dos_id

string

required

name

string

required

@type

string

default:@new_york_company

foreign_legal_name

string | null

fictitious_name

string | null

company_type

string | null

entity_status

string | null

reason_for_status

string | null

section_of_law

string | null

duration_date

string | null

jurisdiction

string | null

county

string | null

nfp_category

string | null

statement_status

string | null

initial_dos_filing_date

string | null

effective_initial_filing_date

string | null

foreign_formation_date

string | null

inactive_date

string | null

next_statement_due_date

string | null

latest_dissolution_date

string | null

electronic_service_of_process_status

string | null

is_farm_corporation

boolean | null

registered_agent

NewYorkContact · object

Show child attributes

ceo

NewYorkContact · object

Show child attributes

principal_executive_office_address

NewYorkAddress · object

Show child attributes

service_of_process

NewYorkContact · object

Show child attributes

stock_shares

NewYorkStockShare · object[]

Show child attributes

/new_mexico/companies/search /new_york/companies/filings