Credits and usage

​

Balance

curl https://api.telleo.ai/v1/credits -H "X-API-Key: $TELLEO_API_KEY"

{
  "object": "credits",
  "balance": 1834.25,
  "low_balance_threshold": 10.0,
  "low_balance": false,
  "can_place_calls": true,
  "calls_waiting": 42,
  "updated_at": "2026-10-14T05:12:40Z"
}

​

Usage per day

curl "https://api.telleo.ai/v1/usage?from=2026-10-01&to=2026-10-14&timezone=Asia/Kolkata" \
  -H "X-API-Key: $TELLEO_API_KEY"

{
  "object": "usage",
  "source": "api",
  "from": "2026-10-01",
  "to": "2026-10-14",
  "timezone": "Asia/Kolkata",
  "totals": { "calls": 1240, "connected": 702, "talk_seconds": 95310, "credits": 9821.5, "calls_not_yet_billed": 3 },
  "days": [
    { "date": "2026-10-01", "calls": 88, "connected": 51, "talk_seconds": 6912, "credits": 712.0 },
    { "date": "2026-10-02", "calls": 0, "connected": 0, "talk_seconds": 0, "credits": 0.0 }
  ],
  "human_calls": {
    "totals": { "calls": 96, "connected": 61, "talk_seconds": 18240, "credits": 312.0, "calls_not_yet_billed": 0 },
    "days": [
      { "date": "2026-10-01", "calls": 7, "connected": 5, "talk_seconds": 1320, "credits": 22.5 }
    ]
  }
}

• calls counts dial attempts; connected counts calls that were answered; talk_seconds is the total length of connected calls.
• credits is what was actually charged for those calls, read from your account’s ledger. Calls are listed on the day they were placed.
• Test calls are not included.
• human_calls has the same figures for human calls: with source=api the calls placed through POST /v1/human-calls, with source=all every outbound counsellor call placed on Vacademy Voice, Exotel or Airtel (from the API, the dashboard’s Call button, or an Airtel extension). Recordings of calls made elsewhere and uploaded to Telleo are not counted. Only Vacademy Voice talk time is charged to your credits; calls on your own Exotel or Airtel account count with 0 credits. AI analysis of human calls is charged separately and is not in these figures.
• Charges are made shortly after a call ends. calls_not_yet_billed counts calls with a charge still to be made: the call minutes of a connected call, or the AI minutes once its outcome has been processed. Their credits arrive within minutes. Calls that are never charged (for example on your own telephony provider’s minutes) are not counted.

​

Cost of one call

"cost": { "credits": 12.5, "billed": true }

• credits: what this call was charged. 0 for test calls and for calls that did not connect, which are never billed.
• billed: false while a charge for this call is still to be made (the call minutes right after it ends, then the AI minutes once its outcome is processed), usually for a few minutes. Read the call again later for the final amount.
• cost is null while the call has not ended.

​

Rates