# Get Event Results

`GET /api/event/{internal_event_id}`

Base URLs: `https://eu.whitecircle.com`, `https://us.whitecircle.com`

OpenAPI: [latest/openapi.json](https://whitecircle.com/docs/latest/openapi.json)

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:

| Route | Use 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`.

> [!TIP]
> 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](https://whitecircle.com/docs/latest/first-steps/policies.md), each marked `shadow: true`. Shadow results never change the top-level `flagged` verdict.

> [!NOTE]
> 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. Example: `"2026-06-01"`.

## Path Parameters

- `internal_event_id` (`string`, required): White Circle's ID for one saved result, from a check response or the run graph.

## Query Parameters

- `environment_id` (`string`, required): Required environment selector.
- `include_shadow` (`boolean | null`, optional): Also return shadow-policy results (each marked `shadow: true`). Shadow results never affect the top-level `flagged`/`violation` verdict.

## Request example

```bash
curl --request GET \
  --url 'https://eu.whitecircle.com/api/event/<internal_event_id>?environment_id=<environment_id>' \
  --header "Authorization: Bearer $WHITECIRCLE_API_KEY" \
  --header 'whitecircle-version: 2026-06-01'
```

## Response

### 200

Success

`application/json`

- `event` (`object`, required): Identity and status of the saved Event.
- `event.internal_event_id` (`string`, required): 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_id` (`string`, required): Your ID for the Event.
- `event.external_session_id` (`string`, required): Session the Event belongs to.
- `event.type` (`string`, required): Kind of Event.
- `event.status` (`string`, required): Outcome of the check, such as `completed` or `failed`.
- `event.created_at` (`string`, required): When White Circle saved the result. ISO 8601 timestamp.
- `event.run_id` (`string | null`, optional): Run the Event was recorded in.
- `event.updated_at` (`string | null`, optional): When the result last changed. ISO 8601 timestamp.
- `flagged` (`boolean`, required): `true` if the Event violated at least one Policy.
- `policies` (`object`, required): Policy results keyed by Policy ID.
- `policies.{key}` (`object`, optional)
- `policies.{key}.flagged` (`boolean`, required): Whether this Event violated the Policy.
- `policies.{key}.name` (`string`, required): Human-readable Policy name.
- `policies.{key}.enabled_by_conditions` (`object[] | null`, optional): The Conditions that selected this Policy for this Event, which is why it was evaluated at all.
- `policies.{key}.enabled_by_conditions.id` (`string`, required)
- `policies.{key}.enabled_by_conditions.name` (`string`, required)
- `policies.{key}.shadow` (`boolean`, optional): Present and `true` only for shadow policies surfaced via `include_shadow`. A shadow result never affects the top-level verdict.
- `note` (`string | null`, optional): Why no verdict was produced: no Condition selected a Policy or Metric, a reference did not resolve, or the Event failed validation or checking.
- `metadata` (`any`, optional): The `metadata` object sent with the Event.

**Example**

```json
{
  "flagged": true,
  "policies": {
    "70289e06-9111-463e-b121-7247c2b7bfbd": {
      "flagged": true,
      "name": "No PII Sharing",
      "enabled_by_conditions": [
        {
          "id": "019f0000-0000-7000-8000-000000000001",
          "name": "EU users"
        }
      ]
    }
  },
  "event": {
    "type": "message",
    "status": "completed",
    "updated_at": null,
    "created_at": "2026-06-01T12:00:00Z",
    "event_id": "evt_user_001",
    "external_session_id": "conversation_456",
    "internal_event_id": "a1b2c3d4-e5f6-4890-abcd-ef1234567890",
    "run_id": "run_refund_123"
  },
  "metadata": {
    "user": {
      "region": "eu"
    }
  }
}
```

### 400

Bad Request
