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

# Delaware

> O registro de entidades de Delaware: busque corporações, LLCs, sociedades e trusts por nome, e consulte o registro de uma entidade, agente registrado incluído, pelo número de arquivo.

Cada entidade registrada na Delaware Division of Corporations: corporações,
sociedades de responsabilidade limitada, sociedades limitadas, trusts
estatutários e sociedades, locais e estrangeiras, ativas e inativas. Delaware
é onde a maioria das startups, fundos de venture capital e empresas públicas
dos Estados Unidos se constitui, então este é o registro pelo qual começa uma
diligência, um KYC ou uma verificação de contraparte.

Dois passos: busque um nome para obter números de arquivo, e consulte um
para o registro gratuito da Divisão, com a data de constituição, a classe e o
tipo de entidade, o estado de constituição e o agente registrado.

## Buscar entidades

`POST /us/delaware/entities-search/v1`

Busca no registro por nome de entidade e retorna até 50 correspondências
com seus números de arquivo.

| Campo   | Tipo    | Notas                                                                                                                                |
| ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `query` | string  | **Obrigatório.** O nome da entidade, ou suas palavras, p. ex. `GOOGLE LLC`. Não diferencia maiúsculas; `AND` e `&` são equivalentes. |
| `exact` | boolean | Opcional. `true` para retornar apenas entidades cujo nome é exatamente `query`. Por padrão `false`.                                  |

```bash theme={"dark"}
curl https://api.croma.run/us/delaware/entities-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "GOOGLE LLC", "exact": true }'
```

Retorna `query` e `exact` (tal qual), `count`, `truncated` e `entities[]`, cada uma `{ file_number, name }`, em ordem alfabética por nome. Passe um `file_number` à consulta abaixo para o registro completo.

<Note>
  A Divisão lista no máximo 50 correspondências por busca e não pagina além
  disso. Quando mais entidades correspondem, `truncated` é `true` e as 50
  primeiras são retornadas: refine a busca, ou envie `exact: true` com o nome
  completo.
</Note>

## Entidade por número de arquivo

`POST /us/delaware/entity/v1` Resolve uma entidade pelo seu número de arquivo e retorna o registro da Divisão.

| Campo         | Tipo   | Notas                                                                                                         |
| ------------- | ------ | ------------------------------------------------------------------------------------------------------------- |
| `file_number` | string | **Obrigatório.** O número de arquivo da Divisão, apenas dígitos, p. ex. `3582691`, como retornado pela busca. |

```bash theme={"dark"}
curl https://api.croma.run/us/delaware/entity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "file_number": "3582691" }'
```

Retorna `found`, `file_number`, `entity` (null quando não encontrado) e `checked_at`.

O registro traz `file_number` (a chave da Divisão), `name`, `filed_on` (`yyyy-mm-dd`, a data de incorporação ou constituição que a Divisão imprime), `entity_kind` (`Corporation`, `Limited Liability Company`, `Limited Partnership`, `Statutory Trust`, `Partnership`, `Registered Series`, ...), `entity_type` (`General`, `Bank`, `Benefit Corporation`, `Closed Corp`, `Exempt`, `Series`, ...), `residency` (`domestic` ou `foreign`), `state` (o estado de constituição como a Divisão o imprime, p. ex. `DELAWARE`) e `registered_agent` (`{ name, address, city, county, state, postal_code, phone }`, ou null). Os campos vazios são `null`.

É o registro gratuito da Divisão. Não é um certificado de regularidade (good standing): o status, o imposto de franquia e o histórico de arquivamentos não fazem parte dele.

<Note>
  Um número de arquivo que a Divisão não possui retorna `found: false` com
  HTTP 200, não um erro.
</Note>

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