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

# REDAM: devedores de pensão alimentícia

> Valide um certificado do Registro de Deudores Alimentarios Morosos (REDAM) da Colômbia pelo código de verificação: se a pessoa está inscrita, as datas e o PDF.

O Registro de Deudores Alimentarios Morosos (REDAM, Ley 2097 de 2021) é o
registro colombiano das pessoas que devem três ou mais parcelas de pensão
alimentícia fixadas por um juiz, uma conciliação ou um título executivo. Estar
inscrito impede ocupar cargos públicos, contratar com o Estado e sair do país,
entre outras consequências, por isso empregadores, credores e entidades
públicas pedem o certificado REDAM antes de contratar, emprestar ou vincular.
Cada pessoa baixa o próprio certificado na Carpeta Ciudadana Digital e o
entrega; este endpoint valida o certificado que você recebeu pelo código
impresso nele e guarda uma cópia do PDF.

`POST /co/redam/certificate/v1` [Live](https://docs.usecroma.com/pt/live-lookups.md)

Um certificado, pelo código de verificação impresso abaixo do texto.

| Campo | Tipo | Notas |
| - | - | - |
| `verification_code` | string | **Obrigatório.** As 10 letras e dígitos após "Código Verificación" no certificado. Não diferencia maiúsculas de minúsculas. |

```bash theme={"dark"}
curl https://api.croma.run/co/redam/certificate/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "verification_code": "ABCDEFGH12" }'
```

A resposta repete o código e traz o que o certificado diz:

| Campo | Notas |
| - | - |
| `found` | `false` quando o registro não conhece nenhum certificado com esse código (um erro de digitação, uma falsificação ou um certificado que o registro já não guarda); os demais campos ficam `null`. |
| `document_type`, `document_number` | A pessoa a que o certificado se refere, como impresso nele. O certificado não imprime o nome. |
| `is_registered` | `true` quando a pessoa está inscrita no registro (em atraso com pensão alimentícia); `false` para o certificado limpo. |
| `status` | A frase do veredito do certificado, literal. |
| `issued_at` | Quando o registro emitiu o certificado (ISO 8601, UTC). |
| `valid_until` | Último dia de validade do certificado, `aaaa-mm-dd`. Os certificados valem três meses. |
| `document_url` | Nossa cópia do PDF do certificado, idêntica byte a byte à do registro. |
| `source_document_url` | A página de validação do próprio registro para este código. |

> [!NOTE]
>
> Um certificado é um retrato do registro no dia em que foi emitido, e a
> inscrição é cancelada quando a dívida é paga. Para uma resposta atual, peça à
> pessoa um certificado novo: ela o baixa gratuitamente na Carpeta Ciudadana
> Digital.

> [!NOTE]
>
> Guardar o PDF do certificado leva um momento, por isso esta consulta é um
> [trabalho assíncrono](https://docs.usecroma.com/pt/async-jobs.md). Por padrão a solicitação aguarda e
> retorna `{ data }`, ou você pode fazer polling ou enviar um `callback_url`.
> A maioria das consultas termina em alguns segundos.

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> Esquemas, todos os campos de resposta e um playground interativo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.