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

# Colorado UCC Liens

> Every UCC and lien filing with the Colorado Secretary of State since 1966, about 2.6 million, lapsed, terminated and in force: find the liens against a company or person by the debtor's name, the liens a lender holds by the secured party's name, and read a whole lien with its amendments, parties, collateral and whether it is still in force.

The Colorado Secretary of State records the liens filed against Colorado
businesses and people: UCC financing statements that secure a loan or a lease
on a debtor's assets, and federal tax, hospital and other statutory liens. Every
filing since 1966 is kept, in any status, with its amendments, continuations and
terminations, the debtors and secured parties it lists, and the collateral it
describes. A lien is its initial filing and every filing that names it, and
whether it is still in force is computed each time you ask. Brought up to date
daily.

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

## Find liens against a debtor

`POST /us/colorado-ucc/debtors-search/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

Searches the debtors by name, or by a Colorado entity's id.

| Field             | Type    | Notes                                                                                             |
| ----------------- | ------- | ------------------------------------------------------------------------------------------------- |
| `query`           | string  | Optional. Words in the name. Every word must match; no stemming.                                  |
| `organization_id` | string  | Optional. A Colorado entity's id with the Secretary of State, digits only, as the filer wrote it. |
| `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/colorado-ucc/debtors-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "parker bespoke furniture" }'
```

Returns `as_of`, `query`, `organization_id`, `total`, `page`, `per_page`, `total_pages`, `count` and `debtors[]`, by name.

Every listing carries its id (`debtor_id` or `secured_party_id`), `file_id`, `name`, `organization_name`, `first_name`, `middle_name`, `last_name`, `suffix` and `address` (`{ line_1, line_2, city, state, zip, zip_4, country }`), and `action_type` and `record_status` (whether the listing is current, not the lien). A debtor also carries `organization_type`, `organization_jurisdiction`, `organization_id` (for a Colorado entity, often its Secretary of State id) and `description`; a secured party carries `assignor`. Debtors include people, with their addresses, as the filings list them.

Each carries `filing` (`{ filing_number, transaction_type, document_type, filing_date }`, the filing that lists it) and `lien` (`{ initial_filing_number, filing_type, filed_date, filings, lapse_date, terminated, in_force }`). `in_force` is computed by Croma when the response is served: false once a filing terminated the lien or its lapse date has passed, true while neither, and null when the lien has no lapse date and no termination, as for most federal tax and hospital liens.

## Find the liens a lender holds

`POST /us/colorado-ucc/secured-parties-search/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

Searches the secured parties by name. The filers spell a lender many ways
(`Wells Fargo Bank, N.A.`, `WELLS FARGO BANK, NATIONAL ASSOCIATION`); search
the distinctive words.

| Field      | Type    | Notes                                                            |
| ---------- | ------- | ---------------------------------------------------------------- |
| `query`    | string  | Optional. Words in the 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/colorado-ucc/secured-parties-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "jpmorgan chase" }'
```

Returns `as_of`, `query`, `total`, `page`, `per_page`, `total_pages`, `count` and `secured_parties[]`, by name.

Every listing carries its id (`debtor_id` or `secured_party_id`), `file_id`, `name`, `organization_name`, `first_name`, `middle_name`, `last_name`, `suffix` and `address` (`{ line_1, line_2, city, state, zip, zip_4, country }`), and `action_type` and `record_status` (whether the listing is current, not the lien). A debtor also carries `organization_type`, `organization_jurisdiction`, `organization_id` (for a Colorado entity, often its Secretary of State id) and `description`; a secured party carries `assignor`. Debtors include people, with their addresses, as the filings list them.

Each carries `filing` (`{ filing_number, transaction_type, document_type, filing_date }`, the filing that lists it) and `lien` (`{ initial_filing_number, filing_type, filed_date, filings, lapse_date, terminated, in_force }`). `in_force` is computed by Croma when the response is served: false once a filing terminated the lien or its lapse date has passed, true while neither, and null when the lien has no lapse date and no termination, as for most federal tax and hospital liens.

## One lien, whole

`POST /us/colorado-ucc/lien/v1` <a className="dataset-pill" href="/datasets">Dataset</a>

Resolves a lien by any of its filing numbers.

| Field           | Type   | Notes                                                                                                                          |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| `filing_number` | string | **Required.** The number of the initial filing or of any amendment, e.g. `20262077023`; older filings read like `2004F012345`. |

```bash theme={"dark"}
curl https://api.croma.run/us/colorado-ucc/lien/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "filing_number": "20262077023" }'
```

Returns `found`, `filing_number`, `as_of` and `lien` (null when not found): `initial_filing_number`, `filing_type` (e.g. `ucc`, `lien_irs`, `lien_hosp`, `efs`), `filed_date`, `lapse_date`, `terminated`, `in_force`, `filings[]` oldest first (each `{ file_id, filing_number, initial_filing_number, transaction_type, filing_type, document_type, financial_statement_type, filing_date, lapse_date, continuation, termination, manufactured_home }`), `debtors[]`, `secured_parties[]` and `collateral[]` (each `{ collateral_id, file_id, description, additional_description, county, farm_product, ... }`, `additional_description` being the filer's own text), up to 1,000 of each, with their totals.

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