> ## 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: deudores alimentarios morosos

> Valida un certificado del Registro de Deudores Alimentarios Morosos (REDAM) de Colombia por su código de verificación: si la persona está inscrita, las fechas y el PDF.

El Registro de Deudores Alimentarios Morosos (REDAM, Ley 2097 de 2021) es el
registro colombiano de las personas que deben tres o más cuotas alimentarias
fijadas por un juez, una conciliación o un título ejecutivo. Estar inscrito
impide ocupar cargos públicos, contratar con el Estado y salir del país, entre
otras consecuencias, así que empleadores, entidades de crédito y entidades
públicas piden el certificado REDAM antes de contratar, prestar o vincular.
Cada persona descarga su propio certificado desde la Carpeta Ciudadana Digital
y lo entrega; este endpoint valida el certificado que le entregaron por el
código impreso en él y conserva una copia del PDF.

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

Un certificado, por el código de verificación impreso bajo su texto.

| Campo | Tipo | Notas |
| - | - | - |
| `verification_code` | string | **Obligatorio.** Las 10 letras y dígitos que siguen a "Código Verificación" en el certificado. No distingue mayú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" }'
```

La respuesta repite el código y trae lo que dice el certificado:

| Campo | Notas |
| - | - |
| `found` | `false` cuando el registro no conoce ningún certificado con ese código (un error de digitación, una falsificación o un certificado que el registro ya no conserva); los demás campos quedan en `null`. |
| `document_type`, `document_number` | La persona a la que se refiere el certificado, como aparece impresa. El certificado no imprime el nombre. |
| `is_registered` | `true` cuando la persona está inscrita en el registro (en mora de cuotas alimentarias); `false` para el certificado limpio. |
| `status` | La frase del veredicto del certificado, textual. |
| `issued_at` | Cuándo expidió el registro el certificado (ISO 8601, UTC). |
| `valid_until` | Último día de validez del certificado, `aaaa-mm-dd`. Los certificados valen tres meses. |
| `document_url` | Nuestra copia del PDF del certificado, idéntica byte a byte a la del registro. |
| `source_document_url` | La página de validación del propio registro para este código. |

> [!NOTE]
>
> Un certificado es una foto del registro el día en que se expidió, y la
> inscripción se cancela cuando se paga la deuda. Para una respuesta actual
> pida a la persona un certificado nuevo: lo descarga gratis desde la Carpeta
> Ciudadana Digital.

> [!NOTE]
>
> Conservar el PDF del certificado toma un momento, así que esta consulta es un
> [trabajo asíncrono](https://docs.usecroma.com/es/async-jobs.md). Por defecto la solicitud espera en línea
> y devuelve `{ data }`, o puedes hacer polling o enviar un `callback_url`.
> La mayoría de las consultas terminan en unos segundos.

> [card] [Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


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