Docs
Api
Billing

Billing & usage API

Read your subscription status, plan limits, and per-site article credit consumption.

Get subscription status

bash
GET /v1/billing/subscription
json
{
  "plan": "growth",
  "status": "active",
  "currentPeriodStart": "2025-07-01T00:00:00Z",
  "currentPeriodEnd": "2025-07-31T23:59:59Z",
  "articlesIncluded": 30,
  "articlesUsed": 14,
  "articlesRemaining": 16,
  "sites": 3
}

Get per-site usage

bash
GET /v1/billing/usage?period=current_month
json
{
  "period": "2025-07",
  "sites": [
    {
      "siteId": "site_01hx9z...",
      "domain": "myblog.com",
      "articlesGenerated": 9,
      "selfHealingPatches": 2
    }
  ]
}