Subscription Lookup

Subscription Deep Dive

Complete subscription lifecycle: current state, billing history, and health signals.

Step 1 — Resolve the subscription

If $ARGUMENTS looks like a subscription ID (starts with SUB):

• ZohoBilling_Get_a_Subscription directly

If $ARGUMENTS is a customer name:

• ZohoBilling_Search_Customers with search_text: $ARGUMENTS → customer_id
• ZohoBilling_List_all_Subscriptions with customer_id → if multiple, ask which one

Step 2 — Fetch (run in parallel after subscription_id known)

Output

Subscription Deep Dive — [Customer] · [SUB-XXXXX]
────────────────────────────────────────────────────────────────
Plan:           [Plan name]  ·  $XX/[frequency]
Status:         ACTIVE | TRIAL | PAST_DUE | NON_RENEWING | CANCELLED
Started:        [date]   ·  Tenure: X months
Next renewal:   [date]   ·  Auto-collect: Yes | No
Billing mode:   Online | Offline

BILLING HISTORY (last 6 invoices)
  [INV-XXXXX]  [date]  $X,XXX  ✅ Paid | ❌ Overdue | ⚠ Partial
  ...

HEALTH SIGNALS
  🟢 No issues  |  ⚠ [specific flags]

Common flags:
  • PAST_DUE — last renewal failed, N retries remaining
  • NON_RENEWING — scheduled to cancel on [date]
  • Partial payment on [INV] — $X outstanding
  • Last paid [X] days ago — [normal | late]
────────────────────────────────────────────────────────────────

Constraints

• Show last 6 invoices for this subscription only
• NON_RENEWING subscriptions: always show the scheduled cancellation date prominently
• Propose-only: no subscription modifications

Edge cases

• Cancelled subscription: show full history with cancellation date and reason if available
• Subscription ID not found: "Subscription [ID] not found — check the ID and try again"
• Customer has multiple active subscriptions: list them all and ask which one to deep-dive