Aller à la documentation
API

Lister les alertes de facturation

Ce que dirait maintenant la bannière de facturation de l’application, le plus urgent d’abord.

GET/billing/alerts

Exécute le véritable appel sur votre espace de travail.

GET /billing/alerts

Ce que dirait maintenant la bannière de facturation de l’application, le plus urgent d’abord.

Exemple

Nécessite billing:read. kind vaut payment_failed, pay_as_you_go_paused, sending_paused, spend_limit_reached, ai_used_up, plan_ending, sends_nearly_used, spend_nearly_reached ou upcoming_charge, et target indique s’il s’agit de l’offre ou de l’utilisation. Une liste vide signifie qu’il n’y a rien à dire.

curl
curl "$OE/billing/alerts" -H "$AUTH"
Réponse
{  "object": "list",  "data": [    {      "object": "billing_alert",      "id": "upcoming_charge:plan:2026-11-01T09:00:00.000Z",      "kind": "upcoming_charge",      "severity": "info",      "target": "billing",      "planName": "Business",      "at": "2026-11-01T09:00:00.000Z",      "cents": 10000,      "currency": "usd",      "used": null,      "limit": null,      "payAsYouGo": false    }  ]}

Une alerte garde son id tant que la même chose reste vraie, donc une alerte que quelqu’un a masquée peut rester masquée.

Seul le propriétaire de l’espace de travail atteint la facturation : une clé d’API, ou un jeton d’accès que le propriétaire a connecté avec toutes les adresses. Le jeton d’un membre donne un 403 owner_only, et une clé ou un jeton limité à certaines adresses ou certains domaines un 422 capability_unsupported.

Référence