Skip to main content
GET
cURL
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.
For exact lookups, prefer internal_event_id. If you submit the same run_id and event_id more than once, lookup by run_id and event_id returns the latest matching result.

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.
If no matching Event is found, or the Event belongs to another workspace or Environment, White Circle returns 404.

Authorizations

Authorization
string
header
required

API Key required. Format: Bearer wc-your-api-key

Headers

whitecircle-version
string
required

API Version

Path Parameters

internal_event_id
string
required

Query Parameters

environment_id
string
required

Required environment selector.

include_shadow
boolean | null

Also return shadow-policy results (each marked shadow: true). Shadow results never affect the top-level flagged/violation verdict.

Response

Success

event
object
required
flagged
boolean
required
policies
object
required
note
string | null
metadata
any