# events.poll

Lire au plus 100 événements après un checkpoint propre à l'abonnement. Rejouer un checkpoint retourne les mêmes identifiants ; aucun acquittement implicite.

POST `/api/mcp/v1/events.poll` · contrat 1.0.0 · OAuth `mcp:read` · offre payante : true.

Outil MCP : `prescriptio_evenements` ; même handler métier.

## Entrée

```json
{
  "additionalProperties": false,
  "properties": {
    "checkpoint": {
      "maxLength": 512,
      "type": "string"
    },
    "limit": {
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "subscription_id": {
      "type": "string"
    }
  },
  "required": [
    "subscription_id"
  ],
  "type": "object"
}
```

## Exemple synthétique

```json
{
  "subscription_id": "00000000-0000-0000-0000-000000000002"
}
```

## Sortie

```json
{
  "properties": {
    "checkpoint": {
      "type": "string"
    },
    "has_more": {
      "type": "boolean"
    },
    "results": {
      "items": {
        "properties": {
          "ack_token": {
            "type": "string"
          },
          "alerte_id": {
            "type": "string"
          },
          "entity_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "entity_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "string"
          },
          "occurred_at": {
            "format": "date-time",
            "type": "string"
          },
          "recorded_at": {
            "format": "date-time",
            "type": "string"
          },
          "subscription_id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "alerte_id",
          "type",
          "occurred_at",
          "recorded_at",
          "subscription_id",
          "ack_token"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "results",
    "checkpoint",
    "has_more"
  ],
  "type": "object"
}
```

[Authentification, quotas, pagination et erreurs](/docs/reference/concepts.md). Les propriétés additionnelles des résultats historiques restent autorisées ; ce schéma n'invente pas les champs manquants.