Events Operations Get By Id
Returns the full detail of one event, with the reported rule when one was recorded. ingestTime is required, because the server uses it to prune the daily partitions, so send the ingestTime of the event as listed. A missing ingestTime or an id that is not a UUID answers 400, and 404 EVENT_NOT_FOUND when no event matches the id and ingestTime. Requires the ADMIN, SECURITY_OPERATOR or AUDITOR role.
Unique event UUID
00000000-0000-4000-8000-000000000061
Mandatory ingestion timestamp, ISO 8601 date-time with an offset (for example 2026-01-15T09:30:00Z; any offset is accepted), to prune daily partitions; the lookup accepts any value within 1 second either side of the stored ingestTime
2026-01-15T09:12:01Z
200 OK successful response envelope. The event detail, with the reported rule when one was recorded
{
"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,
"sequenceNumber": 1042,
"pid": 4121,
"ppid": 4090,
"uid": 0,
"gid": 0,
"argv": [
"curl",
"https://203.0.113.50/"
],
"binaryHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"processLineage": null,
"net5Tuple": {
"srcIp": "192.0.2.12",
"srcPort": 49152,
"dstIp": "203.0.113.50",
"dstPort": 443,
"protocol": "TCP"
},
"configObject": null,
"configAction": null,
"oldValue": null,
"newValue": null,
"policyVersion": 3,
"signatureId": null,
"reportedRule": {
"id": "0",
"guid": null,
"version": 0,
"rank": null
},
"userName": "alice"
}
Unique canonical event identifier (UUID)
Timestamp when the appliance ingested the event
Timestamp reported by the agent when the event occurred
External string-serialized 64-bit agent identifier
Hostname of the reporting agent
Assigned security group ID
Assigned security group name
High-level architectural class of the security event
EXEC: A rule matched a process launch (stored with category PROCESS_EXECUTION)FILE: A rule matched a file read, write, delete or rename (stored with category FILE)NET: A rule matched a network connect (stored with category NETWORK)CONFIG: No behaviour is documented for this value. No producing site in the current server codeBEHAVIORAL: A rule matched an SSH MFA, CLI MFA or send-signal operation (stored with category SYSTEM_CALL)TAMPER: Tamper attempts. The current Agent event ingestion does not assign this class to any event
Operational subcategory classification of the security event
NETWORK: A network connect; stored with event class NETFILE: A file read, write, delete or rename; stored with event class FILEPROCESS_EXECUTION: A process launch; stored with event class EXECSYSTEM_CALL: An SSH MFA, CLI MFA or send-signal operation; stored with event class BEHAVIORAL
Operation name recorded for the event; events stored by the rule-match ingestion carry RuleMatch, Connect, or one of RULE_OP_FILE_READ, RULE_OP_FILE_WRITE, RULE_OP_FILE_DELETE, RULE_OP_FILE_RENAME, RULE_OP_SSH_MFA, RULE_OP_CLI_MFA, RULE_OP_SEND_SIGNAL; other sources may store other text; null when none was stored
Resolved filesystem path if applicable
Final disposition or verdict outcome of the event. The server also stores, returns and accepts as a filter CHALLENGED (the matched rule requires an MFA challenge), which this list omits; the filter also accepts CHALLENGE_FAILED, which no current server code produces
ALLOWED: An Allow rule matched (Agent verdict ALLOW) and the operation proceededDETECTED_OBSERVE: An Audit rule matched (Agent verdict AUDIT): the operation was logged and allowed to proceedPREVENTED: A Block rule matched (Agent verdict BLOCK) and the operation was blockedTERMINATED: No behaviour is documented for this value. No producing site in the current server codeERROR: No behaviour is documented for this value. No producing site in the current server code
Security severity score (1-100)
Human-readable event description
The enforcement mode of the agent's Security Group when the console received the event, a snapshot like securityGroupId (UI label: Group mode when received). The Agent event has no mode field, so it can differ from the mode in force at login around a mode change. It is the Group's mode, not derived from the verdict: a Block verdict in a MONITOR Group is stored with MONITOR
MONITOR: The Group was in MONITOR mode when the event was acceptedENFORCE: The Group was in ENFORCE mode when the event was accepted
ID of the matched rule if generated by a rule evaluation
Name of the matched Rule. The Rule's current name while the Rule exists; after it is deleted, the name recorded when the event was ingested. Null when the event has no matched Rule or no name was recorded
Reserved and always false, because the Console does not mark the events behind an alert; use the Alerts page to see them. The Events page neither shows nor filters on it
Monotonically increasing sequence number from the agent
Process identifier
Parent process identifier
User identifier
Group identifier
Process argument vector
SHA-256 binary hash in hexadecimal representation
Process execution lineage
Network 5-tuple context
Target configuration object
Configuration action of a CONFIG-class event, as free text; no current event writer fills it, so it is null for events stored by the ingestion service
Previous configuration value
New configuration value
Applied policy version on the agent
Signature version or rule signature ID
Original Agent-reported rule metadata retained at ingestion; not a verified Console rule or policy link
Canonical user the event concerns, as reported by the Agent (RuleMatchEvent.UserName, at most 256 characters); null when the Agent did not report one or the event predates the field
400 Bad Request: INVALID_ARGUMENT when the id is empty or is not a UUID, or ingestTime is not an ISO-8601 date-time; MISSING_PARAMETER when ingestTime is missing
{
"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.
404 Not Found: EVENT_NOT_FOUND when no event has the id at that ingestTime
"ApiErrorResponse Object"
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/{id}?ingestTime=v