# report — reportar resultados

> POST /report informa si el resultado de una tarea fue correcto; reporta tanto los éxitos como los fallos con honestidad. Los fallos de tipos de reconocimiento de imágenes reportados dentro de 1 hora desde la creación de la tarea se liquidan con reembolso tras unas 24 horas.

Source: https://docs.yescaptcha.com/es/api/report/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/api/report/

`report` sirve para decirnos si el resultado de un grupo de tareas fue correcto o no. **Reporta tanto los éxitos como los fallos.** Cuando reportas como incorrecto el resultado de un tipo de reconocimiento de imágenes, los casos que cumplen las condiciones reciben un reembolso de puntos tras unas 24 horas; los reportes también se usan para evaluar y mejorar el reconocimiento.

- POST `https://api.yescaptcha.com/report` (Endpoint global)
- POST `https://cn.yescaptcha.com/report` (Endpoint China)

## Parámetros de la solicitud

| Campo | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | array of string | Sí | Lista de IDs de tarea; puedes reportar varias a la vez |
| `isSuccess` | boolean | Sí | `true` si el resultado fue correcto, `false` si fue incorrecto |

No se necesita `clientKey`: el ID de tarea ya identifica la tarea.

```json
{
  "id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"],
  "isSuccess": false
}
```

## Respuesta

```json
{
  "errorId": 0,
  "status": "success"
}
```

## Reporta con honestidad

Los reportes sirven tanto para liquidar el reembolso como para evaluar y mejorar el reconocimiento, así que repórtalos según el resultado real:

-   Reporta `isSuccess: true` para las tareas con resultado correcto y `false` para las incorrectas. Los reportes que solo marcan fallos, o que marcan todo como fallo sin importar el resultado, no se toman como referencia en las estadísticas ni en la liquidación.
-   La tasa de fallos se calcula sobre todas las tareas que creaste en ese periodo, no solo sobre las que reportaste. Reportar más fallos no te da más reembolsos: si tu tasa de fallos es claramente superior a la del mismo periodo, el reembolso se calcula solo con la tasa de fallos de ese periodo.
-   Cuando una verificación usa varias imágenes (por ejemplo, FunCaptcha pide 5 rondas) y no sabes cuál falló, puedes reportar todo el grupo de tareas como fallido; cuando la verificación se supera, reporta igualmente todo el grupo como exitoso.

## Reembolso tras reportar un fallo

-   Solo 5 tipos de reconocimiento de imágenes admiten reembolso: `FunCaptchaClassification`, `HCaptchaClassification`, `ReCaptchaV2Classification`, `AwsClassification` y `bCaptchaClassification`.
-   Solo cuentan los reportes hechos dentro de **1 hora** desde la creación de la tarea; cada tarea se reembolsa una sola vez.
-   El reembolso no es inmediato: se liquida en conjunto **unas 24 horas después**.
-   En la liquidación se compara con otros usuarios que tuvieron la misma pregunta en el mismo periodo; si tu tasa de fallos reportada es claramente superior a la de ese periodo, el reembolso se calcula con la tasa de fallos del periodo.
-   Si tienes dudas sobre una liquidación, puedes [contactar con soporte](https://docs.yescaptcha.com/es/help/contact.md) para apelar.

En los tipos que devuelven token (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha, etc.), el sitio de destino decide si el token es válido, por lo que el reporte no genera reembolso. Resumen de las reglas de cobro: [Facturación y reembolso de puntos](https://docs.yescaptcha.com/es/getting-started/billing.md).