> ## 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.

# Audit trail

> Review the immutable, chronological record of every action performed on BCB mail, and export it as CSV for compliance evidence.

The **Audit** trail is a chronological, immutable record of every action performed on Banco Central do Brasil (BCB) mail in BC Correios. It provides traceability and regulatory compliance evidence, and it can be exported as CSV.

## Accessing the Audit trail

***

Open **Reporter** > **BC Correios** > **Audit** from the left-side menu.

<Note>
  The Audit trail requires the `audit:get` permission, which also covers CSV export. Without it, you see a "not authorized" page. Audit events are retained for 5 years.
</Note>

## Reading the audit table

***

Each row records one event:

| Column     | Description                                                          |
| :--------- | :------------------------------------------------------------------- |
| **Action** | The type of event (see the list below).                              |
| **User**   | The user who performed the action, or `System` for automated events. |
| **Mail**   | The related mail, when applicable. Click to open its detail view.    |
| **Date**   | When the event occurred.                                             |

### Tracked actions

| Action                  | When it is recorded                        |
| :---------------------- | :----------------------------------------- |
| `Mail received`         | New mail arrives from the BCB.             |
| `Mail read`             | A mail is opened.                          |
| `Mail archived`         | A mail is archived locally.                |
| `Mail restored`         | An archived mail is restored.              |
| `Mail cancelled`        | The BCB reports a mail as cancelled.       |
| `Mail sent`             | A communication is transmitted to the BCB. |
| `Attachment downloaded` | An attachment is downloaded.               |
| `Search performed`      | An operator runs a search.                 |
| `Settings updated`      | Configuration is changed.                  |
| `BCB connection tested` | A connection test is run.                  |

## Filtering events

***

Use the filter bar to focus the trail:

* **From date** and **To date** — restrict to a date range. The default range is the last 7 days.
* **Action** — show only one action type, or all actions.
* **Per page** — control how many rows are shown.

## Exporting to CSV

***

Click **Export CSV** to download the currently filtered events. The export honors the active action and date-range filters, so you can produce a targeted compliance report.

<Tip>
  Export after setting a date range and action filter to generate evidence for a specific event type or reporting period.
</Tip>