> ## 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: alimony debtors register

> Validate a certificate from Colombia's Registro de Deudores Alimentarios Morosos (REDAM) by its verification code: whether the person is inscribed, the dates, and the PDF.

The Registro de Deudores Alimentarios Morosos (REDAM, Ley 2097 de 2021) is
Colombia's register of people who have fallen three or more instalments behind
on child support or alimony set by a court, a conciliation or an enforceable
title. Being inscribed bars a person from public office, from contracting with
the State and from leaving the country, among other consequences, so employers,
lenders and public entities ask for the REDAM certificate before hiring,
lending or contracting. Each person downloads their own certificate from
Carpeta Ciudadana Digital and hands it over; this endpoint validates the
certificate they gave you by the code printed on it, and keeps a copy of the
PDF.

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

One certificate, by the verification code printed under its text.

| Field | Type | Notes |
| - | - | - |
| `verification_code` | string | **Required.** The 10 letters and digits after "Código Verificación" on the certificate. Case does not matter. |

```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" }'
```

The response echoes the code and carries what the certificate says:

| Field | Notes |
| - | - |
| `found` | `false` when the register knows no certificate under this code (a typo, a forgery, or a certificate the register no longer keeps); every other field is then `null`. |
| `document_type`, `document_number` | The person the certificate is about, as printed on it. The certificate prints no name. |
| `is_registered` | `true` when the person is inscribed in the register (in arrears on child support or alimony); `false` for the clean certificate. |
| `status` | The certificate's verdict sentence, verbatim. |
| `issued_at` | When the register issued the certificate (ISO 8601, UTC). |
| `valid_until` | Last day the certificate is valid, `yyyy-mm-dd`. Certificates are valid for three months. |
| `document_url` | Our copy of the certificate PDF, byte-identical to the register's. |
| `source_document_url` | The register's own validation page for this code. |

> [!NOTE]
>
> A certificate is a snapshot of the register on the day it was issued, and an
> inscription is cancelled once the debt is paid. For a current answer ask the
> person for a fresh certificate: they download it free of charge from Carpeta
> Ciudadana Digital.

> [!NOTE]
>
> Keeping the certificate's PDF takes a moment, so this lookup is an
> [async job](https://docs.usecroma.com/async-jobs.md). By default the request waits inline and returns
> `{ data }`, or you can poll or pass a `callback_url`. Most calls finish in
> a few seconds.

> [card] [Full reference](https://docs.usecroma.com/api-reference/overview.md)
>
> Schemas, all response fields, and an interactive playground.


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