> ## 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.
# Gravámenes UCC de Colorado
> Todo registro UCC y de gravamen ante la Secretaría de Estado de Colorado desde 1966, unos 2,6 millones, caducados, terminados y vigentes: encuentra los gravámenes contra una empresa o persona por el nombre del deudor, los que tiene un acreedor por el nombre del acreedor garantizado, y lee un gravamen completo con sus modificaciones, partes, garantías y si sigue vigente.
La Secretaría de Estado de Colorado registra los gravámenes presentados contra
empresas y personas de Colorado: declaraciones de financiamiento UCC que
garantizan un préstamo o un arrendamiento con los bienes del deudor, y gravámenes
fiscales federales, hospitalarios y otros legales. Se conserva cada registro
desde 1966, en cualquier estado, con sus modificaciones, continuaciones y
terminaciones, los deudores y acreedores garantizados que lista y las garantías
que describe. Un gravamen es su registro inicial y todo registro que lo nombra, y
si sigue vigente se calcula cada vez que preguntas. Se actualiza a diario.
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).
## Encontrar gravámenes contra un deudor
`POST /us/colorado-ucc/debtors-search/v1` Dataset
Busca entre los deudores por nombre, o por el id de una entidad de Colorado.
| Campo | Tipo | Notas |
| ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palabras del nombre. Todas deben coincidir; sin lematización. |
| `organization_id` | string | Opcional. El id de una entidad de Colorado en la Secretaría de Estado, solo dígitos, como lo escribió quien presentó el registro. |
| `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/colorado-ucc/debtors-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "parker bespoke furniture" }'
```
Devuelve `as_of`, `query`, `organization_id`, `total`, `page`, `per_page`, `total_pages`, `count` y `debtors[]`, por nombre.
Cada registro incluye su id (`debtor_id` o `secured_party_id`), `file_id`, `name`, `organization_name`, `first_name`, `middle_name`, `last_name`, `suffix` y `address` (`{ line_1, line_2, city, state, zip, zip_4, country }`), y `action_type` y `record_status` (si el registro está vigente, no el gravamen). Un deudor incluye además `organization_type`, `organization_jurisdiction`, `organization_id` (para una entidad de Colorado, a menudo su id en la Secretaría de Estado) y `description`; un acreedor garantizado incluye `assignor`. Los deudores incluyen personas, con sus direcciones, tal como las listan los registros.
Cada uno incluye `filing` (`{ filing_number, transaction_type, document_type, filing_date }`, el registro que lo lista) y `lien` (`{ initial_filing_number, filing_type, filed_date, filings, lapse_date, terminated, in_force }`). Croma calcula `in_force` al servir la respuesta: false una vez que un registro terminó el gravamen o pasó su fecha de caducidad, true mientras ninguna de las dos, y null cuando el gravamen no tiene fecha de caducidad ni terminación, como la mayoría de los gravámenes fiscales federales y hospitalarios.
## Encontrar los gravámenes de un acreedor
`POST /us/colorado-ucc/secured-parties-search/v1` Dataset
Busca entre los acreedores garantizados por nombre. Quienes presentan los
registros escriben un acreedor de muchas formas (`Wells Fargo Bank, N.A.`,
`WELLS FARGO BANK, NATIONAL ASSOCIATION`); busca las palabras distintivas.
| Campo | Tipo | Notas |
| ---------- | ------- | ----------------------------------------------------------------------- |
| `query` | string | Opcional. Palabras del nombre. Todas deben coincidir; sin lematización. |
| `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/colorado-ucc/secured-parties-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "jpmorgan chase" }'
```
Devuelve `as_of`, `query`, `total`, `page`, `per_page`, `total_pages`, `count` y `secured_parties[]`, por nombre.
Cada registro incluye su id (`debtor_id` o `secured_party_id`), `file_id`, `name`, `organization_name`, `first_name`, `middle_name`, `last_name`, `suffix` y `address` (`{ line_1, line_2, city, state, zip, zip_4, country }`), y `action_type` y `record_status` (si el registro está vigente, no el gravamen). Un deudor incluye además `organization_type`, `organization_jurisdiction`, `organization_id` (para una entidad de Colorado, a menudo su id en la Secretaría de Estado) y `description`; un acreedor garantizado incluye `assignor`. Los deudores incluyen personas, con sus direcciones, tal como las listan los registros.
Cada uno incluye `filing` (`{ filing_number, transaction_type, document_type, filing_date }`, el registro que lo lista) y `lien` (`{ initial_filing_number, filing_type, filed_date, filings, lapse_date, terminated, in_force }`). Croma calcula `in_force` al servir la respuesta: false una vez que un registro terminó el gravamen o pasó su fecha de caducidad, true mientras ninguna de las dos, y null cuando el gravamen no tiene fecha de caducidad ni terminación, como la mayoría de los gravámenes fiscales federales y hospitalarios.
## Un gravamen completo
`POST /us/colorado-ucc/lien/v1` Dataset
Resuelve un gravamen por cualquiera de sus números de registro.
| Campo | Tipo | Notas |
| --------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `filing_number` | string | **Obligatorio.** El número del registro inicial o de cualquier modificación, p. ej. `20262077023`; los registros antiguos se ven como `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" }'
```
Devuelve `found`, `filing_number`, `as_of` y `lien` (null cuando no se encuentra): `initial_filing_number`, `filing_type` (p. ej. `ucc`, `lien_irs`, `lien_hosp`, `efs`), `filed_date`, `lapse_date`, `terminated`, `in_force`, `filings[]` del más antiguo al más reciente (cada uno `{ 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[]` y `collateral[]` (cada una `{ collateral_id, file_id, description, additional_description, county, farm_product, ... }`, siendo `additional_description` el texto de quien presentó el registro), hasta 1.000 de cada uno, con sus totales.
Esquemas, todos los campos de respuesta y un playground interactivo.