Public APIStatistics
Per-assistant usage for a week
Returns one breakdown row per assistant that had at least one completed
call in the selected week. Includes assistants that have since been
deleted — their calls still count and the row carries is_deleted: true.
All duration fields are integer seconds (billable, with 60s minimum).
AuthorizationBearer <token>
API key in the Authorization: Bearer <key> header.
Keys are created in the SMAO dashboard (Settings → API Keys).
In: header
Query Parameters
weekinteger
Range
1 <= value <= 53yearinteger
Range
2020 <= value <= 2100Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.smao.ai/api/v1/statistics/assistants?week=17&year=2026"{
"data": {
"period": {
"week": 17,
"year": 2026
},
"total_assistants": 0,
"total_calls": 0,
"assistants": [
{
"assistant_id": "string",
"assistant_name": "string",
"assistant_language": "string",
"is_deleted": true,
"total_calls": 0,
"total_call_seconds": 0,
"average_call_seconds": 0,
"average_calls_per_day": 0,
"weekly_call_counts": [
0,
0,
0,
0,
0,
0,
0
],
"weekly_call_seconds": [
0,
0,
0,
0,
0,
0,
0
],
"daily_call_counts": [
{
"date": "2026-04-22",
"count": 12
}
]
}
]
}
}{
"error": {
"code": "validation_failed",
"message": "Validation failed"
}
}{
"error": {
"code": "unauthorized",
"message": "Missing API key"
}
}{
"error": {
"code": "subscription_required",
"message": "This feature is not available in your current subscription. Please upgrade to a higher plan"
}
}{
"error": {
"code": "forbidden",
"message": "No permission"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred."
}
}