# Entitlement.checked

URL: /business/events/Entitlement.checked · Id: `event:Entitlement.checked`

> Emitted each time an Entitlement is checked.

[Entitlement.check](/business/nouns/entitlement/check) emits `Entitlement.checked` when it completes on an [Entitlement](/business/nouns/entitlement).

| Property | Value |
| --- | --- |
| Emitted by | [Entitlement.check](/business/nouns/entitlement/check) |
| Noun | [Entitlement](/business/nouns/entitlement) |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Entitlement.check](/business/nouns/entitlement/check) returns.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Entitlement.checked`. |
| `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.allowed` | `boolean` | Yes | True when an Entitlement grants the call and its Limit has room for `amount`. |
| `data.entitlement` | [Entitlement](/business/nouns/entitlement) | No | The Entitlement that grants the Verb, when one does. |
| `data.entitlement.verb` | [Verb](/business/nouns/verb) | Yes | The Verb it grants. |
| `data.entitlement.limit` | [Limit](/business/nouns/limit) | No | The Limit that bounds it. |
| `data.entitlement.kind` | `string` | No | Computed, never set: `feature`, or `limit` when a Limit bounds it. |
| `data.remaining` | `integer` | No | Units left in the current period; absent for a `feature` Entitlement. |
| `data.resetsAt` | `datetime` | No | When the period resets; absent when the Limit never resets. |
| `data.upgrade` | [Offer](/business/nouns/offer) | No | The Offer that lifts the bound, when its Offer’s `atBound` is `upgrade`. |

### Example
```json
{
  "$id": "https://api.sb/patentpad.com/events/event_1",
  "$type": "Event",
  "name": "Entitlement.checked",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "allowed": true,
    "entitlement": {
      "$id": "https://api.sb/patentpad.com/entitlements/entitlement_1",
      "$type": "Entitlement",
      "verb": "verb_1",
      "limit": "limit_1",
      "kind": "feature"
    },
    "remaining": 1,
    "resetsAt": "2026-10-22T12:00:00Z",
    "upgrade": {
      "$id": "https://api.sb/patentpad.com/offers/offer_1",
      "$type": "Offer",
      "price": {
        "amount": 499,
        "currency": "USD"
      }
    }
  },
  "seq": 1
}
```