# Consultar evidencias

> Lista las evidencias registradas en una transacción, de la más antigua a la más reciente.

Página: https://doc.rapidchargeback.com/es/canais/evidence/consultar-evidencias/

Lista las evidencias registradas en una transacción, de la más antigua a la más reciente.

## Endpoint

```
GET https://api.rapidchargeback.com/api/v1/evidence?transaction_id=<uuid>
```

## Autenticación

Basic Auth con `client_id:client_secret`. Ver [Autenticación](https://doc.rapidchargeback.com/es/referencia/autenticacao/).

## Query params

| Param | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| `transaction_id` | string (UUID) | Transacción cuyas evidencias quieres ver | Sí |

A diferencia del `POST`, aquí **no** existe búsqueda por `transaction_ref`: la consulta es solo por el UUID de Rapid.

## Validaciones

| Regla | Respuesta |
|---|---|
| `transaction_id` ausente | `422 VALIDATION_ERROR`: *transaction_id is required* |
| Credencial ausente o inválida | `401 UNAUTHORIZED` |

Una transacción de otra empresa, o inexistente, devuelve una **lista vacía**, porque la consulta se filtra por tu empresa; no da error.

## Ejemplo de solicitud

```bash
curl "https://api.rapidchargeback.com/api/v1/evidence?transaction_id=00000000-0000-0000-0000-000000000042" \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

## Ejemplos de respuesta

### Éxito (200)

```json
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-0000000000e1",
      "type": "terms_acceptance",
      "payload": {
        "ip": "203.0.113.10",
        "accepted_at": "2026-04-01T15:29:40Z",
        "terms_version": "v3.2"
      },
      "captured_at": "2026-04-01T15:29:41.000Z",
      "created_at": "2026-04-01T15:32:36.027Z"
    }
  ]
}
```

| Campo | Descripción |
|---|---|
| `id` | ID de la evidencia |
| `type` | El tipo informado en el registro |
| `payload` | El objeto que enviaste, tal como lo enviaste. El orden de las claves no se conserva |
| `captured_at` | Cuándo ocurrió el hecho, como lo informaste |
| `created_at` | Cuándo Rapid recibió el registro |

### Sin evidencias (200)

```json
{ "data": [] }
```

### Error: `transaction_id` ausente (422)

```json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "transaction_id is required"
  }
}
```

## Próximos pasos

- [Registrar evidencia](https://doc.rapidchargeback.com/es/canais/evidence/registrar-evidencia/)
- [Códigos de respuesta](https://doc.rapidchargeback.com/es/referencia/codigos-de-resposta/)