> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# New York Corporations

> Every active corporation, LLC, partnership and other entity on file with the New York Department of State, about 4.3 million, domestic and foreign: search by name, type, county, jurisdiction and filing date, and read one entity's parties.

The New York Department of State's Division of Corporations keeps the
register of every corporation, limited liability company, partnership and
other entity formed in New York or authorized to do business there. For each
active entity: its name and DOS ID, when it first filed, its county,
jurisdiction and type, and who the filing names: the address for service of
process, the chief executive, the registered agent and the principal office.
A Delaware company registered to do business in New York appears with
`jurisdiction` `DELAWARE`. Brought up to date weekly.

<Note>
  The Department publishes active entities only. An entity that dissolves,
  merges or is revoked leaves the list, and stops matching here at the next
  weekly update; `found: false` on a DOS ID that was once active means it no
  longer is.
</Note>

<Note>
  The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](/datasets).
</Note>

## Search entities

`POST /us/ny-dos/corporations-search/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

Searches every active entity by any combination of name, type, place and
filing date.

| Field          | Type    | Notes                                                                                                                                                   |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string  | Optional. Words in the entity's name. Every word must match; no stemming.                                                                               |
| `entity_type`  | string  | Optional. The entity type as the Department writes it, e.g. `DOMESTIC LIMITED LIABILITY COMPANY`, `FOREIGN BUSINESS CORPORATION`. Case does not matter. |
| `county`       | string  | Optional. A New York county, e.g. `KINGS`, `NEW YORK`.                                                                                                  |
| `jurisdiction` | string  | Optional. Where the entity was formed, e.g. `NEW YORK`, `DELAWARE`.                                                                                     |
| `from_date`    | string  | Optional. The earliest first filing date, yyyy-mm-dd.                                                                                                   |
| `to_date`      | string  | Optional. The latest first filing date, yyyy-mm-dd.                                                                                                     |
| `page`         | integer | Optional. 1-based page. Default `1`.                                                                                                                    |
| `per_page`     | integer | Optional. Results per page, 1-50. Default `20`.                                                                                                         |

```bash theme={"dark"}
curl https://api.croma.run/us/ny-dos/corporations-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "acme holdings" }'
```

Returns `as_of`, the applied filters, `total`, `page`, `per_page`, `total_pages`, `count` and `corporations[]`, by name.

Every entity carries `dos_id` (the Department of State's id), `name`, `initial_filing_date`, `county`, `jurisdiction` (where it was formed), `entity_type`, and four parties, each `{ name, address_1, address_2, city, state, zip }` or null: `process` (where the Department mails service of process), `chief_executive`, `registered_agent` and `location` (the principal executive office).

Empty fields are `null`. Categories are upper-cased, as the Department writes most of them.

## One entity

`POST /us/ny-dos/corporation/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

Resolves one entity by its DOS ID.

| Field    | Type   | Notes                                           |
| -------- | ------ | ----------------------------------------------- |
| `dos_id` | string | **Required.** The entity's DOS ID, digits only. |

```bash theme={"dark"}
curl https://api.croma.run/us/ny-dos/corporation/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "dos_id": "1560743" }'
```

Returns `found`, `dos_id`, `as_of` and `corporation` (null when not found).

Every entity carries `dos_id` (the Department of State's id), `name`, `initial_filing_date`, `county`, `jurisdiction` (where it was formed), `entity_type`, and four parties, each `{ name, address_1, address_2, city, state, zip }` or null: `process` (where the Department mails service of process), `chief_executive`, `registered_agent` and `location` (the principal executive office).

Empty fields are `null`. Categories are upper-cased, as the Department writes most of them.

<Note>
  The Department publishes active entities only. An entity that dissolves,
  merges or is revoked leaves the list, and stops matching here at the next
  weekly update; `found: false` on a DOS ID that was once active means it no
  longer is.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>