Dashboard
Channel:
All
SMS
Email
WhatsApp
Voice
Period:
7 days
30 days
90 days
Total Messages Sent
2.41M
β² 12.3% vs prev period
4 active channels
Delivery Rate
97.3%
β² 0.4pp improvement
Target β₯ 97.0% Β· β On track
Error Rate
0.82%
βΌ 0.11pp from last period
Top: invalid_recipient
p95 Latency
1.4s
βΌ 220ms faster
SLA: β€ 500ms p95 Β· β
Delivery Rate by Channel
Last 30 days Β· daily
Message Volume
Last 30 days Β· stacked by channel
Error Breakdown
Last 30 days Β· all channels Β· click a row to drill in
| Error Category | Channel | Count | Share | Trend | |
|---|---|---|---|---|---|
| invalid_recipient | SMS | 8,412 | 34.2% | β² +5.1% | |
| carrier_reject | SMS | 5,887 | 23.9% | βΌ β2.3% | |
| bounce_hard | 4,201 | 17.1% | βΌ β8.7% | ||
| timeout | WA | 2,114 | 8.6% | β² +1.2% | |
| spam_filtered | SMS | 1,892 | 7.7% | βΌ β14.2% |
Live Event Stream
Canonical CommunicationEvent Β· refreshes every 60s
| Event ID | Type | Channel | Status | Latency | Timestamp (UTC) |
|---|
Scheduled Reports
Delivery History
β
4 active scheduled reports Β· Next delivery: Monday 07:00 UTC β Weekly Delivery Summary to maya@acmecorp.com
Weekly Delivery Summary
All channels Β· PDF + CSV Β· maya@acmecorp.com
Monthly Billing Reconciliation
All products Β· PDF Β· stefan@acmecorp.com, finance@acmecorp.com
Daily Error Rate Alert
SMS Β· Email Β· Slack webhook + email Β· ops@acmecorp.com
Quarterly Performance Review
All channels Β· Executive summary Β· leila@acmecorp.com
| Report Name | Delivered To | Format | Sent At (UTC) | Status | |
|---|---|---|---|---|---|
| Weekly Delivery Summary | maya@acmecorp.com | PDF + CSV | 2025-05-12 07:00 | Delivered | |
| Daily Error Rate Alert | ops@acmecorp.com + Slack | Email + Webhook | 2025-05-12 06:00 | Delivered | |
| Daily Error Rate Alert | ops@acmecorp.com + Slack | Email + Webhook | 2025-05-11 06:00 | Delivered | |
| Weekly Delivery Summary | maya@acmecorp.com | PDF + CSV | 2025-05-05 07:00 | Delivered | |
| Monthly Billing Reconciliation | stefan@acmecorp.com | 2025-05-01 08:00 | Delivered |
Endpoints β v1
GET/v1/eventsQuery events
GET/v1/metricsDelivery metrics
POST/v1/exports/bulkAsync Parquet export
GET/v1/catalog/metricsMetric definitions
GET/v1/audit/logImmutable audit log
POST/v1/gdpr/erasureGDPR erasure request
Authentication
curl -X POST https://auth.sinch.com/oauth/token \
-d "grant_type=client_credentials" \
-d "client_id=$CLIENT_ID" \
-d "client_secret=$CLIENT_SECRET"
# Returns JWT Β· TTL 3600s Β· use as Bearer token
# Scope: events:read billing:read exports:write
GET /v1/events
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| since | ISO 8601 | required | Start of window |
| until | ISO 8601 | optional | End of window (default: now) |
| channel | enum | optional | sms Β· email Β· whatsapp Β· voice |
| event_type | enum | optional | delivered · failed · opened⦠|
| cursor | string | optional | Pagination cursor |
| limit | int | optional | Max 1000 Β· default 100 |
Try it
Response Schema
{
"data": [{
"event_id": "evt_3kLm9XqR",
"event_type": "message.delivered",
"account_id": "acc_f8k2n9a1",
"channel": "sms",
"timestamp": "2025-05-12T13:42:01Z",
"status": "delivered",
"latency_ms": 812,
"recipient_id_hash": "sha256:a3f9β¦b81c",
"billable": true,
"cost": { "amount": 0.0072, "currency": "USD" },
"data_residency_region":"EU"
}],
"pagination": {
"next_cursor": "cur_7xQp3nR9",
"has_more": true,
"total_count": 24108
}
}
Metrics
Event Types
Schema Reference
π All metrics use the same canonical definition across all channels. Click any metric to see its full specification.
| Event Type | Channels | Description | Has Latency | Billable |
|---|---|---|---|---|
| message.sent | SMS EMAIL WA | Message accepted by Sinch and dispatched to carrier | β | Yes |
| message.delivered | SMS EMAIL WA | Carrier confirmed delivery to recipient device | Yes | β |
| message.failed | SMS EMAIL WA VOICE | Delivery failed. error_category contains reason. | β | β |
| message.opened | EMAIL WA | Recipient opened the message (tracking pixel / read receipt) | β | β |
| message.clicked | EMAIL WA | Recipient clicked a tracked link in the message | β | β |
| message.replied | SMS WA | Recipient replied (two-way messaging) | β | β |
| message.bounced | Hard or soft bounce β see error_category | β | β | |
| verification.initiated | SMS VOICE | OTP verification flow started | β | Yes |
| verification.completed | SMS VOICE | OTP verified successfully | Yes | β |
| call.completed | VOICE | Voice call ended β includes duration_s and cost | Yes | Yes |
CommunicationEvent β all fields
π Identity
event_idstring Β· UUID
account_idstring Β· injected
product_idstring Β· enum
channelstring Β· enum
π Lifecycle
event_typestring Β· enum (15)
timestampdatetime Β· ISO 8601
statusstring Β· enum
sequence_numint64
π€ Parties
sender_idstring
recipient_id_hashstring Β· HMAC
sender_typestring Β· enum
π¦ Delivery
error_categorystring Β· enum (8)
latency_msint32
attemptsint Β· default 1
carrier_idstring
π³ Billing (billing:read)
billableboolean
cost.amountdecimal
cost.currencystring Β· ISO 4217
unit_pricedecimal
π‘ Compliance
retention_classstring Β· enum
data_residency_regionstring Β· EU / US
gdpr_erasure_statusstring Β· enum
ai_query_hintsobject Β· catalog
π€ Beta. Every answer is grounded in your data only, explainable, and subject to the same access controls as the API. No data is ever sent to an AI model β only a structured query object.
Ask a question about your data
Try an example
SMS delivery rate: this week vs last
Top 3 error categories this month
WhatsApp volume trend β last 30 days
Total spend by channel in May
Which day had the highest error rate?
How many messages failed due to carrier_reject?
Answer
SMS delivery rate last week: 97.6% β up +0.4pp from 97.2% the week before.
Based on 1,482,310 SMS events May 5β11 vs 1,318,940 events Apr 28βMay 4. Only your account data (acc_f8k2n9a1) was queried.
How I got this answer
π Provenance β always shown, cannot be disabled
Data sourcecommunication_events
Account filteracc_f8k2n9a1 (injected)
Channelsms
Period β current2025-05-05 β 2025-05-11
Period β previous2025-04-28 β 2025-05-04
Formuladelivered Γ· sent Γ 100
Records scanned2,801,250 events
ConfidenceHigh β no data gaps
QuerySpec (structured query β not raw SQL)
{
"table": "communication_events",
"account_id": "acc_f8k2n9a1", // executor injects this
"channel": "sms",
"metrics": ["delivery_rate"],
"time_ranges":[
{"label":"current","since":"2025-05-05","until":"2025-05-11"},
{"label":"previous","since":"2025-04-28","until":"2025-05-04"}
],
"raw_sql": false // never
}
The AI outputs a controlled schema object β never raw SQL. Cross-account queries are architecturally impossible.
Team Members
Audit Log
API Keys
Team Members (5)
Manage who has access and what they can do
| User | Role | Last Active | Status | |
|---|---|---|---|---|
MA Maya Andersen maya@acmecorp.com | Today 13:42 | Active | ||
AR Arjun Rao arjun@acmecorp.com | Today 13:38 | Active | ||
ST Stefan Toth stefan@acmecorp.com | Today 13:21 | Active | ||
LE Leila Ek leila@acmecorp.com | Today 13:09 | Active | ||
PR Priya Sharma priya@acmecorp.com | Yesterday | Idle |
Role Permissions
| Role | Dashboard | API / Exports | Billing fields | AI Query | Manage Team |
|---|---|---|---|---|---|
| Account Admin | β | β | β | β | β |
| Analytics User | β | Read only | β | β | β |
| API Consumer | β | β | β | β | β |
| Billing Viewer | Limited | β | β | β | β |
| Compliance Officer | β | β | β | β | β |
π Audit log is immutable and append-only. Every access to your data is recorded β including AI queries. 365-day retention.
| User | Action | Resource | IP | Timestamp (UTC) |
|---|---|---|---|---|
| maya@acmecorp.com | dashboard.view | /v1/metrics Β· channel=all | 203.0.113.42 | 2025-05-12 13:42:01 |
| arjun@acmecorp.com | api.query | /v1/events Β· cursor pagination | 203.0.113.18 | 2025-05-12 13:38:44 |
| stefan@acmecorp.com | billing.export | /v1/exports/billing Β· CSV | 203.0.113.91 | 2025-05-12 13:21:13 |
| leila@acmecorp.com | ai.query | NLQ: "delivery rate last weekβ¦" | 203.0.113.55 | 2025-05-12 13:09:02 |
| system | token.refresh | acc_f8k2n9a1 | internal | 2025-05-12 13:00:00 |
| priya@acmecorp.com | api.export | /v1/exports/bulk Β· Parquet | 203.0.113.77 | 2025-05-11 18:45:30 |
| arjun@acmecorp.com | api.key.created | key_9xQp3nR β API Consumer | 203.0.113.18 | 2025-05-11 09:12:05 |
API Keys
OAuth 2.0 service accounts Β· JWT Β· 60-min token TTL
| Name | Key ID | Scope | Created | Last Used | |
|---|---|---|---|---|---|
| Production Pipeline | key_9xQp3nR | events:read exports:write | 2025-05-11 | Today 13:38 | |
| BI Warehouse Sync | key_4mKz7pL | events:read | 2025-04-02 | Today 18:45 | |
| Billing Automation | key_2bNw8vQ | billing:read | 2025-03-15 | Yesterday |