google_ads_get_billing_status

Billing status

Google

Description

Why a call was refused with a billing error (402) and how to get unblocked. Reports whether this organization is entitled, its subscription status, tier, trial end, credits used and left this period, the price table and a link to the billing page. With checkout_tier, the organization owner also gets a Stripe Checkout link for that plan; a member gets the owner's contact and a message to forward. Call it after any 402. While waiting for a human to pay, poll it every 10 seconds for the first minute, every 30 seconds until 5 minutes, then every 60 seconds until 15 minutes, then stop and tell the human. Once it returns entitled: true, retry the blocked call; if the retry still returns 402, wait 15 seconds and retry once. A Checkout link is a payment link: give it to the organization owner only.

IdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_billing_status",
    "arguments": {
      "reason": "A tool call was refused with a billing error (402)"
    }
  }
}

Parameters

NameTypeRequiredDescription
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (1)
NameTypeRequiredDescription
checkout_tier string Optional Organization owner only: also create a Stripe Checkout link for this plan. A member gets the owner's contact and a message to forward instead.
starter pro enterprise

Examples

After a billing error

{
  "reason": "A tool call was refused with a billing error (402)"
}

hopkin google billing-status get

Owner: Checkout link

{
  "checkout_tier": "pro",
  "reason": "The organization owner wants to pay for Pro now"
}

hopkin google billing-status get --checkout-tier pro