API ReferenceRisk
List Risk Events
Raw risk-signal events -- impossible travel, suspicious IP, new device.
Endpoint
GET /v1/risk/eventsBase URL: https://<Domain id="api"/>
Authentication: Bearer token with risk:read.
Unlike assessments (which are scored snapshots), risk events are the raw signals feeding the model. Fetch them when you want to reconstruct the reasoning behind a score.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
page_size | int32 | Default 50 |
page_token | string | Cursor |
filter | string | e.g. type = "impossible_travel" |
Example
const res = await fetch(
"https://api-id.avnology.net/v1/risk/events?" +
new URLSearchParams({ filter: 'type = "impossible_travel"' }),
{ headers: { Authorization: `Bearer ${process.env.AVNOLOGY_API_KEY}` } }
);q := url.Values{}
q.Set("filter", `type = "impossible_travel"`)
req, _ := http.NewRequest("GET",
import httpx, os
httpx.get(
"https://api-id.avnology.net/v1/risk/events",
params={"filter": 'type = "impossible_travel"'},
headers={"Authorization": f"Bearer {
const res = await fetch(
"https://api-id.avnology.net/v1/risk/events?" +
new URLSearchParams({ filter: 'type = "impossible_travel"' }),
{ headers: { Authorization: `Bearer ${process.env.AVNOLOGY_API_KEY}` } }
);q := url.Values{}
q.Set("filter", `type = "impossible_travel"`)
req, _ := http.NewRequest("GET",
import httpx, os
httpx.get(
"https://api-id.avnology.net/v1/risk/events",
params={"filter": 'type = "impossible_travel"'},
headers={"Authorization": f"Bearer {
const res = await fetch(
"https://api-id.avnology.net/v1/risk/events?" +
new URLSearchParams({ filter: 'type = "impossible_travel"' }),
{ headers: { Authorization: `Bearer ${process.env.AVNOLOGY_API_KEY}` } }
);q := url.Values{}
q.Set("filter", `type = "impossible_travel"`)
req, _ := http.NewRequest("GET",
import httpx, os
httpx.get(
"https://api-id.avnology.net/v1/risk/events",
params={"filter": 'type = "impossible_travel"'},
headers={"Authorization": f"Bearer {
const res = await fetch(
"https://api-id.avnology.net/v1/risk/events?" +
new URLSearchParams({ filter: 'type = "impossible_travel"' }),
{ headers: { Authorization: `Bearer ${process.env.AVNOLOGY_API_KEY}` } }
);q := url.Values{}
q.Set("filter", `type = "impossible_travel"`)
req, _ := http.NewRequest("GET",
import httpx, os
httpx.get(
"https://api-id.avnology.net/v1/risk/events",
params={"filter": 'type = "impossible_travel"'},
headers={"Authorization": f"Bearer {