usage.threshold_reached

Version de l'API 2026-10-affable-towhee

Lingara → vous usage.threshold_reached

Un compte ou un client facturé à l'usage a consommé une part de sa limite de dépenses mensuelle. Seul le seuil le plus élevé franchi est signalé : une utilisation qui passe de 40 % à 95 % envoie donc un seul événement avec threshold_pct à 90. Une intégration facturée sur un quota ne le reçoit jamais.

Portées events:readusage:read

Modes de transmission Webhook FilGET /v1/events FluxGET /v1/events/stream

Charge utile

idstringobligatoire

typestringobligatoire

created_atstringobligatoire

api_versionstringobligatoire

subjectstringobligatoire

dataUsageThresholdReachedDataobligatoire

scopeThresholdScopeobligatoire

threshold_pctintegerobligatoire

monthstringobligatoire

client_idstring | nullfacultatif

Exemple

{
  "id": "lgr_evt_9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b",
  "type": "usage.threshold_reached",
  "created_at": "2026-10-01T12:00:00Z",
  "api_version": "2026-09-equipped-boxfish",
  "subject": "lgr_sub_8f445eaad6febfab1731b2f8cb17c24e",
  "data": {
    "scope": "client",
    "threshold_pct": 100,
    "month": "2026-10",
    "client_id": "lgr_cid_4hT9kQ2mZx7Lp1Vb8Nc3Rw"
  }
}

En cas de divergence entre une traduction et la référence en anglais, la référence en anglais fait foi.