API ReferenceRisk
Get Risk Summary
Aggregated risk counts per level over a time range.
Endpoint
GET /v1/risk:summaryBase URL: https://<Domain id="api"/>
Authentication: Bearer token with risk:read.
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/risk: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/risk: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/risk: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/risk: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/risk: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/risk: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/risk: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/risk:summary",
params={"start_time": "2026-04-10T00:00:00Z", "end_time": "2026-04-17T00:00:00Z"},
headers={"Authorization"
Response (200 OK)
{
"by_level": {
"NONE": 12301,
"LOW": 894,
"MEDIUM": 187,
"HIGH": 42,
"CRITICAL": 4
},
"total": 13428
}