📊 Subscription Management

Manage your organization's subscription, billing, and feature access.

Overview

The Subscription Management dashboard provides:

👤 Admin Access Required

Only Organization Owners can manage subscriptions and billing.

Subscription Information

Current Plan Details

View your subscription status:

Feature Flags

See which features are enabled for your plan:

Usage & Quotas

Query Usage

Current Period: Dec 1 - Dec 31, 2024 ───────────────────────────────────── Queries Used: 7,450 / 10,000 Percentage: 74.5% Remaining: 2,550 Days Left: 12 Projected Usage: 9,672 (within limit)

Resource Quotas

Track resource usage:

Usage Alerts

Receive notifications when:

Billing Management

Payment Methods

Manage payment options:

// Add payment method POST /api/billing/payment-methods { "card_number": "4242424242424242", "exp_month": 12, "exp_year": 2025, "cvc": "123", "billing_address": { "line1": "123 Main St", "city": "San Francisco", "state": "CA", "postal_code": "94102", "country": "US" } }

Invoices

Access billing history:

Invoice Details

Plan Changes

Upgrading

Upgrade to a higher plan:

  1. Navigate to Subscription Settings
  2. Click "Upgrade Plan"
  3. Select new plan (Growth or Scale)
  4. Review pricing and features
  5. Confirm upgrade
  6. Takes effect immediately
  7. Prorated billing for current period
💡 Immediate Upgrade

Upgrades take effect immediately. You'll be charged a prorated amount for the remainder of your billing cycle.

Downgrading

Downgrade to a lower plan:

  1. Navigate to Subscription Settings
  2. Click "Change Plan"
  3. Select lower plan (Starter or Growth)
  4. Review feature changes
  5. Confirm downgrade
  6. Takes effect at end of billing cycle
  7. No immediate charge
⚠️ Feature Loss Warning

Downgrading may disable features you're currently using. Review impacts before downgrading.

Cancellation

Cancel your subscription:

Add-Ons

Available Add-Ons

Extend your plan with:

Managing Add-Ons

// Add extra queries POST /api/billing/add-ons { "type": "extra_queries", "quantity": 5 // 5 packs of 1,000 queries } // Current add-ons { "extra_queries": 5, // +5,000 queries "extra_users": 2, // +2 users "extra_storage": 1, // +100GB "premium_support": true }

Trial Period

Free Trial

All plans include:

Trial Status

Track trial progress:

Subscription API

Get Subscription

GET /api/billing/subscription Response: { "id": 123, "organization_id": 456, "plan": "growth", "status": "active", "billing_cycle": "monthly", "current_period_start": "2024-12-01", "current_period_end": "2024-12-31", "cancel_at": null, "features": { "multi_db_queries": true, "ai_insights": true, "workflows": true, "real_time": false, "priority_support": false }, "quotas": { "monthly_queries": 10000, "data_sources": 10, "ai_agents": 20, "team_members": 15 } }

Get Usage

GET /api/billing/usage Response: { "period_start": "2024-12-01", "period_end": "2024-12-31", "queries_used": 7450, "queries_limit": 10000, "data_sources_used": 8, "ai_agents_used": 15, "team_members": 12, "storage_gb": 45.2 }

Best Practices

Support

Billing Support

For billing questions:

Common Issues