SDK / API ReferenceLogs
List Logs
List activity logs for the identity
List activity log entries for the authenticated identity. Supports filtering by category, status, severity, and action.
Request
import { Loomal } from "@loomal/sdk";
const loomal = new Loomal({ apiKey: process.env.LOOMAL_API_KEY! });
const { logs, count } = await loomal.logs.list({
limit: 50,
category: "mail",
status: "success",
});import os
from loomal import Loomal
loomal = Loomal(api_key=os.environ["LOOMAL_API_KEY"])
result = loomal.logs.list(limit=50, category="mail", status="success")loomal logs list --limit 50 --category mail --status successlogs.listcurl "https://api.loomal.ai/v0/logs?limit=50&category=mail&status=success" \
-H "Authorization: Bearer loid-your-api-key"Query Parameters
| Param | Type | Default | Description |
|---|---|---|---|
limit | number | 50 | Max results (max 100) |
category | string | — | Filter: mail, vault, identity, auth, calendar |
status | string | — | Filter: success, error, denied |
severity | string | — | Filter: INFO, WARNING, ERROR |
action | string | — | Filter by action name (e.g., mail.send) |
Response 200
{
"logs": [
{
"id": "log_abc123",
"action": "mail_send",
"category": "mail",
"status": "success",
"severity": "INFO",
"description": "Sent email to user@example.com",
"targetType": "message",
"targetId": "msg_xyz",
"createdAt": "2026-04-06T12:00:00.000Z"
}
],
"count": 1
}