# Consultar evidências

> Lista as evidências registradas numa transação, da mais antiga para a mais recente.

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

Lista as evidências registradas numa transação, da mais antiga para a mais recente.

## Endpoint

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

## Autenticação

Basic Auth com `client_id:client_secret`. Ver [Autenticação](https://doc.rapidchargeback.com/referencia/autenticacao/).

## Query params

| Param | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| `transaction_id` | string (UUID) | Transação cujas evidências você quer ver | Sim |

Diferente do `POST`, aqui **não** existe busca por `transaction_ref`: a consulta é só pelo UUID da Rapid.

## Validações

| Regra | Resposta |
|---|---|
| `transaction_id` ausente | `422 VALIDATION_ERROR`: *transaction_id é obrigatório* |
| Credencial ausente ou inválida | `401 UNAUTHORIZED` |

Transação de outra empresa, ou inexistente, devolve **lista vazia**, porque a consulta é filtrada pela sua empresa, não dá erro.

## Exemplo de requisição

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

## Exemplos de resposta

### Sucesso (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 | Descrição |
|---|---|
| `id` | ID da evidência |
| `type` | O tipo informado no registro |
| `payload` | O objeto que você enviou, como enviou. A ordem das chaves não é preservada |
| `captured_at` | Quando o fato aconteceu, como você informou |
| `created_at` | Quando a Rapid recebeu o registro |

### Sem evidências (200)

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

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

```json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "transaction_id é obrigatório"
  }
}
```

## Próximos passos

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