Email

How to get your Instantly API usage, balance and spend programmatically

Partly. GET https://api.instantly.ai/api/v2/workspace-billing/plan-details returns your outreach plan (price, lead limit, current lead count, period end) and the Lead Finder credit balance. Monthly email-send usage isn't exposed.

What the Instantly API exposes

SignalInstantly
BalanceYes. GET /api/v2/workspace-billing/plan-details (subscriptions.credits.available_credits)
Spend historyNo
Cost breakdownNo
Plan and quotaYes
Cost on each responseNo
Rate-limit headersNone
CredentialAPI key

Call it yourself

Credential. An Instantly v2 API key.

Plan and credits

curl https://api.instantly.ai/api/v2/workspace-billing/plan-details \
  -H "Authorization: Bearer $INSTANTLY_API_KEY"
{
  "subscriptions": {
    "outreach": {
      "plan_name": "Hypergrowth",
      "price_in_dollars": 97,
      "interval": "month",
      "total_lead_limit": 25000,
      "current_lead_count": 18420,
      "current_period_end": "2026-11-01T00:00:00Z"
    },
    "credits": {
      "total_credits": 2000,
      "available_credits": 640,
      "current_period_end": "2026-11-01T00:00:00Z"
    }
  }
}

Trimmed to the fields Argus reads. Values are examples.

Gotchas

  • Lead Finder credits are a separate subscription. The credits block is missing if you don't have one.
  • Annual plans report the yearly price_in_dollars. Divide by 12 for a monthly figure.
  • Limits are hard caps, not metered. You upgrade or add contact packs.

How Instantly charges

Cold-outreach sending plans capped by uploaded contacts + emails/month (unlimited inboxes & warmup). Lead Finder credits are a separate subscription.

PlanMonthly price
Growth$47
Hypergrowth$97
Light Speed$358
EnterpriseContact sales

At zero. 429. Hard caps, not metered — upgrade tier or add contact packs. Lead credits block at 0.

Or let Argus track it

Paste the key once. Argus keeps the ledger, and your coding agent reads it through the MCP server.

  • Reads the Instantly balance every hour and keeps the series, so you get burn per day (top-ups never count as negative spend) and days until it hits zero.
  • Tracks the plan: the allowance, what's used this period, the reset date, and when you cross into overage.
  • With the SDK, counts each call and every 429 against the plan's allowance, since there's no meter to read.
  • Emails you on low balance, days to zero, a spend spike, or projected overage.
  • Hands all of it to your coding agent over MCP, so it can ask what a run cost or how much runway is left without leaving the editor.
> what has instantly cost today, and how long until it runs out?

get_overview       → instantly: mtd spend, burn per day, days to zero
get_request_costs  { "provider": "instantly", "limit": 25 }
get_advisories     → credits_low, spend_spike, rate_limit_low …

Questions

Does Instantly have an API for its balance?
Partly. GET https://api.instantly.ai/api/v2/workspace-billing/plan-details returns your outreach plan (price, lead limit, current lead count, period end) and the Lead Finder credit balance. Monthly email-send usage isn't exposed.
Can I get Instantly spend per day from the API?
Not as a series. Derive it from how much the balance drops each day, ignoring top-ups.
What happens when Instantly credits run out?
Requests fail with HTTP 429. Hard caps, not metered — upgrade tier or add contact packs. Lead credits block at 0.
What key does Argus need for Instantly?
An Instantly v2 API key.

Related

Pricing and limits verified 2026-10-16 against instantly.ai/pricing, help.instantly.ai/en/articles/7917050-add-on-pricing, developer.instantly.ai, api.instantly.ai/openapi/api_v2.json. Endpoints are the ones the Argus Instantly connector calls.

Let your coding agent watch the meter.

Connect a provider key, point Claude Code or Cursor at the Argus MCP server, and ask what the last run cost.