API ReferenceAudit
Get Audit Summary
Aggregated event counts grouped by action for a time range.
Endpoint
GET /v1/audit/events:summaryBase URL: https://<Domain id="api"/>
Authentication: Bearer token with audit:read scope.
Returns per-action counts for the specified range. Useful for dashboards that compare activity week-over-week.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
start_time | RFC 3339 | Yes | Range start |
end_time | RFC 3339 | Yes | Range end |
organization_id | string | No | Scope to one org |
Example
const res = await fetch(
"https://api-id.avnology.net/v1/audit/events:summary?" +
new URLSearchParams({
start_time: "2026-04-10T00:00:00Z",
end_time: "2026-04-17T00:00:00Z",
}),
{ headers: { Authorization: `Bearer ${process.
q := url.Values{}
q.Set("start_time", "2026-04-10T00:00:00Z")
q.Set("end_time", "2026-04-17T00:00:00Z")
import httpx, os
httpx.get(
"https://api-id.avnology.net/v1/audit/events:summary",
params={"start_time": "2026-04-10T00:00:00Z", "end_time": "2026-04-17T00:00:00Z"},
headers={"Authorization"
const res = await fetch(
"https://api-id.avnology.net/v1/audit/events:summary?" +
new URLSearchParams({
start_time: "2026-04-10T00:00:00Z",
end_time: "2026-04-17T00:00:00Z",
}),
{ headers: { Authorization: `Bearer ${process.
q := url.Values{}
q.Set("start_time", "2026-04-10T00:00:00Z")
q.Set("end_time", "2026-04-17T00:00:00Z")
import httpx, os
httpx.get(
"https://api-id.avnology.net/v1/audit/events:summary",
params={"start_time": "2026-04-10T00:00:00Z", "end_time": "2026-04-17T00:00:00Z"},
headers={"Authorization"
const res = await fetch(
"https://api-id.avnology.net/v1/audit/events:summary?" +
new URLSearchParams({
start_time: "2026-04-10T00:00:00Z",
end_time: "2026-04-17T00:00:00Z",
}),
{ headers: { Authorization: `Bearer ${process.
q := url.Values{}
q.Set("start_time", "2026-04-10T00:00:00Z")
q.Set("end_time", "2026-04-17T00:00:00Z")
import httpx, os
httpx.get(
"https://api-id.avnology.net/v1/audit/events:summary",
params={"start_time": "2026-04-10T00:00:00Z", "end_time": "2026-04-17T00:00:00Z"},
headers={"Authorization"
const res = await fetch(
"https://api-id.avnology.net/v1/audit/events:summary?" +
new URLSearchParams({
start_time: "2026-04-10T00:00:00Z",
end_time: "2026-04-17T00:00:00Z",
}),
{ headers: { Authorization: `Bearer ${process.
q := url.Values{}
q.Set("start_time", "2026-04-10T00:00:00Z")
q.Set("end_time", "2026-04-17T00:00:00Z")
import httpx, os
httpx.get(
"https://api-id.avnology.net/v1/audit/events:summary",
params={"start_time": "2026-04-10T00:00:00Z", "end_time": "2026-04-17T00:00:00Z"},
headers={"Authorization"
Response (200 OK)
{
"buckets": [
{ "action": "session.login", "count": 12019, "failure_count": 464 },
{ "action": "user.password.changed", "count": 284, "failure_count": 12 },
{ "action": "oauth.client.created", "count":