Events

Get Event Results

GET
/api/event/{internal_event_id}

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:

RouteUse when
GET /api/event/{internal_event_id}?environment_id=...You have the White Circle ID for one saved result.
GET /api/event?environment_id=...&run_id=...&event_id=...You want the latest result for your own Event IDs.

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

  • Authorizationstringheaderrequired

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

Headers

  • whitecircle-versionstringrequired

    API Version

    Example: "2026-06-01"

Path Parameters

  • internal_event_idstringrequired

    White Circle's ID for one saved result, from a check response or the run graph.

Query Parameters

  • environment_idstringrequired

    Required environment selector.

  • include_shadowboolean | null

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

Response

application/json

Success

  • eventobjectrequired

    Identity and status of the saved Event.

    Show child attributes
    • event.internal_event_idstringrequired

      White Circle's ID for this saved result. Use it with GET /api/event/{internal_event_id}. Each check gets a new value, even when run_id and event_id repeat.

    • event.event_idstringrequired

      Your ID for the Event.

    • event.external_session_idstringrequired

      Session the Event belongs to.

    • event.typestringrequired

      Kind of Event.

    • event.statusstringrequired

      Outcome of the check, such as completed or failed.

    • event.created_atstringrequired

      When White Circle saved the result. ISO 8601 timestamp.

    • event.run_idstring | null

      Run the Event was recorded in.

    • event.updated_atstring | null

      When the result last changed. ISO 8601 timestamp.

  • flaggedbooleanrequired

    true if the Event violated at least one Policy.

  • policiesobjectrequired

    Policy results keyed by Policy ID.

    Show child attributes
    • policies.{key}object

      Show child attributes
      • policies.{key}.flaggedbooleanrequired

        Whether this Event violated the Policy.

      • policies.{key}.namestringrequired

        Human-readable Policy name.

      • policies.{key}.enabled_by_conditionsobject[] | null

        The Conditions that selected this Policy for this Event, which is why it was evaluated at all.

        Show child attributes
        • policies.{key}.enabled_by_conditions.idstringrequired

        • policies.{key}.enabled_by_conditions.namestringrequired

      • policies.{key}.shadowboolean

        Present and true only for shadow policies surfaced via include_shadow. A shadow result never affects the top-level verdict.

  • notestring | null

    Why no verdict was produced: no Condition selected a Policy or Metric, a reference did not resolve, or the Event failed validation or checking.

  • metadataany

    The metadata object sent with the Event.