curl --request GET \
--url https://api.telleo.ai/v1/usage \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.telleo.ai/v1/usage"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.telleo.ai/v1/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"object": "usage",
"source": "api",
"from": "<string>",
"to": "<string>",
"timezone": "<string>",
"totals": {
"calls": 123,
"connected": 123,
"talk_seconds": 123,
"credits": 123,
"calls_not_yet_billed": 123
},
"days": [
{
"date": "2026-10-01",
"calls": 123,
"connected": 123,
"talk_seconds": 123,
"credits": 123
}
],
"human_calls": {
"totals": {
"calls": 123,
"connected": 123,
"talk_seconds": 123,
"credits": 123,
"calls_not_yet_billed": 123
},
"days": [
{
"date": "2026-10-01",
"calls": 123,
"connected": 123,
"talk_seconds": 123,
"credits": 123
}
]
}
}Get usage
Calls, connected calls, talk time and credits charged per day. Credits come from your account’s ledger; test calls are not included.
Scope: calls:read.
curl --request GET \
--url https://api.telleo.ai/v1/usage \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.telleo.ai/v1/usage"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.telleo.ai/v1/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"object": "usage",
"source": "api",
"from": "<string>",
"to": "<string>",
"timezone": "<string>",
"totals": {
"calls": 123,
"connected": 123,
"talk_seconds": 123,
"credits": 123,
"calls_not_yet_billed": 123
},
"days": [
{
"date": "2026-10-01",
"calls": 123,
"connected": 123,
"talk_seconds": 123,
"credits": 123
}
],
"human_calls": {
"totals": {
"calls": 123,
"connected": 123,
"talk_seconds": 123,
"credits": 123,
"calls_not_yet_billed": 123
},
"days": [
{
"date": "2026-10-01",
"calls": 123,
"connected": 123,
"talk_seconds": 123,
"credits": 123
}
]
}
}Authorizations
Your AI calling API key (vak_call_…). Authorization: Bearer <key> also works.
Query Parameters
First day, YYYY-MM-DD. Default: 6 days before to.
Last day (included). Default: today. At most 92 days after from.
IANA zone the days are cut in, e.g. Asia/Kolkata.
api: calls placed through the API. all: every AI call on your account.
api, all Response
Usage per day.
"usage"api, all Show child attributes
Show child attributes
Show child attributes
Show child attributes
Human (counsellor) calls in the same range: with source=api those placed through POST /human-calls, with source=all every outbound counsellor call placed on Vacademy Voice, Exotel or Airtel (uploaded recordings of calls made elsewhere are not counted). Only Vacademy Voice talk time is charged.
Show child attributes
Show child attributes