/ai/activity/overview

Headline usage, cost and failure figures for Spark chat and AI summaries in the period, with a daily series, failure reasons, the pages questions come from, and the top organisations and users. Only available to admins. Results cover the organisations your account can access.

GET /v1/ai/activity/overview

/ai/activity/overview

cURL

curl --request GET \
  --url https://api.tagdeliver.com/v1/ai/activity/overview \
  --header 'Authorization: Bearer <token>'

200

{
  "sources": {
    "chat": {
      "source": "chat",
      "active_users": 6,
      "active_organisations": 4,
      "questions": 42,
      "conversations": 18,
      "summaries": 0,
      "failures": 3,
      "tokens": 21500000,
      "cost_usd": 38.12,
      "cost_gbp": 28.54,
      "input_tokens": 900000,
      "cached_input_tokens": 4200000,
      "cache_write_tokens": 300000,
      "output_tokens": 60000,
      "input_cost_gbp": 2.1,
      "cached_input_cost_gbp": 0.98,
      "cache_write_cost_gbp": 0.87,
      "output_cost_gbp": 0.7
    }
  },
  "totals": {
    "active_users": 12,
    "active_organisations": 7,
    "questions": 42,
    "conversations": 18,
    "summaries": 96,
    "failures": 3,
    "tokens": 21500000,
    "cost_usd": 38.12,
    "cost_gbp": 28.54,
    "unpriced_rows": 0,
    "failed_cost_gbp": 0.41,
    "failed_cost_usd": 0.55,
    "non_admin_users": 10,
    "admin_users": 2
  },
  "daily": [
    {
      "date": "2026-10-01",
      "questions": 4,
      "summaries": 9,
      "chat_cost_gbp": 0.62,
      "summary_cost_gbp": 2.41
    }
  ],
  "failures": [
    {
      "reason": "timeout",
      "label": "Timed out",
      "description": "The AI service or one of its data lookups took too long to respond.",
      "failures": 2
    }
  ],
  "pages": [
    {
      "page": "/revenue-insights",
      "questions": 12,
      "failures": 1
    }
  ],
  "pages_other": null,
  "organisations": [
    {
      "organisation_id": 101,
      "organisation_name": "Example Media Ltd",
      "users": 3,
      "questions": 42,
      "conversations": 18,
      "summaries": 96,
      "failures": 3,
      "tokens": 21500000,
      "cost_usd": 38.12,
      "cost_gbp": 28.54
    }
  ],
  "users": [
    {
      "user_id": 1001,
      "user_name": "Alex",
      "is_admin": 0,
      "organisations": "Example Media Ltd",
      "questions": 42,
      "conversations": 18,
      "summaries": 96,
      "failures": 3,
      "tokens": 21500000,
      "cost_usd": 38.12,
      "cost_gbp": 28.54
    }
  ],
  "success": true
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

range · enum<string> · default: thirty_days

Date range to report on. Preset ranges end yesterday and today is today so far. month_to_date is the current month so far and week_to_date is the current week so far. custom requires start and end (YYYY-MM-DD). Other values return a 400 error

Available options: custom, all_time, today, seven_days, fourteen_days, thirty_days, three_months, six_months, week_to_date, month_to_date, quarter_to_date, year_to_date, last_week, last_month, last_quarter, last_year, month_on_month, quarter_on_quarter, yesterday

start · string<date>

Start date when range=custom

end · string<date>

End date when range=custom

date_group · enum<string> · default: day

Groups the daily series by day, month or quarter

Available options: day, month, quarter

source · enum<string>

Only include one route: chat (Spark questions and chat naming) or summary (AI summaries)

Available options: chat, summary

organisation_id · string

Comma-separated organisation IDs

user_id · string

Comma-separated user IDs

outcome · enum<string>

Only include successful or failed requests

Available options: success, failure

user_type · enum<string>

Only include admins (admin) or everyone else (non_admin)

Available options: admin, non_admin

exclude_internal · enum<string> · default: 0

Set to 1 to leave out internal organisations

Available options: 0, 1

Response

200

application/json

sources · object · required

The same figures per route, with tokens and cost split by token type; routes with no activity are left out

Show child attributes

totals · object · required

Figures across every route included

Show child attributes

daily · object[] · required

One row per day (or month or quarter, by date_group), with empty buckets as zeros

Show child attributes

failures · object[] · required

Failures grouped into categories, largest first

Show child attributes

pages · object[] · required

The ten pages with the most Spark questions

Show child attributes

pages_other · object | null · required

Pages outside the top ten rolled up, or null when there are none

Show child attributes

organisations · object[] · required

Up to 100 organisations, by cost

Show child attributes

users · object[] · required

Up to 100 users, by cost

Show child attributes

success · boolean · required