Skip to main content
Version: 0.8.0

BillingAccount

Billing Account represents the payment entity that owns one or more organizations. Tier limits and quotas are enforced at the billing account level, not per-organization.

This prevents abuse where users could create multiple orgs to multiply their quotas. For example:

  • Business tier ($29) = 10k links/month across ALL orgs in the billing account
  • Not 10k per org (which would be 30k for 3 orgs)
created_atinteger<int64>required
Example: 1609459200
idstringrequired
Example: ba_abc123def456
owner_user_idstringrequired
Example: user-123456
provider_customer_idstring | nullnullable

Polar customer ID for the billing account

Example: cust_abc123
tierstringrequired
Example: pro
BillingAccount
{
"created_at": 1609459200,
"id": "ba_abc123def456",
"owner_user_id": "user-123456",
"provider_customer_id": "cust_abc123",
"tier": "pro"
}