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

# Audit Events

Audit events are every decision IAM makes, with who sent the request, what it needed, and what was decided. They are what an organization reads to see what a key did last month, or who changed a managed organization.

> [!WARNING]
>
> **Preview.** Not available yet.

## An Event

```json GET /v2/iam/audit_events theme={null}
{
  "data": [
    {
      "principal": "user:user@example.com",
      "via": "dlg_bluebird",
      "action": "number_order.create",
      "decision": "allow",
      ...
    }
  ],
  ...
}
```

| Field | What It Holds |
| - | - |
| `principal` | The user or service account that sent the request, never the organization it worked in. |
| `via` | The [delegation](https://developers.telnyx.com/docs/iam/access/delegations.md#a-delegation) the request came through, when a manager worked in a managed organization. |
| `action` | The action the route declared. |
| `decision` | `allow` or `deny`, with the reason a [denied request](https://developers.telnyx.com/docs/iam/troubleshooting/denied-requests.md) shows. |

Events are listed per organization, so a managed organization's log names the manager org user who acted in it.

## Credential Inventory

Every credential shows when and from where it was last used, and the actions it sent in the last thirty days, so a key that is really one server reading invoices can be moved to a [service account](https://developers.telnyx.com/docs/iam/principals/service-accounts.md) with exactly that role.

```json GET /v2/iam/api_keys/{id} theme={null}
{
  "owner": "user:user@example.com",
  "scope": null,
  "last_used_at": "2026-10-27T09:12:44Z",
  "last_ip": "34.201.7.18",
  "actions_last_30_days": ["balance.read", "invoice.read"]
}
```
