Events Operations Get By Id

Events Operations Get By Id
Get detailed context for a single event by UUID and mandatory ingestTime partition pruning parameter

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.

Request
URI
GET
https://{api_host}/api/v1/events/{id}
COPY
Path Parameters
string
id
Required  

Unique event UUID

id example
00000000-0000-4000-8000-000000000061
Query Parameters
string
ingestTime
Required  

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

ingestTime example
2026-01-15T09:12:01Z

Authentication
This operation uses the following authentication methods.
Responses
200

200 OK successful response envelope. The event detail, with the reported rule when one was recorded

Returns EventDetailDto of type(s) application/json
{
    "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"
}
string As uuid As uuid
id
Required  

Unique canonical event identifier (UUID)

string As date-time As date-time
ingestTime
Required  

Timestamp when the appliance ingested the event

string As date-time As date-time
eventTime
Required  

Timestamp reported by the agent when the event occurred

string
agentId
Optional

External string-serialized 64-bit agent identifier

string
hostname
Optional

Hostname of the reporting agent

integer As int64 As int64
securityGroupId
Optional

Assigned security group ID

string
securityGroupName
Optional

Assigned security group name

string
eventClass
Required  

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 code
  • BEHAVIORAL: 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
Enumeration: EXEC, FILE, NET, CONFIG, BEHAVIORAL, TAMPER
string
eventCategory
Optional

Operational subcategory classification of the security event

  • NETWORK: A network connect; stored with event class NET
  • FILE: A file read, write, delete or rename; stored with event class FILE
  • PROCESS_EXECUTION: A process launch; stored with event class EXEC
  • SYSTEM_CALL: An SSH MFA, CLI MFA or send-signal operation; stored with event class BEHAVIORAL
Enumeration: NETWORK, FILE, PROCESS_EXECUTION, SYSTEM_CALL
string
syscallOrAction
Optional

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

string
resolvedPath
Optional

Resolved filesystem path if applicable

string
outcome
Required  

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 proceeded
  • DETECTED_OBSERVE: An Audit rule matched (Agent verdict AUDIT): the operation was logged and allowed to proceed
  • PREVENTED: A Block rule matched (Agent verdict BLOCK) and the operation was blocked
  • TERMINATED: No behaviour is documented for this value. No producing site in the current server code
  • ERROR: No behaviour is documented for this value. No producing site in the current server code
Enumeration: ALLOWED, DETECTED_OBSERVE, PREVENTED, TERMINATED, ERROR
integer As int32 As int32
severity
Optional
Constraints: minimum: 1 maximum: 100

Security severity score (1-100)

string
description
Optional

Human-readable event description

string
enforcementMode
Required  

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 accepted
  • ENFORCE: The Group was in ENFORCE mode when the event was accepted
Enumeration: MONITOR, ENFORCE
integer As int64 As int64
matchedRuleId
Optional

ID of the matched rule if generated by a rule evaluation

string
matchedRuleName
Optional

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

boolean
isAlert
Required  

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

integer As int64 As int64
sequenceNumber
Optional

Monotonically increasing sequence number from the agent

integer As int32 As int32
pid
Optional

Process identifier

integer As int32 As int32
ppid
Optional

Parent process identifier

integer As int32 As int32
uid
Optional

User identifier

integer As int32 As int32
gid
Optional

Group identifier

array of string
argv
Optional

Process argument vector

string
binaryHash
Optional

SHA-256 binary hash in hexadecimal representation

string
processLineage
Optional

Process execution lineage

object
net5Tuple
Optional

Network 5-tuple context

string
configObject
Optional

Target configuration object

string
configAction
Optional

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

string
oldValue
Optional

Previous configuration value

string
newValue
Optional

New configuration value

integer As int64 As int64
policyVersion
Optional

Applied policy version on the agent

integer As int32 As int32
signatureId
Optional

Signature version or rule signature ID

object
reportedRule
Optional

Original Agent-reported rule metadata retained at ingestion; not a verified Console rule or policy link

string
userName
Optional

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

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

Returns ApiErrorResponse of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "path": "string",
    "timestamp": "string",
    "reason": "string"
}
errorCode
Required  

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.

string
message
Required  

Human-readable error description

string
path
Required  

Request URI path that produced the error

string As date-time As date-time
timestamp
Required  

Timestamp when the error occurred as an ISO 8601 date-time with offset

string
reason
Optional

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

401 Unauthorized: UNAUTHENTICATED when the VTP_SESSION cookie is missing, unknown, expired or revoked

Returns Unauthenticated of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "path": "string",
    "timestamp": "string",
    "reason": "string"
}
errorCode
Required  

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.

string
message
Required  

Human-readable error description

string
path
Required  

Request URI path that produced the error

string As date-time As date-time
timestamp
Required  

Timestamp when the error occurred as an ISO 8601 date-time with offset

string
reason
Optional

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

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)

Returns ApiErrorResponse of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "path": "string",
    "timestamp": "string",
    "reason": "string"
}
errorCode
Required  

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.

string
message
Required  

Human-readable error description

string
path
Required  

Request URI path that produced the error

string As date-time As date-time
timestamp
Required  

Timestamp when the error occurred as an ISO 8601 date-time with offset

string
reason
Optional

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

404 Not Found: EVENT_NOT_FOUND when no event has the id at that ingestTime

Returns ApiErrorResponse of type(s) application/json
"ApiErrorResponse Object"
errorCode
Required  

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.

string
message
Required  

Human-readable error description

string
path
Required  

Request URI path that produced the error

string As date-time As date-time
timestamp
Required  

Timestamp when the error occurred as an ISO 8601 date-time with offset

string
reason
Optional

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

500 Internal Server Error: INTERNAL_ERROR when the server fails unexpectedly; the message carries no detail

Returns InternalError of type(s) application/json
{
    "errorCode": "string",
    "message": "string",
    "path": "string",
    "timestamp": "string",
    "reason": "string"
}
errorCode
Required  

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.

string
message
Required  

Human-readable error description

string
path
Required  

Request URI path that produced the error

string As date-time As date-time
timestamp
Required  

Timestamp when the error occurred as an ISO 8601 date-time with offset

string
reason
Optional

A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/api/v1/events/{id}?ingestTime=v