> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fraudeg.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /verifications

> Leer una verificación o listar las de tu compañía

Dos lecturas, mismo host, scope `KYC_READ` (también lo cubre `KYC_WRITE`).
`{API_BASE}` es la URL base de tu [entorno](/entornos).

La decisión te llega por [webhook](/identidad/webhooks). Estas lecturas sirven para
reconciliar, para una pantalla interna, o cuando el aviso se perdió.

Los campos nulos **no se envían**. Una verificación sin decidir no trae la clave
`decision`. Comprueba ausencia, no `null`. Ignora campos que no reconozcas: se agregan
campos con el tiempo.

## GET /v1/verifications/{id}

```
GET {API_BASE}/v1/verifications/4821
```

```bash theme={null}
curl https://sandbox-api.fraudeg.com/api/v1/verifications/4821 \
  -H "X-Api-Key: tu_api_key"
```

### `data`

| Campo                 | Notas                                                                              |
| --------------------- | ---------------------------------------------------------------------------------- |
| `id`                  | Identificador de la verificación                                                   |
| `customer_ref`        | Tu identificador de la persona                                                     |
| `status`              | `PENDING`, `DECIDED`, `ABANDONED` o `UNKNOWN`                                      |
| `decision`            | Solo en `DECIDED`: `APPROVED`, `DECLINED` o `REVIEW`                               |
| `decision_rule`       | Código estable de **qué** produjo la decisión. Guárdalo; ramifica sobre `decision` |
| `flow_config_version` | Versión de tu política con la que se decidió, congelada en ese momento             |
| `created_at`          | UTC, sin offset en el texto. Interprétalo como UTC                                 |
| `decided_at`          | UTC, sin offset. Ausente si todavía no hay decisión                                |

El significado de cada `status` y cada `decision` está en
[Decisiones de identidad](/identidad/decisiones).

Una key con solo `KYC_READ` no puede crear nada: es la que conviene darle a un proceso que
únicamente reconcilia.

| HTTP  | Cuándo                                                                                         |
| ----- | ---------------------------------------------------------------------------------------------- |
| `401` | Key ausente, malformada o revocada                                                             |
| `403` | La key no puede usar esta ruta, o le falta `KYC_READ`                                          |
| `404` | No existe esa verificación **en tu compañía**. Una de otra compañía también es `404`, no `403` |

## GET /v1/verifications

Lista las verificaciones de tu compañía.

```
GET {API_BASE}/v1/verifications
```

```bash theme={null}
curl "https://api.fraudeg.com/api/v1/verifications?status=DECIDED&from=2026-09-12T00:00:00&to=2026-09-13T00:00:00" \
  -H "X-Api-Key: tu_api_key"
```

### Query

| Parámetro      | Notas                                                                                                           |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| `status`       | `PENDING`, `DECIDED`, `ABANDONED` o `UNKNOWN`                                                                   |
| `decision`     | `APPROVED`, `DECLINED` o `REVIEW`                                                                               |
| `customer_ref` | Tu identificador, coincidencia exacta                                                                           |
| `from`, `to`   | ISO date-time. `from` inclusive, `to` exclusive — un día es `from` medianoche `to` medianoche del día siguiente |
| `page`         | Desde cero. Por defecto `0`                                                                                     |
| `size`         | Por defecto `25`                                                                                                |

### `data`

Trae `verifications` (filas), `page`, `size`, `total_elements`, `total_pages` y `metrics`.

**`metrics` se calcula sobre el período, no sobre tus filtros.** Filtrar a `APPROVED` y ver
`declined: 0` sería una afirmación falsa sobre el negocio: los conteos ignoran a propósito
los filtros que sí obedecen las filas.

Las filas traen los mismos campos de decisión que el detalle, pensados para un vistazo;
no son una exportación de evidencia. Si necesitas el detalle, lee una verificación por
`id`.

Siguiente: [Webhooks](/identidad/webhooks).