SMAO API Documentation
Public APIStatistics

List available statistics filters

GET
/statistics/summary

Returns the filter values that populate statistics dashboards: every ISO (week, year) pair, in German time (Europe/Berlin), in which at least one completed call of the organization started, 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.

Authorization

bearerAuth
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://example.com/statistics/summary"
{  "data": {    "available_weeks": [      {        "week": 0,        "year": 0      }    ],    "available_assistants": [      {        "id": "string",        "name": "string"      }    ]  }}

Get a website chat with its messages GET

The chat and the messages the visitor saw, oldest first: visitor messages, AI replies, team replies, and system notices. Internal messages such as the AI's tool calls are not included. Reading a chat never marks it as read.

Usage breakdown for a week + assistant filter GET

Returns the monthly + weekly + last-24h breakdown for the selected week/year window. `assistant_id=all` aggregates across every assistant; passing a concrete 24-hex ID filters to that assistant's calls only. Supplying an ID that does not belong to the caller's organization returns 404.