Account Billing


Retrieve billing and subscription information for the authenticated account.


GET /account/billing

Returns the current plan, billing status, and usage information.

Authentication

Requires an API key with Admin access level.

curl https://api.growpanel.io/v1/account/billing \
-H "Authorization: Bearer YOUR_API_KEY"

Response

Status: 200 OK

{
"plan": "growth",
"status": "active",
"billing_cycle": "monthly",
"current_period_start": "2025-01-01T00:00:00Z",
"current_period_end": "2025-02-01T00:00:00Z",
"mrr_limit": 500000,
"current_mrr": 125000,
"customer_limit": 1000,
"current_customers": 250
}

Response fields

FieldTypeDescription
planstringCurrent subscription plan (free, starter, growth, scale)
statusstringBilling status (active, past_due, cancelled)
billing_cyclestringBilling frequency (monthly, yearly)
current_period_startstringStart of current billing period
current_period_endstringEnd of current billing period
mrr_limitintegerMaximum MRR allowed on current plan
current_mrrintegerCurrent total MRR across all data sources
customer_limitintegerMaximum customers allowed on current plan
current_customersintegerCurrent total customer count