[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Lire les événements

L'opération REST events.poll de Prescriptio sert à lire au plus 100 événements après le point de reprise propre à l'abonnement.

### Exemple d'appel, synthétique

**curl**

```bash
curl -sS https://prescriptio.fr/api/mcp/v1/events.poll \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"subscription_id":"00000000-0000-0000-0000-000000000002"}'
```

**Corps JSON**

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

### Forme de la réponse, générée depuis le schéma

```json
{
  "checkpoint": "<texte>",
  "has_more": false,
  "results": [
    {
      "ack_token": "<texte>",
      "alerte_id": "<texte>",
      "entity_id": "<texte>",
      "entity_type": "<texte>",
      "id": "<texte>",
      "occurred_at": "<texte>",
      "recorded_at": "<texte>",
      "subscription_id": "<texte>",
      "type": "<texte>"
    }
  ]
}
```

## Paramètres du corps

| Nom | Type | Requis | Description |
|---|---|---|---|
| `checkpoint` | texte | — | (max. 512 caractères) |
| `limit` | entier | — | (min 1, max 100, défaut `100`) |
| `subscription_id` | texte | oui | — |

## Quand l'utiliser

Rejouer un point de reprise retourne les mêmes identifiants ; aucun acquittement implicite.

## En bref

| | |
|---|---|
| Adresse | `POST /api/mcp/v1/events.poll` |
| Contrat | 3.0.0 |
| Portée OAuth | `mcp:read` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Outil MCP | [`evenements_lire`](https://prescriptio.fr/docs/api/evenements_lire) : même traitement |

## Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée.

Les codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `events.poll`.

- [Alertes](https://prescriptio.fr/docs/alertes) : Documentation, Les modules
- [Événements et relève](https://prescriptio.fr/docs/integrations/evenements) : IA, Intégrations
- [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations
- [Événements d'alerte](https://prescriptio.fr/docs/reference/evenements) : Référence, Pour commencer

## Voir aussi

- [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse
- [evenements_lire](https://prescriptio.fr/docs/api/evenements_lire) : La même action par le connecteur MCP
- [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations