Skip to main content

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.

​
Get Subscription Detail

Encountering errors? See the API Error Codes Reference for a complete list of error types and troubleshooting steps.
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

Authorization: Bearer <AGIPower_MANAGEMENT_API_KEY>
  • Name: Authorization
  • Format: Bearer &lt;API_KEY&gt;
  • Description: A Management API Key created in the AGIPower Console
This endpoint only accepts Management API Keys. Standard API Keys are not supported.

​
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:
ValueDescription
healthyNormal
monitoredUsage anomaly detected; service remains available
abusiveAbusive usage detected; restrictions applied
suspendedAccount suspended
bannedAccount 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
  • 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.

GET /v1/management/subscription/detail

curl https://api.agipower.ai/v1/management/subscription/detail \
  -H "Authorization: Bearer $AGIPower_MANAGEMENT_API_KEY"

import requests

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

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

API Response

{
  "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
    }
  }
}