> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt.

# Audit logs

This feature is available on Postman Enterprise plans. For more information, see the [pricing page](https://www.postman.com/pricing/).

Audit logs display events related to your team, team members, and billing. [Admins and Super Admins](/docs/administration/roles-and-permissions/#team-roles) can view which team member performed an action, and when they did so. Events include team members signing in to your team, creating a Postman API key, adding a team member, upgrading to a paid plan, and more.

Postman offers audit logs for 180 days.

## View audit logs in the dashboard

Admins and Super Admins can view audit logs for your team in your [Audit Logs dashboard](https://go.postman.co/audit). To view audit logs, open Postman and select **Team > Audit Logs** in the Postman header.

Each audit log event includes the following information:

* The team member who performed the action, and their email address.
* The event type, and a description of the event.
* The team member's IP address.
* The date and time of the action, including the team member's time zone.

![Audit logs dashboard](https://assets.postman.com/postman-docs/audit-logs-dashboard-v9.jpg)

You can use filters to view audit log events by date range, event type, and team member. Select your filters, then click **Apply**.

## Export audit logs from the dashboard

You can filter the results of the audit logs, and export the results as a CSV file.

To export audit logs, do the following:

1. Filter your results by selecting a date range, event type, and team member, then click **Apply**. If you don't filter your results, Postman exports all data in your audit logs from the last seven days.
2. Click **Export Audit Logs**
3. Click **Export** to confirm. You'll receive an email with the CSV file.
4. In the email, click **Download Audit Logs** to download the CSV file. The link in the email is valid for one hour.

## Access audit logs with the Postman API

You can also [access audit logs with the Postman API](https://www.postman.com/postman/postman-public-workspace/folder/tl4rymv/audit-logs), enabling you to integrate Postman's audit logs with your security information and event management (SIEM) tools.

To get started with the Postman API, you must first [generate a Postman API key](/docs/reference/postman-api/authentication/#generate-a-postman-api-key). Learn more about the [Postman API](/docs/reference/postman-api/intro-api/), and how to integrate it into your development toolchain.

For a complete list of audit log events, use the Postman API's [GET](https://www.postman.com/postman/postman-public-workspace/request/12959542-63c85835-db12-4576-ac7a-a2e9c3cd820c?ctx=documentation) `/audit-actions` endpoint.

Each audit log event has the following attributes in the response:

| Name         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`         | An integer representing the unique identifier of the audit log event.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `ip`         | A string with the IP address of the actor who performed the action.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `userAgent`  | A string with the user agent of the actor.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `action`     | A string with the event type.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `timestamp`  | A string with the date and time when the actor performed the action. The time stamp is represented using the [ISO 8601](https://datatracker.ietf.org/doc/html/rfc3339) date and time format.                                                                                                                                                                                                                                                                                                                                                                                                               |
| `message`    | A string with the description of the audit log event.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `data`       | An object that holds the `actor`, `user`, `team`, and `variables` objects.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `actor`      | <p>An object with information about the team member who performed the action. For example, a team member is the `actor` when they sign in to Postman. The object includes the following properties:</p><ul><li><code>name</code> - A string with the actor's name.</li><li><code>username</code> - A string with the actor's username.</li><li><code>email</code> - A string with the actor's email address.</li><li><code>id</code> - An integer representing the unique identifier of the actor.</li><li><code>active</code> - A Boolean of whether the actor's account is active in the team.</li></ul> |
| `user`       | An object with information about the team member who was affected by the action. For example, a team member is the `user` when their role is updated by another team member. The object includes the following properties:<ul><li><code>name</code> - A string with the user's name.</li><li><code>username</code> - A string with the user's username.</li><li><code>email</code> - A string with the user's email address.</li><li><code>id</code> - An integer representing the unique identifier of the user.</li></ul>                                                                                |
| `team`       | An object with information about the actor and user's team. The object includes the following properties:<ul><li><code>name</code> - A string with the team's name.</li><li><code>id</code> - An integer representing the unique identifier of the team.</li></ul>                                                                                                                                                                                                                                                                                                                                         |
| `variables`  | An object with details about the performed action. For example, details about the created API key or updated roles for a user.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `nextCursor` | A string that represents the cursor of the next page.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |