Skip to main content

​
Endpoint

GET /api/v1/billing/usage

​
Success response 200

{
  "data": {
    "plan": {
      "code": "pro",
      "name": "Pro"
    },
    "limits": {
      "maxInstances": 5,
      "maxApiKeys": 10,
      "maxWebhookEndpoints": 10,
      "monthlyOutboundQuota": 5000,
      "monthlyApiRequestQuota": 50000
    },
    "features": {
      "campaigns": true,
      "statuses": true,
      "voiceNotes": true,
      "webhooks": true
    },
    "usage": {
      "messagesCount": 1240,
      "statusesCount": 85,
      "effectiveOutboundUsage": 1325,
      "apiRequestsCount": 4500,
      "activeInstancesCount": 3,
      "activeApiKeysCount": 2
    },
    "period": {
      "start": "2026-04-01T00:00:00.000Z",
      "end": "2026-04-30T23:59:59.999Z"
    }
  }
}

​
Workspace rules

This endpoint reflects the personal account of the key owner. It requires a personal API key (msgf_live_…). A team API key is rejected with 403 and code TEAM_KEY_NOT_ALLOWED. See Team context.