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

# Gravames UCC do Colorado

> Todo registro UCC e de gravame na Secretaria de Estado do Colorado desde 1966, cerca de 2,6 milhões, caducados, encerrados e vigentes: encontre os gravames contra uma empresa ou pessoa pelo nome do devedor, os que um credor detém pelo nome do credor garantido, e leia um gravame completo com suas alterações, partes, garantias e se ainda está vigente.

A Secretaria de Estado do Colorado registra os gravames apresentados contra
empresas e pessoas do Colorado: declarações de financiamento UCC que garantem um
empréstimo ou um arrendamento com os bens do devedor, e gravames fiscais
federais, hospitalares e outros legais. Cada registro desde 1966 é mantido, em
qualquer situação, com suas alterações, continuações e encerramentos, os
devedores e credores garantidos que lista e as garantias que descreve. Um
gravame é seu registro inicial e todo registro que o nomeia, e se ainda está
vigente é calculado a cada consulta. Atualizado diariamente.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Encontrar gravames contra um devedor

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

Busca entre os devedores pelo nome, ou pelo id de uma entidade do Colorado.

| Campo             | Tipo    | Notas                                                                                                                       |
| ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `query`           | string  | Opcional. Palavras do nome. Todas devem coincidir; sem stemming.                                                            |
| `organization_id` | string  | Opcional. O id de uma entidade do Colorado na Secretaria de Estado, só dígitos, como quem apresentou o registro o escreveu. |
| `page`            | integer | Opcional. Página, começa em 1. Por padrão `1`.                                                                              |
| `per_page`        | integer | Opcional. Resultados por página, 1-50. Por padrão `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" }'
```

Retorna `as_of`, `query`, `organization_id`, `total`, `page`, `per_page`, `total_pages`, `count` e `debtors[]`, por nome.

Cada registro traz seu id (`debtor_id` ou `secured_party_id`), `file_id`, `name`, `organization_name`, `first_name`, `middle_name`, `last_name`, `suffix` e `address` (`{ line_1, line_2, city, state, zip, zip_4, country }`), e `action_type` e `record_status` (se o registro está vigente, não o gravame). Um devedor traz ainda `organization_type`, `organization_jurisdiction`, `organization_id` (para uma entidade do Colorado, muitas vezes seu id na Secretaria de Estado) e `description`; um credor garantido traz `assignor`. Os devedores incluem pessoas, com seus endereços, como os registros as listam.

Cada um traz `filing` (`{ filing_number, transaction_type, document_type, filing_date }`, o registro que o lista) e `lien` (`{ initial_filing_number, filing_type, filed_date, filings, lapse_date, terminated, in_force }`). A Croma calcula `in_force` ao servir a resposta: false depois que um registro encerrou o gravame ou passou sua data de caducidade, true enquanto nenhuma das duas, e null quando o gravame não tem data de caducidade nem encerramento, como a maioria dos gravames fiscais federais e hospitalares.

## Encontrar os gravames de um credor

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

Busca entre os credores garantidos pelo nome. Quem apresenta os registros
escreve um credor de muitas formas (`Wells Fargo Bank, N.A.`,
`WELLS FARGO BANK, NATIONAL ASSOCIATION`); busque as palavras distintivas.

| Campo      | Tipo    | Notas                                                            |
| ---------- | ------- | ---------------------------------------------------------------- |
| `query`    | string  | Opcional. Palavras do nome. Todas devem coincidir; sem stemming. |
| `page`     | integer | Opcional. Página, começa em 1. Por padrão `1`.                   |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `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" }'
```

Retorna `as_of`, `query`, `total`, `page`, `per_page`, `total_pages`, `count` e `secured_parties[]`, por nome.

Cada registro traz seu id (`debtor_id` ou `secured_party_id`), `file_id`, `name`, `organization_name`, `first_name`, `middle_name`, `last_name`, `suffix` e `address` (`{ line_1, line_2, city, state, zip, zip_4, country }`), e `action_type` e `record_status` (se o registro está vigente, não o gravame). Um devedor traz ainda `organization_type`, `organization_jurisdiction`, `organization_id` (para uma entidade do Colorado, muitas vezes seu id na Secretaria de Estado) e `description`; um credor garantido traz `assignor`. Os devedores incluem pessoas, com seus endereços, como os registros as listam.

Cada um traz `filing` (`{ filing_number, transaction_type, document_type, filing_date }`, o registro que o lista) e `lien` (`{ initial_filing_number, filing_type, filed_date, filings, lapse_date, terminated, in_force }`). A Croma calcula `in_force` ao servir a resposta: false depois que um registro encerrou o gravame ou passou sua data de caducidade, true enquanto nenhuma das duas, e null quando o gravame não tem data de caducidade nem encerramento, como a maioria dos gravames fiscais federais e hospitalares.

## Um gravame completo

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

Resolve um gravame por qualquer um de seus números de registro.

| Campo           | Tipo   | Notas                                                                                                                                            |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `filing_number` | string | **Obrigatório.** O número do registro inicial ou de qualquer alteração, p. ex. `20262077023`; os registros antigos se parecem com `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" }'
```

Retorna `found`, `filing_number`, `as_of` e `lien` (null quando não encontrado): `initial_filing_number`, `filing_type` (p. ex. `ucc`, `lien_irs`, `lien_hosp`, `efs`), `filed_date`, `lapse_date`, `terminated`, `in_force`, `filings[]` do mais antigo ao mais recente (cada um `{ 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[]` e `collateral[]` (cada uma `{ collateral_id, file_id, description, additional_description, county, farm_product, ... }`, sendo `additional_description` o texto de quem apresentou o registro), até 1.000 de cada, com seus totais.

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>