Skip to main content

Audit Logs

Every action in Paratro is recorded in an immutable audit log. This provides full traceability for compliance reviews, internal investigations, and operational monitoring.

What Gets Logged

CategoryEvents
WalletsCreated, renamed, archived, key rotation
TransactionsCreated, approved, rejected, signed, broadcast, confirmed, failed
PoliciesCreated, updated, deleted
UsersInvited, role changed, removed, login, MFA setup
API KeysCreated, permissions changed, revoked
OrganizationSettings changed, billing updated

Log Entry Structure

Each audit log entry includes:
{
  "id": "log_abc123",
  "timestamp": "2026-03-20T10:30:00Z",
  "actor": {
    "id": "user_alice",
    "email": "alice@company.com",
    "role": "admin"
  },
  "action": "transaction.approved",
  "resource": {
    "type": "transaction",
    "id": "tx_xyz789"
  },
  "details": {
    "amount": "25000",
    "asset": "USDT",
    "approval_position": "2 of 2"
  },
  "ip_address": "203.0.113.42",
  "user_agent": "Paratro Dashboard/1.0"
}

Querying Audit Logs

curl "https://api.paratro.com/v1/audit-logs?action=transaction.*&from=2026-03-01&to=2026-03-20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter Parameters

ParameterDescription
actionFilter by action type (supports wildcards)
actor_idFilter by user who performed the action
resource_typeFilter by resource type (wallet, transaction, policy)
resource_idFilter by specific resource
from / toDate range

Log Retention

  • SaaS — Audit logs are retained for 1 year by default, with options to extend
  • Private Deployment — Configurable retention based on your compliance requirements

Export

Audit logs can be exported in JSON or CSV format for integration with external SIEM or compliance tools:
curl "https://api.paratro.com/v1/audit-logs/export?format=csv&from=2026-01-01" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o audit-logs.csv