> ## 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 Nueva York

> Toda sociedad, LLC, sociedad de personas y demás entidad activa registrada ante el Departamento de Estado de Nueva York, unas 4,3 millones, nacionales y extranjeras: busca por nombre, tipo, condado, jurisdicción y fecha de registro, y lee las partes de una entidad.

La División de Sociedades del Departamento de Estado de Nueva York lleva el
registro de toda sociedad, LLC, sociedad de personas y demás entidad
constituida en Nueva York o autorizada para operar allí. Para cada entidad
activa: su nombre y DOS ID, cuándo se registró por primera vez, su condado,
jurisdicción y tipo, y a quién nombra el registro: la dirección para
notificaciones judiciales, el director ejecutivo, el agente registrado y la
oficina principal. Una empresa de Delaware registrada para operar en Nueva York
aparece con `jurisdiction` `DELAWARE`. Se actualiza cada semana.

<Note>
  El Departamento publica solo entidades activas. Una entidad que se disuelve,
  se fusiona o es revocada sale de la lista, y deja de aparecer aquí en la
  siguiente actualización semanal; `found: false` para un DOS ID que estuvo
  activo significa que ya no lo está.
</Note>

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar entidades

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

Busca en todas las entidades activas por cualquier combinación de nombre,
tipo, lugar y fecha de registro.

| Campo          | Tipo    | Notas                                                                                                                                                               |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string  | Opcional. Palabras del nombre de la entidad. Todas deben coincidir; sin lematización.                                                                               |
| `entity_type`  | string  | Opcional. El tipo de entidad como lo escribe el Departamento, p. ej. `DOMESTIC LIMITED LIABILITY COMPANY`, `FOREIGN BUSINESS CORPORATION`. No distingue mayúsculas. |
| `county`       | string  | Opcional. Un condado de Nueva York, p. ej. `KINGS`, `NEW YORK`.                                                                                                     |
| `jurisdiction` | string  | Opcional. Dónde se constituyó la entidad, p. ej. `NEW YORK`, `DELAWARE`.                                                                                            |
| `from_date`    | string  | Opcional. Fecha más temprana del primer registro, yyyy-mm-dd.                                                                                                       |
| `to_date`      | string  | Opcional. Fecha más tardía del primer registro, yyyy-mm-dd.                                                                                                         |
| `page`         | integer | Opcional. Página, empieza en 1. Por defecto `1`.                                                                                                                    |
| `per_page`     | integer | Opcional. Resultados por página, 1-50. Por defecto `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" }'
```

Devuelve `as_of`, los filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `corporations[]`, por nombre.

Cada entidad incluye `dos_id` (el id del Departamento de Estado), `name`, `initial_filing_date`, `county`, `jurisdiction` (dónde se constituyó), `entity_type` y cuatro partes, cada una `{ name, address_1, address_2, city, state, zip }` o null: `process` (a dónde el Departamento envía las notificaciones judiciales), `chief_executive`, `registered_agent` y `location` (la oficina ejecutiva principal).

Los campos vacíos son `null`. Las categorías van en mayúsculas, como el Departamento escribe la mayoría.

## Una entidad

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

Resuelve una entidad por su DOS ID.

| Campo    | Tipo   | Notas                                                   |
| -------- | ------ | ------------------------------------------------------- |
| `dos_id` | string | **Obligatorio.** El DOS ID de la entidad, solo 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" }'
```

Devuelve `found`, `dos_id`, `as_of` y `corporation` (null cuando no se encuentra).

Cada entidad incluye `dos_id` (el id del Departamento de Estado), `name`, `initial_filing_date`, `county`, `jurisdiction` (dónde se constituyó), `entity_type` y cuatro partes, cada una `{ name, address_1, address_2, city, state, zip }` o null: `process` (a dónde el Departamento envía las notificaciones judiciales), `chief_executive`, `registered_agent` y `location` (la oficina ejecutiva principal).

Los campos vacíos son `null`. Las categorías van en mayúsculas, como el Departamento escribe la mayoría.

<Note>
  El Departamento publica solo entidades activas. Una entidad que se disuelve,
  se fusiona o es revocada sale de la lista, y deja de aparecer aquí en la
  siguiente actualización semanal; `found: false` para un DOS ID que estuvo
  activo significa que ya no lo está.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>