growpanel 0.1.5

Python SDK for the GrowPanel subscription analytics REST API

growpanel (Python)

Official Python SDK for the GrowPanel subscription analytics REST API.

pip install growpanel

from growpanel import GrowPanel

gp = GrowPanel(api_key="gp_...")

summary = gp.reports.get_summary()
print(summary.summary.mrr_current)

mrr = gp.reports.get_mrr(date="20260101-20260531", interval="month")
for period in mrr.result:
    print(period.date, period.total_mrr)

Auth

Issue a key in app.growpanel.io → Account → API keys. Pass it as api_key= when constructing the client; it's sent as Authorization: Bearer <key> on every request.

Surfaces

The SDK groups operations by API area, mirroring the interactive docs:

• gp.reports.* — MRR, leads, cohorts, cashflow, retention, churn
• gp.customers.* — list + detail (analytics view)
• gp.plans.* — list plans
• gp.plan_groups.*, gp.segments.*, gp.data_sources.*, gp.data_customers.*, gp.data_invoices.*, gp.data_plans.* — data management with full CRUD
• gp.profile.*, gp.notifications.*, gp.webhooks.* — account & integrations

For anything not exposed as a named method, gp.raw is the generated module tree — every endpoint in the OpenAPI spec is reachable from there.

Generating from the live spec

pip install -e ".[dev]"
openapi-python-client generate \
    --url https://api-dev.growpanel.io/openapi.json \
    --config openapi-python-client.config.yaml \
    --overwrite

Output lands in src/growpanel/_generated/. In CI, this runs automatically on every API change.

Errors

from growpanel import GrowPanel, GrowPanelError

gp = GrowPanel(api_key="...")
try:
    gp.customers.detail(id="cus_doesnotexist")
except GrowPanelError as err:
    if err.status == 404:
        ...  # handle not-found
    raise

Interactive docs

The full reference (with try-it-out) lives at api.growpanel.io/docs.