> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Investigar uma decisão na trilha de auditoria (API)

> Encontre uma validação, leia por que o Tracer decidiu e verifique se a trilha de auditoria está íntegra.

Encontre uma validação, leia por que o Tracer decidiu e confira se a trilha de auditoria está íntegra.

## Participantes

***

* **Sua instituição.** Seu sistema lê as decisões e a trilha de auditoria delas.
* **Tracer.** Guarda as validações e os eventos de auditoria delas e verifica a cadeia de auditoria.

## Antes de começar

***

* Seu sistema pode chamar a API do Tracer com uma credencial válida. Veja o [guia de integração do Tracer](https://docs.lerian.studio/pt/products/tracer/integration-guide.md).
* A decisão veio de uma requisição de validação do seu sistema. Veja [Validar uma transação antes do ledger](https://docs.lerian.studio/pt/diagrams/lerian-products/tracer-validate-before-ledger.md).

## Diagrama

***

![Investigar uma decisão na trilha de auditoria](https://mintcdn.com/lerian-49cb71fc/WuRfbo_y9uSbzyyX/images/pt/d2/id-tracer-investigate-a-decision.svg?fit=max\&auto=format\&n=WuRfbo_y9uSbzyyX\&q=85\&s=fc5d0bc60ddb7ceb7e0bb2b3aeecd03e)

## Passo a passo

***

| # | Origem | Destino | Mensagem | API da Lerian | O que acontece |
| - | - | - | - | - | - |
| 1 | Sua instituição | Tracer | API da Lerian | [`GET /v1/validations`](https://docs.lerian.studio/pt/reference/products/tracer/list-validations) | Liste as validações. Filtre por `decision`, `account_id`, `matched_rule_id`, `exceeded_limit_id`, `scheme`, `start_date` e `end_date`. |
| 2 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 1 | O Tracer devolve as validações encontradas, da mais nova para a mais antiga, com um cursor para a próxima página. |
| 3 | Sua instituição | Tracer | API da Lerian | [`GET /v1/validations/{validation_id}`](https://docs.lerian.studio/pt/reference/products/tracer/retrieve-validation) | Leia uma validação. |
| 4 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 3 | O Tracer devolve o contexto da transação que você enviou, a decisão, as regras que casaram e o uso dos limites. |
| 5 | Sua instituição | Tracer | API da Lerian | [`GET /v1/audit-events`](https://docs.lerian.studio/pt/reference/products/tracer/list-audit-events) | Liste os eventos de auditoria da validação. Use o `validationId` em `resource_id`. |
| 6 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 5 | O Tracer devolve os eventos de auditoria. |
| 7 | Sua instituição | Tracer | API da Lerian | [`GET /v1/audit-events/{audit_event_id}/verify`](https://docs.lerian.studio/pt/reference/products/tracer/verify-audit-event) | Verifique a cadeia de auditoria até o evento. |
| 8 | Tracer | Sua instituição | API da Lerian | Resposta ao passo 7 | O Tracer devolve `isValid`, o número de eventos que verificou e, quando a cadeia falha, `firstInvalidId`. |

## Como saber que terminou

***

A verificação devolve `isValid` como `true` para a cadeia até o evento.

## Regras

***

* O evento de auditoria de uma validação tem o tipo `TRANSACTION_VALIDATED`.
* Sem `start_date` e `end_date`, as duas listas cobrem os últimos 90 dias.
* A API não tem rota para alterar ou excluir uma validação ou um evento de auditoria.
* As reservas das transações do Midaz aparecem como eventos de auditoria com o tipo de recurso `reservation`. Elas não são validações.

## O que pode dar errado

***

| Situação | O que você vê | O que fazer |
| - | - | - |
| A validação é mais antiga que a janela padrão. | Uma lista vazia. | Amplie `start_date` e `end_date`. |
| A cadeia de auditoria falha na verificação. | `isValid` é `false`. | Envie a resposta ao suporte da Lerian. |

## Relacionados

***

* [Validar uma transação antes do ledger](https://docs.lerian.studio/pt/diagrams/lerian-products/tracer-validate-before-ledger.md)
* [Auditoria e conformidade](https://docs.lerian.studio/pt/products/tracer/audit-compliance.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.