Diagnose the account's current billing health in one call.
For questions like 'why am I being charged', 'why aren't my proxies working', 'why is my
subscription ending' or 'I was charged but didn't get my plan'. It checks payments,
payment methods, subscription state, verifications, suspension and notifications together
and returns the issues it finds, each with its evidence.
RETURNS:
- status: overall health ('critical', 'action_required', 'informational', 'all_clear').
- issues[]: the detected issues, most important first. Each issue is a discriminated union
by `category`, carrying only the evidence fields relevant to that category.
CATEGORIES:
- payment_stuck_unallocated: the account was charged but the purchase was not provisioned.
Critical. Refund or manual provisioning is owed.
- account_suspended: account is locked out of service.
- card_failed: a payment was declined. is_initial_purchase tells a first-purchase failure
from a renewal failure. Severity depends on failed_payment_times (== 2 = critical
because proxies are throttled to ~1 MB/month).
- no_payment_method: no card on file and the subscription needs one soon.
- verification_blocking: an open verification flow is preventing normal service.
- card_expiring_soon: the card on file will expire and renewals will start failing.
- subscription_paused: the subscription is paused (proxies disabled).
- subscription_throttled: the subscription is throttled (reduced speeds/concurrency).
- payment_processing: a payment is in-flight; usually clears within minutes.
NOT INCLUDED: plan and proxy inventory (list_plans, list_proxies), the full history of
each payment (list_pending_payments, list_transactions), and verification questions and
answers (list_verification_questions, get_verification).