Billing & Plans

Manage your subscription, view available plans, and access billing information through the API.

Plans Overview

Free

$0/mo

  • 3 endpoints
  • 10,000 events/month
  • 7 days retention
  • 5 cron jobs

Pro

Popular

$29/mo

  • 25 endpoints
  • 100,000 events/month
  • 30 days retention
  • 50 cron jobs
  • Custom retry config

Business

$99/mo

  • Unlimited endpoints
  • 1M events/month
  • 90 days retention
  • Unlimited cron jobs
  • Priority support

Get Available Plans

Retrieve all available subscription plans. No authentication required.

GET /v1/billing/plans

Response

Json

-1 indicates unlimited for that feature.

Get Current Subscription

Retrieve the authenticated user's current subscription and usage.

GET /v1/billing/subscription

Response

Json

Create Checkout Session

Create a checkout session to upgrade or change your plan. Redirects to Paddle checkout.

POST /v1/billing/checkout
FieldTypeDescription
plan_idstringID of the plan to subscribe to

Response

Json

Access Customer Portal

Get a URL to the Paddle customer portal for managing payment methods and viewing invoices.

POST /v1/billing/portal

Response

Json

Downgrade Plan

Downgrade to a lower plan. Takes effect at the end of the current billing period.

POST /v1/billing/downgrade
FieldTypeDescription
plan_idstringID of the plan to downgrade to

Warning

When downgrading, ensure your usage is within the new plan's limits to avoid service interruption.

Billing Webhook Events

HookWatch receives webhook events from Paddle for billing updates. These events automatically update your subscription status.

  • subscription.created - New subscription started
  • subscription.updated - Plan changed or renewed
  • subscription.canceled - Subscription canceled
  • subscription.paused - Payment failed, subscription paused

Related