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

# Sociedades de Nova York

> Toda sociedade, LLC, sociedade de pessoas e demais entidade ativa registrada no Departamento de Estado de Nova York, cerca de 4,3 milhões, nacionais e estrangeiras: busque por nome, tipo, condado, jurisdição e data de registro, e leia as partes de uma entidade.

A Divisão de Sociedades do Departamento de Estado de Nova York mantém o
registro de toda sociedade, LLC, sociedade de pessoas e demais entidade
constituída em Nova York ou autorizada a operar lá. Para cada entidade ativa:
seu nome e DOS ID, quando se registrou pela primeira vez, seu condado,
jurisdição e tipo, e quem o registro nomeia: o endereço para citações, o
diretor executivo, o agente registrado e o escritório principal. Uma empresa de
Delaware registrada para operar em Nova York aparece com `jurisdiction`
`DELAWARE`. Atualizado semanalmente.

<Note>
  O Departamento publica apenas entidades ativas. Uma entidade que se dissolve,
  se funde ou é revogada sai da lista, e deixa de aparecer aqui na próxima
  atualização semanal; `found: false` para um DOS ID que já esteve ativo
  significa que não está mais.
</Note>

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar entidades

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

Busca em todas as entidades ativas por qualquer combinação de nome, tipo,
lugar e data de registro.

| Campo          | Tipo    | Notas                                                                                                                                                               |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string  | Opcional. Palavras do nome da entidade. Todas devem coincidir; sem stemming.                                                                                        |
| `entity_type`  | string  | Opcional. O tipo de entidade como o Departamento o escreve, p. ex. `DOMESTIC LIMITED LIABILITY COMPANY`, `FOREIGN BUSINESS CORPORATION`. Não diferencia maiúsculas. |
| `county`       | string  | Opcional. Um condado de Nova York, p. ex. `KINGS`, `NEW YORK`.                                                                                                      |
| `jurisdiction` | string  | Opcional. Onde a entidade foi constituída, p. ex. `NEW YORK`, `DELAWARE`.                                                                                           |
| `from_date`    | string  | Opcional. Data mais antiga do primeiro registro, yyyy-mm-dd.                                                                                                        |
| `to_date`      | string  | Opcional. Data mais recente do primeiro registro, yyyy-mm-dd.                                                                                                       |
| `page`         | integer | Opcional. Página, começa em 1. Por padrão `1`.                                                                                                                      |
| `per_page`     | integer | Opcional. Resultados por página, 1-50. Por padrão `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" }'
```

Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `corporations[]`, por nome.

Cada entidade traz `dos_id` (o id do Departamento de Estado), `name`, `initial_filing_date`, `county`, `jurisdiction` (onde foi constituída), `entity_type` e quatro partes, cada uma `{ name, address_1, address_2, city, state, zip }` ou null: `process` (para onde o Departamento envia citações), `chief_executive`, `registered_agent` e `location` (o escritório executivo principal).

Os campos vazios são `null`. As categorias vão em maiúsculas, como o Departamento escreve a maioria.

## Uma entidade

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

Resolve uma entidade pelo seu DOS ID.

| Campo    | Tipo   | Notas                                              |
| -------- | ------ | -------------------------------------------------- |
| `dos_id` | string | **Obrigatório.** O DOS ID da entidade, só dígitos. |

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

Retorna `found`, `dos_id`, `as_of` e `corporation` (null quando não encontrado).

Cada entidade traz `dos_id` (o id do Departamento de Estado), `name`, `initial_filing_date`, `county`, `jurisdiction` (onde foi constituída), `entity_type` e quatro partes, cada uma `{ name, address_1, address_2, city, state, zip }` ou null: `process` (para onde o Departamento envia citações), `chief_executive`, `registered_agent` e `location` (o escritório executivo principal).

Os campos vazios são `null`. As categorias vão em maiúsculas, como o Departamento escreve a maioria.

<Note>
  O Departamento publica apenas entidades ativas. Uma entidade que se dissolve,
  se funde ou é revogada sai da lista, e deixa de aparecer aqui na próxima
  atualização semanal; `found: false` para um DOS ID que já esteve ativo
  significa que não está mais.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>