usage.threshold_reached

API version 2026-10-affable-towhee

Lingara → you usage.threshold_reached

A metered account or client has used a share of its monthly spend cap. Only the highest threshold crossed is reported, so usage that jumps from 40% to 95% sends one event with threshold_pct 90. An integration billed from an allowance never receives it.

Scopes events:readusage:read

Transports Webhook FeedGET /v1/events StreamGET /v1/events/stream

Payload

idstringrequired

typestringrequired

created_atstringrequired

api_versionstringrequired

subjectstringrequired

dataUsageThresholdReachedDatarequired

scopeThresholdScoperequired

threshold_pctintegerrequired

monthstringrequired

client_idstring | nulloptional

Example

{
  "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"
  }
}