---
title: Audit Logs
description: Track actions across your instance with audit logs. See who did what, when, from where, and whether a passkey was used, from the dashboard or the API.
date: 2026-04-24
category: New Feature
categoryType: feature
isChangelog: true
---

You can now see a history of actions that happen inside your instance, who did it, how, and from where.

<!--more-->

## TL;DR

- Audit trail for actions on your instance
- Dashboard UI under **Settings → Audit logs**
- API endpoints for programmatic access
- Tracks actor identity, passkey usage, IP address, country, user agent, and metadata
- Distinguishes between dashboard (user) and API key actions
- Filterable by feature, operation, actor type, user ID, API key ID, and entity ID

## What's logged

Create, update, and delete operations across the platform are recorded:

- **Customers** - create, update, delete
- **Bank accounts** - create, delete
- **Blockchain wallets** - create, delete
- **Blockchain operations** - asset trustlines, USDB minting, Solana delegation
- **Offramp wallets** - create
- **Virtual accounts** - create, update
- **Wallets** - create, delete
- **Payins** - create
- **Payouts** - create, update (document submission)
- **Transfers** - create
- **Customer limit increases** - create
- **API keys** - create, delete
- **Team members** - update role, remove
- **Invites** - create, accept, delete
- **Partner fees** - create, delete
- **Billing** - update details, pay invoice, collect fees, portal session
- **Onboarding** - every step from business details to completion
- **Webhook endpoints** - create, delete

## What each log captures

Every audit log entry includes:

| Field | Description |
|-------|-------------|
| **Actor** | The user or API key that performed the action |
| **Actor type** | `user` (dashboard) or `api_key` (programmatic) |
| **Passkey** | Whether the action was verified with a passkey |
| **Feature** | The area of the platform (e.g. `bank_account`, `payout`) |
| **Operation** | `create`, `update`, or `delete` |
| **Entity** | The type and ID of the affected resource |
| **IP address** | Origin IP of the request |
| **Country** | Country derived from the request |
| **User agent** | Browser or SDK making the request |
| **Metadata** | Additional context specific to the action |

## Dashboard

Navigate to **Settings → Audit logs** to browse your instance's activity. Click any entry to open the detail pane with the full breakdown: actor info, request metadata, and action-specific context.

Use the filters to narrow down by feature, operation, actor type, user ID, API key ID, or entity ID.

## API

Two new endpoints are available:

```
GET /v1/instances/{instance_id}/audit-logs
GET /v1/instances/{instance_id}/audit-logs/{id}
```

The list endpoint returns a paginated list of audit logs for your instance. It supports cursor-based pagination and the same filters available in the dashboard, plus date range filtering with `start_date` and `end_date`. The detail endpoint returns a single audit log entry by ID.

## Permissions

Only **owner** and **admin** roles can view audit logs.