Get assistant statistics

GET/assistants/{id}/statistics

Report on the inbound calls the assistant received, whatever their status: the total, the weekly volume over the last 12 weeks and the weekly average since the assistant went into service, the weekday and hour they arrive, and how long the answered ones lasted. Weeks, weekdays and hours are computed in Europe/Paris time. has_activity is false until the first inbound call, and weekly_average stays null until one full week of service has passed.

Request

curl -X GET "https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/statistics" \
  -H "Authorization: Bearer $REVOX_API_KEY"

const res = await fetch("https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/statistics", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
  },
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.get(
    "https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/statistics",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

{
  "statistics": {
    "assistant": {
      "id": "b2d4f6a8-1c3e-4a5b-8d7f-9e0a1b2c3d4e",
      "name": "Appointment reminder",
      "timezone": "Europe/Paris",
      "has_activity": false
    },
    "activity": {
      "calls_total": 3,
      "first_call_at": "2026-11-05T09:00:00Z",
      "in_service_since": "in service since",
      "weekly_average": 1,
      "weeks": [{ "week_start": "2026-11-02", "count": 3 }],
      "current_week_start": "2026-11-02"
    },
    "weekdays": {
      "days": [1],
      "hours": [1],
      "busiest_day": { "index": 1, "count": 3 },
      "busiest_hour": { "start": 1, "count": 3 }
    },
    "durations": {
      "average_seconds": 98,
      "buckets": {
        "under_1": 1,
        "from_1_to_2": 1,
        "from_2_to_3": 1,
        "over_3": 1
      },
      "unanswered": 1
    }
  }
}

{ "error": "Not found" }

Path parameters

idstringrequired
ID of the assistant, as returned by GET /assistants.

Request body

No body: send the request without one.

Response

200

statisticsobject
Report on the inbound calls the assistant received, over its whole history.

Errors

404Not found in your organization{ "error": string }

Error bodies carry an error (or message) string; a 400 adds bodyErrors.issues. See Errors.