API Reference

Credits

Check your account balance, tier, per-minute rate, and concurrent call limit. Use this endpoint in monitoring jobs to alert on low balance before calls start failing.

GET/v1/credits

curl https://api.staffifyai.com/v1/credits \
  -H "Authorization: Bearer sfy_live_YOUR_KEY"

Response

{
  "balance":          42.50,
  "tier":             "payg",
  "rate_per_minute":  0.25,
  "is_paused":        false,
  "concurrent_limit": 10,
  "credits_expire_at": null,
  "updated_at":       "2026-06-01T09:14:22.000Z"
}

Field	Type	Description
balance	number	Current credit balance in EUR
tier	string	payg \| starter \| growth \| enterprise
rate_per_minute	number	Your current per-minute voice call rate (EUR)
is_paused	boolean	true when a PAYG, Starter, or Growth account is paused due to zero credits. Enterprise accounts are never paused regardless of balance.
concurrent_limit	number	Max simultaneous active calls for your tier
credits_expire_at	string \| null	ISO timestamp when prepaid credits expire, or null if no expiry
updated_at	string	ISO timestamp of the last balance change

Low-balance monitoring

async function checkCredits(threshold = 10) {
  const { balance, is_paused, tier } = await fetch(
    'https://api.staffifyai.com/v1/credits',
    { headers: { Authorization: `Bearer ${process.env.STAFFIFY_API_KEY}` } }
  ).then(r => r.json());

  if (is_paused) {
    await sendAlert('CRITICAL: Staffify account paused -- top up credits immediately');
    return { balance, is_paused };
  }

  if (balance < threshold) {
    await sendAlert(`Low credits warning: EUR ${balance.toFixed(2)} remaining (tier: ${tier})`);
  }

  return { balance, is_paused };
}

// Run every hour in your monitoring cron:
checkCredits(20); // alert below EUR 20

Limits by tier

Tier	Voice rate	Concurrent calls	API req / min	Monthly commitment
PAYG	€0.15/min	10	300	None
Starter	€0.14/min	50	600	€1,400/mo
Growth	€0.12/min	100	1,200	€3,000/mo
Enterprise	Custom	Unlimited	Unlimited	Custom

Enterprise accounts are invoiced monthly and are not paused on zero balance. Top up credits at console.staffifyai.com/billing.

← Usage API Overview →