# Flag.evaluated

URL: /business/events/Flag.evaluated · Id: `event:Flag.evaluated`

> Emitted each time a Flag is evaluated.

[Flag.evaluate](/business/nouns/flag/evaluate) emits `Flag.evaluated` when it completes on a [Flag](/business/nouns/flag).

| Property | Value |
| --- | --- |
| Emitted by | [Flag.evaluate](/business/nouns/flag/evaluate) |
| Noun | [Flag](/business/nouns/flag) |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Flag.evaluate](/business/nouns/flag/evaluate) returns.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Flag.evaluated`. |
| `at` | `datetime` | Yes | When it happened. |
| `seq` | `integer` | No | Its position in the namespace, one more than the Event before; any seq is a cursor into the history. |
| `data` | `json` | Yes | The Thing as the Action left it. |
| `data.variant` | [Variant](/business/nouns/variant) | Yes | The Variant assigned to the unit. |
| `data.exposure` | [Exposure](/business/nouns/exposure) | No | The Exposure recorded; none in Mode try. |

### Example
```json
{
  "$id": "https://api.sb/quietcopy.com/events/event_1",
  "$type": "Event",
  "name": "Flag.evaluated",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "variant": {
      "$id": "https://api.sb/quietcopy.com/variants/variant_1",
      "$type": "Variant",
      "key": "Example key",
      "value": {}
    },
    "exposure": {
      "$id": "https://api.sb/quietcopy.com/exposures/exposure_1",
      "$type": "Exposure",
      "unit": "Example unit",
      "options": {},
      "propensity": 1,
      "at": "2026-10-22T12:00:00Z"
    }
  },
  "seq": 1
}
```