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

# Error Handling

> Cómo interpretar y manejar los errores de la API de Verifica

## Overview

La API de Verifica utiliza los códigos de estado HTTP estándar para indicar el resultado de cada solicitud. Cuando ocurre un error, la respuesta sigue un formato consistente con los campos `type`, `status`, `message` y `errors`.

## Estructura del Error

<ResponseField name="type" type="string">
  Identificador del tipo de error (ej: "unauthorized")
</ResponseField>

<ResponseField name="status" type="integer">
  Código de estado HTTP del error (ej: 401)
</ResponseField>

<ResponseField name="message" type="string">
  Descripción legible del error
</ResponseField>

<ResponseField name="errors" type="object | null">
  Detalle adicional de los errores cuando aplica (ej: errores de validación por campo). Es `null` si no hay detalle.
</ResponseField>

## Códigos de Error

| Código | Descripción                                                        |
| ------ | ------------------------------------------------------------------ |
| `400`  | Solicitud inválida — parámetros faltantes o con formato incorrecto |
| `401`  | Token de autenticación inválido o faltante                         |
| `422`  | Error de validación — uno o más campos requeridos no son válidos   |
| `429`  | Demasiadas solicitudes — se ha excedido el límite de rate          |
| `500`  | Error interno del servidor                                         |

## Ejemplo de Respuesta de Error

```json theme={null}
{
  "type": "unauthorized",
  "status": 401,
  "message": "Necesitas un API Key válido para realizar una solicitud correctamente.",
  "errors": null
}
```

## Recomendaciones

* **`4xx`**: revisa tu solicitud (autenticación, parámetros y formato) antes de reintentar.
* **`429`**: aplica reintentos con backoff exponencial. Consulta la guía de [Entendiendo la Quota](/guides/quota).
* **`500`**: reintenta más tarde. Si el problema persiste, escríbenos a [soporte@verifica.id](mailto:soporte@verifica.id).