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

# Current Plan

> Get the current billing plan for the authenticated user

Returns the authenticated user's current billing plan. Useful for checking plan-level feature availability, deployment limits, and tier access before making other API calls.

## Headers

**Authorization** `string` *required*

Bearer token. `Authorization: Bearer runtm_xxx`

## Response

**plan\_name** `string`

Name of the current plan (e.g. `free`, `pro`, `team`, `enterprise`)

**status** `string`

Plan status (e.g. `active`, `trialing`, `past_due`)

**features** `object`

Plan feature flags and limits

```bash cURL theme={null}
curl "https://app.runtm.com/api/cloud/user/current-plan" \
  -H "Authorization: Bearer runtm_xxx"
```

```python Python theme={null}
import requests

response = requests.get(
    "https://app.runtm.com/api/cloud/user/current-plan",
    headers={"Authorization": "Bearer runtm_xxx"},
)

data = response.json()
print(f"Plan: {data['plan_name']}")
```

```javascript JavaScript theme={null}
const response = await fetch(
  "https://app.runtm.com/api/cloud/user/current-plan",
  {
    headers: {
      "Authorization": "Bearer runtm_xxx",
    },
  }
);

const data = await response.json();
console.log(`Plan: ${data.plan_name}`);
```

```json 200 theme={null}
{
  "plan_name": "pro",
  "status": "active",
  "features": {
    "max_apps": 10,
    "max_sessions": 20,
    "allowed_tiers": ["starter", "standard", "performance"],
    "collaboration": true,
    "custom_domains": true
  }
}
```

```json 200 theme={null}
{
  "plan_name": "free",
  "status": "active",
  "features": {
    "max_apps": 2,
    "max_sessions": 5,
    "allowed_tiers": ["starter"],
    "collaboration": false,
    "custom_domains": false
  }
}
```

## Scopes

| Method | Required scope |
| - | - |
| GET | `activity:read` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.