Analytics & Reports API

Analytics & Reports API These read-only endpoints let you pull your account's activity into your own dashboards and reports: message-event counts, credit consumption, AI spend, and the same charts and insights the in-app dashboard shows. This guide covers: Summary — message-volume counters (sent, delivered, read, replied, booked, contacts created, credits). Credits — a detailed, paginated ledger of credit usage with totals and breakdowns. AI cost — a per-day rollup of AI spend. Metric series — a chart-ready time series for one or more metrics, grouped by campaign, channel, AI Agent, or number. Conversation outcomes — conversations over time, grouped by the contact tags they carry (the closing tags your agent applies). Dashboard insights and Dashboard AI insights — the full data behind the in-app dashboard, including AI-written summaries. Entity activity — a single contact's, deal's, or task's timeline. Aggregated event counts — a legacy, camelCase form of Summary kept for existing integrations. Every endpoint on this page needs an exact scope, not both: pass at most one of campaign_id (legacy) or agent_id where the endpoint accepts it. Sending both returns 400 , and an id that is not on your account returns 404 rather than 403 , so other accounts' ids stay unguessable. Only two endpoints filter by contact tag. tag_ids (with tag_match ) is honoured by Dashboard insights and Aggregated event counts — those are the two the in-app dashboard's All tags filter uses. Summary , M