Retrieve the results of a previously evaluated Event. You can look up an Event by the internal_event_id returned from POST /api/event or by your own run_id and event_id.
Lookup Methods
Use one of these routes:
Pass environment_id on every request to either route. If type is provided and the latest matching result has a different Event type, White Circle returns 404.
Lookup Behavior
internal_event_id identifies a single saved result.
run_id + event_id returns the latest matching result in the selected Environment. This is useful when you use your own Event IDs and only need the newest result.
Metrics run asynchronously and are not returned in the synchronous policies map.
Add include_shadow=true on either lookup route to also return shadow-mode Policies, each marked shadow: true. Shadow results never change the top-level flagged verdict.
Authorizations
Headers
Path Parameters
Query Parameters
Response
Success
eventobjectrequiredIdentity and status of the saved Event.
Show child attributesHide child attributes
event.internal_event_id stringrequiredWhite Circle's ID for this saved result. Use it with
GET /api/event/{internal_event_id}. Each check gets a new value, even whenrun_idandevent_idrepeat.event.event_id stringrequiredYour ID for the Event.
event.external_session_id stringrequiredSession the Event belongs to.
event.type stringrequiredKind of Event.
event.status stringrequiredOutcome of the check, such as
completedorfailed.event.created_at stringrequiredWhen White Circle saved the result. ISO 8601 timestamp.
event.run_id string | nullRun the Event was recorded in.
event.updated_at string | nullWhen the result last changed. ISO 8601 timestamp.
flaggedbooleanrequiredtrueif the Event violated at least one Policy.policiesobjectrequiredPolicy results keyed by Policy ID.
Show child attributesHide child attributes
policies.{key} objectShow child attributesHide child attributes
policies.{key}. flagged booleanrequiredWhether this Event violated the Policy.
policies.{key}. name stringrequiredHuman-readable Policy name.
policies.{key}. enabled_by_conditions object[] | nullThe Conditions that selected this Policy for this Event, which is why it was evaluated at all.
policies.{key}. shadow booleanPresent and
trueonly for shadow policies surfaced viainclude_shadow. A shadow result never affects the top-level verdict.
notestring | nullWhy no verdict was produced: no Condition selected a Policy or Metric, a reference did not resolve, or the Event failed validation or checking.
metadataanyThe
metadataobject sent with the Event.
Bad Request