GET/v1/billing/usage

Usage facturable

Renvoie l'usage facturable de la période.

Réponse exemple

{
  "data": [
    {
      "id": "usage_123",
      "period_end": "2026-02-01T00:00:00Z",
      "period_start": "2026-01-01T00:00:00Z",
      "storage_gb_used": 10.5,
      "bandwidth_gb_used": 25.3,
      "storage_overage_gb": 0,
      "bandwidth_overage_gb": 0
    }
  ],
  "object": "list",
  "current_period": {
    "id": "usage_456",
    "period_end": "2026-03-01T00:00:00Z",
    "period_start": "2026-02-01T00:00:00Z",
    "storage_gb_used": 8.2,
    "bandwidth_gb_used": 15.7
  }
}

Renvoie l'usage facturable (stockage, bande passante) des périodes courante et précédentes.

Authentification

Requiert une clé API avec le scope billing:read.

Paramètres de requête

Paramètre	Type	Requis	Description
limit	number	Non	Nombre de périodes (défaut 12, max 60).

Codes de statut

200 Usage renvoyé.
403 Scope insuffisant.