How to get your Instantly API usage, balance and spend programmatically
What the Instantly API exposes
| Signal | Instantly |
|---|---|
| Balance | Yes. GET /api/v2/workspace-billing/plan-details (subscriptions.credits.available_credits) |
| Spend history | No |
| Cost breakdown | No |
| Plan and quota | Yes |
| Cost on each response | No |
| Rate-limit headers | None |
| Credential | API 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.
| Plan | Monthly price |
|---|---|
| Growth | $47 |
| Hypergrowth | $97 |
| Light Speed | $358 |
| Enterprise | Contact 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.
Connect a provider key, point Claude Code or Cursor at the Argus MCP server, and ask what the last run cost.