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

# Connecticut Businesses

> Every business on the Connecticut Secretary of the State's register, about 1.3 million in any status, with its principals and registered agents: search businesses by name, status, type, account number and registration date, find every business a person is a principal of, and read one business with its people.

The Connecticut Secretary of the State keeps the register of every business
formed in Connecticut or registered to do business there, in every status, and
publishes it with the people each business reports: its principals (officers,
directors, members, managers) and its registered agents. Every column the
register publishes is kept: formation, addresses, email, NAICS code, the
ownership survey, authorized shares. Search a person's name across the
principals to find every business they are part of. Brought up to date weekly.

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

`POST /us/ct-sos/businesses-search/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

Searches every business by any combination of name, status, type, account
number and registration date.

| Field            | Type    | Notes                                                                                                      |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Optional. Words in the business's name. Every word must match; no stemming.                                |
| `status`         | string  | Optional. e.g. `Active`, `Forfeited`, `Dissolved`, `Withdrawn`, `Revoked`, `Merged`. Case does not matter. |
| `business_type`  | string  | Optional. The business type as the register writes it, e.g. `LLC`, `Stock`.                                |
| `account_number` | string  | Optional. The business's account number, digits only.                                                      |
| `from_date`      | string  | Optional. The earliest registration date, yyyy-mm-dd.                                                      |
| `to_date`        | string  | Optional. The latest registration 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/ct-sos/businesses-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "insurance" }'
```

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

Every business carries `id`, `name`, `business_type`, `status`, `sub_status`, `account_number`, `date_registration`, `annual_report_due_date`, `began_transacting_in_ct`, `date_of_organization_meeting`, `dissolution_date`, `reason_for_administrative`, `business_email`, its formation (`business_name_in_state_country`, `citizenship`, `country_formation`, `formation_place`, `state_or_territory_formation`), `billing_address` and `records_address` (`{ street, unit, city, state, postal_code, country }`), `record_address`, the mailing and office jurisdiction addresses as the register writes them (`mailing_*`, `office_*`), `naics_code`, `naics_sub_code`, the ownership survey (`woman_owned`, `veteran_owned`, `minority_owned`, `disability_owned`, `lgbtqi_owned`, `category_survey_email`), `total_authorized_shares`, `latitude` and `longitude`.

Empty fields are `null`. Statuses and types are upper-cased.

## One business and its people

`POST /us/ct-sos/business/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

Resolves one business by its id, with its principals and agents.

| Field | Type   | Notes                                                              |
| ----- | ------ | ------------------------------------------------------------------ |
| `id`  | string | **Required.** The business record's id, as returned by the search. |

```bash theme={"dark"}
curl https://api.croma.run/us/ct-sos/business/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "001t000000WmbJKAAZ" }'
```

Returns `found`, `id`, `as_of`, `business` (null when not found), `principals[]`, `principals_total` and `agents[]`.

Every business carries `id`, `name`, `business_type`, `status`, `sub_status`, `account_number`, `date_registration`, `annual_report_due_date`, `began_transacting_in_ct`, `date_of_organization_meeting`, `dissolution_date`, `reason_for_administrative`, `business_email`, its formation (`business_name_in_state_country`, `citizenship`, `country_formation`, `formation_place`, `state_or_territory_formation`), `billing_address` and `records_address` (`{ street, unit, city, state, postal_code, country }`), `record_address`, the mailing and office jurisdiction addresses as the register writes them (`mailing_*`, `office_*`), `naics_code`, `naics_sub_code`, the ownership survey (`woman_owned`, `veteran_owned`, `minority_owned`, `disability_owned`, `lgbtqi_owned`, `category_survey_email`), `total_authorized_shares`, `latitude` and `longitude`.

Empty fields are `null`. Statuses and types are upper-cased.

A principal carries `id`, `business_id`, `name`, `first_name`, `middle_name`, `last_name`, `suffix`, `designation` (officer, director), `type` and `business_address` (`{ line_1, line_2, line_3, city, state, zip, country, international }`). An agent carries `id`, `business_id`, `business_account_number`, `agent_account`, `type` (`Individual`, `Business` or `Secretary of the State`), `name` and its parts, `phone`, `email`, and its business and mailing addresses. Residence addresses are not returned.

## Find a person's businesses

`POST /us/ct-sos/principals-search/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

Searches the principals by name.

| Field      | Type    | Notes                                                                        |
| ---------- | ------- | ---------------------------------------------------------------------------- |
| `query`    | string  | Optional. Words in the principal's name. Every word must match; no stemming. |
| `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/ct-sos/principals-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "john smith" }'
```

Returns `as_of`, `query`, `total`, `page`, `per_page`, `total_pages`, `count` and `principals[]`, each with `business_name` and `business_status`.

A principal carries `id`, `business_id`, `name`, `first_name`, `middle_name`, `last_name`, `suffix`, `designation` (officer, director), `type` and `business_address` (`{ line_1, line_2, line_3, city, state, zip, country, international }`). An agent carries `id`, `business_id`, `business_account_number`, `agent_account`, `type` (`Individual`, `Business` or `Secretary of the State`), `name` and its parts, `phone`, `email`, and its business and mailing addresses. Residence addresses are not returned.

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