Passer au contenu principal

​
Endpoint

GET /api/v1/billing/subscription

​
Réponse succès 200

{
  "data": {
    "subscription": {
      "plan": {
        "code": "free",
        "limits": {
          "maxInstances": 1
        },
        "features": {
          "campaigns": false
        }
      },
      "scheduledPlan": null,
      "scheduledPlanAt": null,
      "scheduledAction": null
    },
    "usage": {
      "messagesCount": 0,
      "statusesCount": 0,
      "effectiveOutboundUsage": 0,
      "apiRequestsCount": 0,
      "activeInstancesCount": 1,
      "activeApiKeysCount": 1
    },
    "period": {
      "start": "2026-04-01T00:00:00.000Z",
      "end": "2026-04-30T23:59:59.999Z"
    }
  }
}
Le plan Free expose maintenant maxApiKeys: 1 côté subscription.plan.limits.

​
Règles workspace

Cet endpoint reflète le compte personnel du propriétaire de la clé. Il exige une clé API personnelle (msgf_live_…). Une clé d’équipe est rejetée en 403 avec le code TEAM_KEY_NOT_ALLOWED. Pour des données billing d’équipe côté console, utilisez GET /api/billing/subscription avec Authorization: Bearer <jwt> et l’en-tête optionnel X-Team-Id. Voir Team context.