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

> Delaware's registry of business entities: search corporations, LLCs, partnerships and trusts by name, and read one entity's record, registered agent included, by file number.

Every business entity on file with the Delaware Division of Corporations:
corporations, limited liability companies, limited partnerships, statutory
trusts and partnerships, domestic and foreign, active and inactive. Delaware
is where most US startups, venture funds and public companies are formed,
so this is the registry a diligence, KYC or counterparty check starts from.

Two steps: search a name to get file numbers, then look one up for the
Division's free record, with the formation date, the kind and type of entity,
the state of formation and the registered agent.

## Search entities

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

Searches the registry by entity name and returns up to 50 matches with
their file numbers.

| Field   | Type    | Notes                                                                                                               |
| ------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| `query` | string  | **Required.** The entity name, or its words, e.g. `GOOGLE LLC`. Case does not matter; `AND` and `&` are equivalent. |
| `exact` | boolean | Optional. `true` to return only entities whose name is exactly `query`. Default `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 }'
```

Returns `query` and `exact` (echoed), `count`, `truncated` and `entities[]`, each `{ file_number, name }`, alphabetical by name. Pass a `file_number` to the lookup below for the full record.

<Note>
  The Division lists at most 50 matches per search and does not page further.
  When more entities match, `truncated` is `true` and the first 50 are
  returned: refine the query, or pass `exact: true` with the full name.
</Note>

## Entity by file number

`POST /us/delaware/entity/v1` Resolves one entity by its file number and returns the Division's record.

| Field         | Type   | Notes                                                                                             |
| ------------- | ------ | ------------------------------------------------------------------------------------------------- |
| `file_number` | string | **Required.** The Division's file number, digits only, e.g. `3582691`, as returned by the search. |

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

Returns `found`, `file_number`, `entity` (null when not found) and `checked_at`.

The record carries `file_number` (the Division's key), `name`, `filed_on` (`yyyy-mm-dd`, the incorporation or formation date the Division prints), `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` or `foreign`), `state` (the state of formation as the Division prints it, e.g. `DELAWARE`) and `registered_agent` (`{ name, address, city, county, state, postal_code, phone }`, or null). Empty fields are `null`.

This is the Division's free record. It is not a statement of good standing: status, franchise tax and filing history are not part of it.

<Note>
  A file number the Division does not carry returns `found: false` with
  HTTP 200, not an error.
</Note>

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