Audit Logs
The audit log records all significant actions taken within your organization: API key creation, member changes, webhook updates, and more.
Requires ORG_ADMIN role.
Query audit logs
Terminal
curl "https://api.lira.com/api/v1/client/audit-logs?startDate=2026-03-01T00:00:00Z&limit=50" \
-H "Authorization: Bearer YOUR_TOKEN"Query parameters
| Parameter | Type | Description |
|---|---|---|
userId | string (UUID) | Filter by the user who performed the action |
action | string | Filter by action name (e.g. api_key.created) |
resource | string | Filter by resource type (e.g. api_key, webhook) |
startDate | string (ISO 8601) | Filter entries from this date |
endDate | string (ISO 8601) | Filter entries up to this date |
search | string | Free-text search across log entries |
page | integer | Page number for paginated results |
limit | integer | Results per page (max 100) |
Note
Providing page and/or limit returns a paginated response with a meta object. Omitting both returns a plain array.
Response
Plain array (no pagination)
JSON
[
{
"id": "log_...",
"organizationId": "org_...",
"userId": "usr_...",
"action": "api_key.created",
"resource": "api_key",
"metadata": { "keyId": "key_...", "name": "My sandbox key" },
"ipAddress": "102.88.12.1",
"userAgent": "Mozilla/5.0 ...",
"createdAt": "2026-03-09T10:00:00.000Z"
}
]Paginated response
JSON
{
"data": [ ... ],
"meta": {
"page": 1,
"limit": 50,
"total": 240,
"totalPages": 5
}
}Response fields
| Field | Type | Description |
|---|---|---|
id | string | Unique log entry ID |
organizationId | string | Your organization's ID |
userId | string | ID of the user who performed the action |
action | string | Machine-readable action name |
resource | string | Resource type affected |
metadata | object | Additional context for the action |
ipAddress | string | IP address of the request |
userAgent | string | User agent of the request |
createdAt | string | Timestamp of the action |