# List evidence

> Lists the evidence recorded on a transaction, from oldest to newest.

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

Lists the evidence recorded on a transaction, from oldest to newest.

## Endpoint

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

## Authentication

Basic Auth with `client_id:client_secret`. See [Authentication](https://doc.rapidchargeback.com/en/referencia/autenticacao/).

## Query params

| Param | Type | Description | Required |
|---|---|---|---|
| `transaction_id` | string (UUID) | Transaction whose evidence you want to see | Yes |

Unlike the `POST`, there is **no** lookup by `transaction_ref` here: the query is by Rapid's UUID only.

## Validations

| Rule | Response |
|---|---|
| `transaction_id` missing | `422 VALIDATION_ERROR`: *transaction_id is required* |
| Missing or invalid credential | `401 UNAUTHORIZED` |

A transaction from another company, or a nonexistent one, returns an **empty list**, because the query is filtered by your company; it does not return an error.

## Request example

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

## Response examples

### Success (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"
    }
  ]
}
```

| Field | Description |
|---|---|
| `id` | Evidence ID |
| `type` | The type given in the record |
| `payload` | The object you sent, as you sent it. Key order is not preserved |
| `captured_at` | When the fact happened, as you reported it |
| `created_at` | When Rapid received the record |

### No evidence (200)

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

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

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

## Next steps

- [Record evidence](https://doc.rapidchargeback.com/en/canais/evidence/registrar-evidencia/)
- [Response codes](https://doc.rapidchargeback.com/en/referencia/codigos-de-resposta/)