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

# Interface

# Get Subscription Detail

<Tip title="💡 Troubleshooting">
  Encountering errors? See the [API Error Codes Reference](/en/guide/advanced/error-codes) for a complete list of error types and troubleshooting steps.
</Tip>

```
GET https://api.agipower.ai/v1/management/subscription/detail
```

Returns the current account's subscription details, including plan information, Flow rates, account status, and quota usage across all time windows.

## Authentication

### Authorization Header **Required**

```http theme={null}
Authorization: Bearer <AGIPower_MANAGEMENT_API_KEY>
```

* **Name**: `Authorization`
* **Format**: `Bearer &lt;API_KEY&gt;`
* **Description**: A Management API Key created in the [AGIPower Console](https://agipower.ai/platform/management)

<Warning title="⚠️ Management API Key required">
  This endpoint only accepts Management API Keys. Standard API Keys are not supported.
</Warning>

## Rate Limiting

Each endpoint has its own independent rate limit counter. The maximum number of requests per minute is configured at the platform level. Exceeding the limit returns a `422` error.

## Returns

### data.plan `object`

Current subscription plan details:

* `tier` `string` — Plan tier: `"free"` / `"pro"` / `"max"` / `"ultra"`
* `amount_usd` `number` — Monthly plan price (USD)
* `interval` `string` — Billing cycle, always `"month"`
* `expires_at` `string` — Current subscription period expiry time (ISO 8601)

### data.currency `string`

Currency unit. Always `"usd"`.

### data.base\_usd\_per\_flow `number`

The platform base rate for the current plan (USD per Flow).

### data.effective\_usd\_per\_flow `number`

The account's actual effective rate (USD per Flow). Normally equals the base rate; may be higher when usage anomalies are detected.

### data.account\_status `string`

The account's current status:

| Value       | Description                                       |
| ----------- | ------------------------------------------------- |
| `healthy`   | Normal                                            |
| `monitored` | Usage anomaly detected; service remains available |
| `abusive`   | Abusive usage detected; restrictions applied      |
| `suspended` | Account suspended                                 |
| `banned`    | Account banned                                    |

### data.quota\_5\_hour `object`

5-hour rolling window quota (high-frequency protection):

* `usage_percentage` `number` — Fraction of the window consumed (0–1), to 4 decimal places
* `resets_at` `string | null` — Window reset time (ISO 8601); `null` if the window has not yet started
* `max_flows` `number` — Maximum Flows available in this window
* `used_flows` `number` — Flows consumed so far
* `remaining_flows` `number` — Flows remaining
* `used_value_usd` `number` — USD value of consumed Flows
* `max_value_usd` `number` — USD value of the total window quota

### data.quota\_7\_day `object`

7-day rolling window quota. Same field structure as `quota_5_hour`.

### data.quota\_monthly `object`

Monthly subscription cycle quota (upper limits only; no real-time usage data):

* `max_flows` `number` — Maximum Flows available in the current billing cycle
* `max_value_usd` `number` — USD value of the total monthly quota

<Info title="💡 Quota behavior">
  - `quota_5_hour` and `quota_7_day` are **rolling windows** that update in real time after each request.
  - `quota_monthly` is a fixed cap for the current billing cycle and does not include real-time usage.
  - All three windows are enforced simultaneously — hitting any one of them will rate-limit further requests.
</Info>

<Card title="GET /v1/management/subscription/detail">
  ```cURL theme={null}
  curl https://api.agipower.ai/v1/management/subscription/detail \
    -H "Authorization: Bearer $AGIPower_MANAGEMENT_API_KEY"
  ```

  ```python theme={null}
  import requests

  response = requests.get(
      "https://api.agipower.ai/v1/management/subscription/detail",
      headers={"Authorization": f"Bearer {AGIPower_MANAGEMENT_API_KEY}"}
  )
  print(response.json())
  ```

  ```javascript theme={null}
  const response = await fetch("https://api.agipower.ai/v1/management/subscription/detail", {
    headers: { Authorization: `Bearer ${AGIPower_MANAGEMENT_API_KEY}` },
  });
  const data = await response.json();
  ```
</Card>

<Card title="API Response">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "plan": {
        "tier": "ultra",
        "amount_usd": 200,
        "interval": "month",
        "expires_at": "2026-04-12T08:26:56.000Z"
      },
      "currency": "usd",
      "base_usd_per_flow": 0.03283,
      "effective_usd_per_flow": 0.03283,
      "account_status": "healthy",
      "quota_5_hour": {
        "usage_percentage": 0.0715,
        "resets_at": "2026-03-24T08:35:09.000Z",
        "max_flows": 800,
        "used_flows": 57.2,
        "remaining_flows": 742.8,
        "used_value_usd": 1.88,
        "max_value_usd": 26.27
      },
      "quota_7_day": {
        "usage_percentage": 0.0673,
        "resets_at": "2026-03-26T02:15:05.000Z",
        "max_flows": 6182,
        "used_flows": 416.11,
        "remaining_flows": 5765.89,
        "used_value_usd": 13.66,
        "max_value_usd": 202.99
      },
      "quota_monthly": {
        "max_flows": 34560,
        "max_value_usd": 1134.33
      }
    }
  }
  ```
</Card>