Usage Limits

Each LostChurn plan has limits on several primary dimensions: failed payments per month, retry attempts per payment, campaigns, and team members. This page explains exactly what counts toward each limit and what happens when you reach them.

Failed Payments

A failed payment is a subscription payment that LostChurn receives via webhook and enters into a recovery workflow. Each unique failed payment counts toward your monthly limit.

What Counts

Limits by Plan

When You Hit the Limit

When you reach your monthly failed payment limit:

• New failures are queued -- LostChurn continues to ingest and classify failed payment webhooks, but they are queued for recovery until the next billing cycle or until you upgrade.
• Existing recoveries continue -- payments already in a recovery workflow are not interrupted. Retries and dunning messages for in-progress recoveries still execute.
• Dashboard and analytics remain available -- you can still view recovery status, analytics, and customer data.

You will receive email notifications at 80% and 100% of your monthly limit. Owners and Admins also see a banner in the dashboard.

Retry Attempts

Each plan limits the number of retry attempts per failed payment. This is the maximum number of times LostChurn will attempt to re-charge a single failed payment before marking it as terminal.

Limits by Plan

Retry attempts include both silent payment retries submitted to your PSP and any retry triggered as part of a dunning campaign workflow.

Campaigns

A campaign is a configured dunning sequence with a trigger, one or more steps, and stop conditions. Each campaign definition counts toward your limit, regardless of how many customers are enrolled in it.

What Counts

Limits by Plan

To free up a campaign slot, archive a campaign you no longer need. Archived campaigns retain their historical performance data but no longer enroll new customers.

Team Members

A team member is anyone with access to your LostChurn workspace, regardless of their role (Owner, Admin, Member, or Viewer).

Limits by Plan

When You Hit the Limit

You cannot invite additional team members until you remove an existing member or upgrade your plan. Pending invitations that have not been accepted count toward the limit.

Monitoring Your Usage

You can view your current usage at any time in the dashboard:

1. Navigate to Settings > Billing > Usage.
2. The usage dashboard shows current consumption for each dimension alongside your plan limits.
3. A bar chart shows daily failed payment usage for the current billing cycle.

Usage data is updated in near-real-time. There may be a delay of up to 60 seconds between an action and its reflection in the usage dashboard.

Usage API

You can also query usage programmatically via the billing usage endpoint:

curl https://api.lostchurn.com/v1/billing/usage \
  -H "Authorization: Bearer lc_live_your_api_key"

The response includes real-time usage for each dimension alongside your plan limits:

{
  "usage": {
    "plan": "engine",
    "status": "active",
    "current_period_start": "2026-03-01T00:00:00Z",
    "current_period_end": "2026-03-31T00:00:00Z",
    "failed_payments": { "current": 412, "limit": 1000 },
    "retries_per_payment": { "current": 3, "limit": 8 },
    "campaigns": { "current": 2, "limit": 5 },
    "team_members": { "current": 2, "limit": 3 }
  },
  "billing": {
    "total_recovered_cents": 124500,
    "recovery_breakdown": [],
    "performance_rate": 0.25,
    "performance_fee_cents": 31125,
    "base_fee_cents": 14900,
    "total_due_cents": 14900
  }
}

A limit of -1 means unlimited (applies to Recovery, Command, and Enterprise tiers for certain dimensions).

Edge Pre-Checks

Plan limits are also cached at the Cloudflare edge for fast, non-blocking pre-checks on inbound webhooks. The edge cache stores your tier and limits (but not live usage counts) so that canceled subscriptions and obvious over-limit scenarios are rejected before reaching the database. SpacetimeDB remains the authoritative gate for all usage enforcement.

Overage Policy

LostChurn does not charge overage fees. When you hit a limit, the affected functionality is paused until the limit resets or you upgrade. No surprise charges will appear on your invoice.

Next Steps

• Plans & Pricing -- compare all plan features and pricing
• Managing Your Subscription -- upgrade, downgrade, and payment management