> ## Documentation Index > Fetch the complete documentation index at: https://docs.contentignite.com/llms.txt > Use this file to discover all available pages before exploring further. # /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. ## OpenAPI ````yaml /openapi.json get /v1/ai/activity/overview openapi: 3.0.1 info: title: CI Public API description: >- # Introduction Welcome to the Content Ignite API. A central place for all Content Ignite functionality. This API enforces a separation between function and form, meaning anything you can do in our platforms can be replicated in your own bespoke solution. # Authentication Authentication is handled via JWTs. You can retrieve your unique JSON Web Token from the settings page in the platform, which needs to be passed in with every request. To do this, simple include it in an Authorization header with the "Bearer" key word. Please contact support for help getting started. # Error Codes This is a fully RESTful API, so prepare for a number of different HTTP status codes. There is also a standard "success" field returned for each request. This boolean value can provide a first check against a response. # Rate limit We reserve the right to block requests if we deem a client to be abusing the API. version: 1.0.0 servers: - url: https://api.tagdeliver.com description: Production security: - BearerAuth: [] tags: - name: Reporting - name: Reporting/Revenue Reports - name: Reporting/Experiment Reporting - name: Reporting/Campaign Reports - name: Reporting/Health Check - name: Reporting/Ads.txt - name: Reporting/Utility - name: Reporting/Insights Hub - name: Reporting/Insights Hub/SSP Insights - name: Reporting/Insights Hub/Core Web Vitals - name: Reporting/Insights Hub/Ads.txt Insights - name: Reporting/Insights Hub/Live Insights - name: Reporting/Insights Hub/Metrics - name: Reporting/Insights Hub/Diagnostics - name: Reporting/Insights Hub/Revenue Insights - name: Reporting/Insights Hub/Revenue Analytics - name: Reporting/Insights Hub/Demand Mix - name: Reporting/Insights Hub/Benchmarking - name: Organisation - name: Organisation/Organisation Meta - name: Organisation/Pricing - name: Ad Stack - name: Ad Stack/Integration - name: Publisher - name: Publisher/Publisher Stack - name: Publisher/Publisher Tag - name: Publisher/Publisher Meta - name: Publisher/Experiment - name: Publisher/Config (Ad unit) - name: Publisher/App Placement - name: AI - name: AI/Activity - name: Billing - name: Billing/Invoice - name: Audit Log - name: '[IN PROGRESS] Integration' - name: '[IN PROGRESS] Integration/Mapping' - name: '[IN PROGRESS] User' - name: '[IN PROGRESS] User/Account' - name: public paths: /v1/ai/activity/overview: get: tags: - AI/Activity - public summary: /ai/activity/overview description: >- 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. parameters: - name: range in: query description: >- 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 required: false schema: type: string enum: - 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 default: thirty_days - name: start in: query description: Start date when range=custom required: false schema: type: string format: date - name: end in: query description: End date when range=custom required: false schema: type: string format: date - name: date_group in: query description: Groups the daily series by day, month or quarter required: false schema: type: string enum: - day - month - quarter default: day - name: source in: query description: >- Only include one route: `chat` (Spark questions and chat naming) or `summary` (AI summaries) required: false schema: type: string enum: - chat - summary - name: organisation_id in: query description: Comma-separated organisation IDs required: false schema: type: string - name: user_id in: query description: Comma-separated user IDs required: false schema: type: string - name: outcome in: query description: Only include successful or failed requests required: false schema: type: string enum: - success - failure - name: user_type in: query description: Only include admins (`admin`) or everyone else (`non_admin`) required: false schema: type: string enum: - admin - non_admin - name: exclude_internal in: query description: Set to `1` to leave out internal organisations required: false schema: type: string enum: - '0' - '1' default: '0' responses: '200': description: '' content: application/json: schema: type: object properties: sources: type: object properties: chat: type: object properties: source: type: string description: Route enum: - chat - summary active_users: type: integer description: Users with activity active_organisations: type: integer description: Organisations with activity questions: type: integer description: Spark questions asked conversations: type: integer description: Spark chats with a question summaries: type: integer description: AI summary generations, retries included failures: type: integer description: Failed questions and summary generations tokens: type: integer description: Input, cached input, cache write and output tokens cost_usd: type: number description: Estimated cost, in USD cost_gbp: type: number description: Estimated cost, in GBP at each day's exchange rate input_tokens: type: integer description: Uncached input tokens cached_input_tokens: type: integer description: Input tokens read from the prompt cache cache_write_tokens: type: integer description: Input tokens written to the prompt cache output_tokens: type: integer description: Output tokens input_cost_gbp: type: number description: Cost of uncached input, in GBP cached_input_cost_gbp: type: number description: Cost of cached input, in GBP cache_write_cost_gbp: type: number description: Cost of cache writes, in GBP output_cost_gbp: type: number description: Cost of output, in GBP required: - source - active_users - active_organisations - questions - conversations - summaries - failures - tokens - cost_usd - cost_gbp - input_tokens - cached_input_tokens - cache_write_tokens - output_tokens - input_cost_gbp - cached_input_cost_gbp - cache_write_cost_gbp - output_cost_gbp summary: type: object properties: source: type: string description: Route enum: - chat - summary active_users: type: integer description: Users with activity active_organisations: type: integer description: Organisations with activity questions: type: integer description: Spark questions asked conversations: type: integer description: Spark chats with a question summaries: type: integer description: AI summary generations, retries included failures: type: integer description: Failed questions and summary generations tokens: type: integer description: Input, cached input, cache write and output tokens cost_usd: type: number description: Estimated cost, in USD cost_gbp: type: number description: Estimated cost, in GBP at each day's exchange rate input_tokens: type: integer description: Uncached input tokens cached_input_tokens: type: integer description: Input tokens read from the prompt cache cache_write_tokens: type: integer description: Input tokens written to the prompt cache output_tokens: type: integer description: Output tokens input_cost_gbp: type: number description: Cost of uncached input, in GBP cached_input_cost_gbp: type: number description: Cost of cached input, in GBP cache_write_cost_gbp: type: number description: Cost of cache writes, in GBP output_cost_gbp: type: number description: Cost of output, in GBP required: - source - active_users - active_organisations - questions - conversations - summaries - failures - tokens - cost_usd - cost_gbp - input_tokens - cached_input_tokens - cache_write_tokens - output_tokens - input_cost_gbp - cached_input_cost_gbp - cache_write_cost_gbp - output_cost_gbp description: >- The same figures per route, with tokens and cost split by token type; routes with no activity are left out totals: type: object properties: active_users: type: integer description: Users with activity active_organisations: type: integer description: Organisations with activity questions: type: integer description: Spark questions asked conversations: type: integer description: Spark chats with a question summaries: type: integer description: AI summary generations, retries included failures: type: integer description: Failed questions and summary generations tokens: type: integer description: Input, cached input, cache write and output tokens cost_usd: type: number description: Estimated cost, in USD cost_gbp: type: number description: Estimated cost, in GBP at each day's exchange rate unpriced_rows: type: integer description: Requests whose cost could not be calculated failed_cost_gbp: type: number description: Cost of failed requests, in GBP failed_cost_usd: type: number description: Cost of failed requests, in USD non_admin_users: type: integer description: Active users who are not admins admin_users: type: integer description: Active users who are admins required: - active_users - active_organisations - questions - conversations - summaries - failures - tokens - cost_usd - cost_gbp - unpriced_rows - failed_cost_gbp - failed_cost_usd - non_admin_users - admin_users description: Figures across every route included daily: type: array items: type: object properties: date: type: string description: >- Day, or the first day of the month or quarter bucket (Y-m-d) questions: type: integer description: Spark questions summaries: type: integer description: Summary generations chat_cost_gbp: type: number description: Spark chat cost, in GBP summary_cost_gbp: type: number description: AI summaries cost, in GBP required: - date - questions - summaries - chat_cost_gbp - summary_cost_gbp description: >- One row per day (or month or quarter, by date_group), with empty buckets as zeros failures: type: array items: type: object properties: reason: type: string description: Failure category enum: - timeout - overloaded - rate_limited - too_long - connection - data_lookup - no_data_used - no_answer - invalid_response - not_saved - not_started - provider_error - unknown label: type: string description: Readable name for the category description: type: string description: What the category means failures: type: integer description: Failures in the category required: - reason - label - description - failures description: Failures grouped into categories, largest first pages: type: array items: type: object properties: page: type: string description: Route pattern, or "unknown" when not recorded questions: type: integer description: Questions asked from the page failures: type: integer description: Of which failed required: - page - questions - failures description: The ten pages with the most Spark questions pages_other: type: object properties: pages: type: integer description: Pages outside the top ten questions: type: integer description: Their questions failures: type: integer description: Of which failed required: - pages - questions - failures description: >- Pages outside the top ten rolled up, or null when there are none nullable: true organisations: type: array items: type: object properties: organisation_id: type: integer description: Organisation ID organisation_name: type: string description: Organisation name nullable: true users: type: integer description: Users with activity questions: type: integer description: Spark questions asked conversations: type: integer description: Spark chats with a question summaries: type: integer description: AI summary generations, retries included failures: type: integer description: Failed questions and summary generations tokens: type: integer description: Input, cached input, cache write and output tokens cost_usd: type: number description: Estimated cost, in USD cost_gbp: type: number description: Estimated cost, in GBP at each day's exchange rate required: - organisation_id - organisation_name - users - questions - conversations - summaries - failures - tokens - cost_usd - cost_gbp description: Up to 100 organisations, by cost users: type: array items: type: object properties: user_id: type: integer description: User ID user_name: type: string description: Display name nullable: true is_admin: type: integer description: 1 for admins nullable: true organisations: type: string description: >- Organisations the user was active in, comma separated nullable: true questions: type: integer description: Spark questions asked conversations: type: integer description: Spark chats with a question summaries: type: integer description: AI summary generations, retries included failures: type: integer description: Failed questions and summary generations tokens: type: integer description: Input, cached input, cache write and output tokens cost_usd: type: number description: Estimated cost, in USD cost_gbp: type: number description: Estimated cost, in GBP at each day's exchange rate required: - user_id - user_name - is_admin - organisations - questions - conversations - summaries - failures - tokens - cost_usd - cost_gbp description: Up to 100 users, by cost success: type: boolean required: - sources - totals - daily - failures - pages - pages_other - organisations - users - success example: 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 headers: {} '403': description: Not an admin content: application/json: schema: type: object properties: success: type: boolean message: type: string required: - success - message example: success: false message: User forbidden headers: {} deprecated: false security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.