SMAO API Documentation
Public APIStatistics

List available statistics filters

Returns the filter values that populate statistics dashboards: every (week, year) pair that has at least one completed call in the organization, plus every assistant in the organization. The all assistant sentinel is not returned — clients can always pass assistant_id=all to the /usage endpoint regardless of this list.

GET
/statistics/summary
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Response 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/summary"
{
  "data": {
    "available_weeks": [
      {
        "week": 17,
        "year": 2026
      }
    ],
    "available_assistants": [
      {
        "id": "65a1234567890abcdef01234",
        "name": "Inbound Receptionist"
      }
    ]
  }
}
{
  "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."
  }
}