# Respuestas de error

> Formato común de las respuestas de error de la API de informes de fraude: campos, códigos de estado y cómo usar el identificador de trazabilidad con soporte.

URL: https://docs.ironchip.com/fraude/referencia/errores/

Todas las respuestas de error de la API de informes siguen el mismo formato: un mensaje, un código de error, la causa cuando existe y un identificador de trazabilidad para soporte. Usa esta página para tratar los errores en tu backend y para abrir un ticket con los datos que necesita soporte.

```json
{
  "error": "<mensaje de error>",
  "error_code": "<código de error>",
  "cause": "<causa del error>",
  "traceability_id": "<identificador de la petición>"
}
```

## Campos

| Campo             | Tipo   | Descripción                                                       |
| ----------------- | ------ | ----------------------------------------------------------------- |
| `error`           | string | Mensaje de error.                                                 |
| `error_code`      | string | Código de error, para tratarlo en tu backend.                     |
| `cause`           | string | Causa del error, cuando existe.                                   |
| `traceability_id` | string | Identificador de la petición, para que soporte pueda localizarla. |

## Códigos de estado

Las operaciones de la API de informes pueden responder con estos errores, todos con el formato anterior:

| Código | Estado                | Cuándo                                                                                                                                                             |
| ------ | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `400`  | Bad Request           | Un parámetro no es válido (`limit` mayor que 100 o no numérico, `page`, `since` o `timeout` con formato incorrecto) o el cuerpo del feedback no es un JSON válido. |
| `404`  | Not Found             | No hay informes para la aplicación o la transacción indicada.                                                                                                      |
| `500`  | Internal Server Error | Error interno del servidor.                                                                                                                                        |

La [referencia de la API](https://docs.ironchip.com/fraude/api/referencia/) detalla las respuestas de cada operación.

:::tip[Al abrir un ticket]
Incluye siempre el `traceability_id`: permite a soporte localizar la petición exacta.
:::