> ## Documentation Index
> Fetch the complete documentation index at: https://docs.msgflash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET Extended billing usage

> Return plan, limits, features, usage, and current period.

## Endpoint

```txt theme={null}
GET /api/v1/billing/usage
```

## Success response `200`

```json theme={null}
{
  "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`](/resources/error-codes#teams-workspaces). See [Team context](/api-reference/teams/team-context).