Events Operations List
Searches security events by ingest time. With neither from nor to the window is the last 24 hours, with only one of them it is 24 hours on the other side of it. from must not be after to and the window must not exceed 30 days (400 INVALID_TIME_RANGE). page defaults to 0 and pageSize to 20 (1 to 100), a page that begins at row 50000 or later is refused (400 INVALID_PAGINATION), and the default sort is ingestTime DESC. severity filters one value, while severityMin and severityMax filter a range (severity supplies whichever bound is not given). agentId is the external agent identifier and agentPk the internal agent primary key, and when both are given both must match. An unknown eventClass, eventCategory, outcome, operation, sortBy or sortOrder, or a q shorter than 3 or longer than 100 characters after trimming, answers 400 INVALID_ARGUMENT. Requires the ADMIN, SECURITY_OPERATOR or AUDITOR role.
Zero-based page index (default 0). A negative page, or a page that begins at row 50000 or later (page times pageSize), answers 400 INVALID_PAGINATION; it is not clamped.
Number of items per page (default 20, 1 to 100). A value outside 1 to 100 answers 400 INVALID_PAGINATION; it is not clamped. Only the first 50000 rows of the result can be paged.
20
Start timestamp, ISO 8601 date-time with an offset (for example 2026-01-15T09:30:00Z); any offset is accepted. Defaults to 24 hours prior if omitted.
2026-01-15T09:30:00Z
End timestamp, ISO 8601 date-time with an offset (for example 2026-01-15T09:30:00Z); any offset is accepted. Defaults to current timestamp if omitted.
2026-01-16T09:30:00Z
Filter by external agent identifier (string-serialized 64-bit integer)
2
Filter by internal agent primary key (the agentPk carried by alerts); additive to agentId, a positive int64. When both are supplied both must match.
2
Filter by security group ID
1
Filter by operational subcategory
NETWORK
Filter by minimum severity (1-100)
50
Filter by maximum severity (1-100)
100
Filter by matched rule ID
7
Reserved, because events are never marked as alert events, so true returns nothing and false returns every event. The Events page does not use it
true
Filter by the Agent operation stored in syscallOrAction, for example RULE_OP_SSH_MFA to isolate SSH MFA events. An unknown value answers 400 INVALID_ARGUMENT.
RULE_OP_SSH_MFA
Free-text search, a case-insensitive substring over description, resolvedPath, syscallOrAction, argv, the matched rule name, the rule GUID, the Hypervisor hostname and the Group name, ANDed with every other filter and the time window. 3 to 100 characters after trimming, otherwise 400 INVALID_ARGUMENT. The characters % _ and backslash are literal.
invalid totp
Sort field (default ingestTime): ingestTime, eventTime, severity, eventClass or outcome. Any other value answers 400 INVALID_ARGUMENT.
ingestTime
Sort direction, ASC or DESC (default DESC). Any other value answers 400 INVALID_ARGUMENT.
ASC
200 OK successful response envelope. A page of event summaries inside the ingest-time window
{
"items": [
{
"id": "00000000-0000-4000-8000-000000000062",
"ingestTime": "2026-01-15T09:20:01Z",
"eventTime": "2026-01-15T09:20:00Z",
"agentId": "2",
"hostname": "esx02.example.com",
"securityGroupId": 1,
"securityGroupName": "Production Servers",
"eventClass": "EXEC",
"eventCategory": "PROCESS_EXECUTION",
"syscallOrAction": "execve",
"resolvedPath": "/opt/backup/backup-agent.sh",
"outcome": "PREVENTED",
"severity": 80,
"description": "Execution of /opt/backup/backup-agent.sh blocked",
"enforcementMode": "ENFORCE",
"matchedRuleId": 12,
"matchedRuleName": "Block Unapproved Scripts",
"isAlert": true,
"binaryHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"policyVersion": 3
},
{
"id": "00000000-0000-4000-8000-000000000061",
"ingestTime": "2026-01-15T09:12:01Z",
"eventTime": "2026-01-15T09:12:00Z",
"agentId": "2",
"hostname": "esx02.example.com",
"securityGroupId": 1,
"securityGroupName": "Production Servers",
"eventClass": "NET",
"eventCategory": "NETWORK",
"syscallOrAction": "Connect",
"resolvedPath": null,
"outcome": "PREVENTED",
"severity": 70,
"description": "Outbound connection to 203.0.113.50:443 blocked",
"enforcementMode": "ENFORCE",
"matchedRuleId": null,
"matchedRuleName": null,
"isAlert": false,
"binaryHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"policyVersion": 3
}
],
"page": 0,
"pageSize": 20,
"totalItems": 2,
"totalPages": 1,
"totalCapped": false
}
Array of items for the current page
Zero-based current page number
Number of items requested per page
Total number of items matching filter criteria (bounded to 50000; see totalCapped)
Total number of available pages
True when more matches exist than the 50000-row count cap, so totalItems is a lower bound
400 Bad Request: INVALID_TIME_RANGE when from is after to or the window is longer than 30 days; INVALID_PAGINATION when page is negative or pageSize is out of range; INVALID_ARGUMENT when a filter or sort value is unknown or out of range, an id filter is not a positive number, or a parameter has the wrong type
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
401 Unauthorized: UNAUTHENTICATED when the VTP_SESSION cookie is missing, unknown, expired or revoked
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
403 Forbidden: PASSWORD_CHANGE_REQUIRED when the account must change its password first (only GET /api/v1/auth/session, POST /api/v1/auth/logout and POST /api/v1/auth/change-password are exempt); LICENSE_REQUIRED or LICENSE_EXPIRED while the license pool is restricted (no license, or expired past grace) (exempt: every route under /api/v1/auth, GET /api/v1/user/preferences, GET /api/v1/licensing/summary and POST /api/v1/licensing/licenses)
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
500 Internal Server Error: INTERNAL_ERROR when the server fails unexpectedly; the message carries no detail
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
curl -H 'Authorization: <value>' https://{api_host}/api/v1/events