Metrics
Twilio metrics via API
Your customer connects their Twilio account and your product queries 40 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_sent",
"component": "number_v1",
"metrics": [
"messages_sent"
]
}
]
}More Twilio request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Chart
Messages over time
Messages sent and received on each day of the period. Twilio groups usage by UTC day, so a day here may not match your local calendar exactly.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_by_day",
"component": "chart_v1",
"metrics": [
"messages_sent",
"messages_received"
],
"dimensions": [
"date"
]
}
]
}Table
Volume and spend by channel
Messages and amount charged for each channel in the period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:channel_summary",
"component": "datatable_v1",
"metrics": [
"messages_total",
"total_spend"
],
"dimensions": [
"channel"
]
}
]
}Number
Messages received
Inbound SMS and MMS messages received on your Twilio numbers in the period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_received",
"component": "number_v1",
"metrics": [
"messages_received"
]
}
]
}Numbers
29 metrics
Messages sent
Outbound SMS, MMS and WhatsApp messages in the period, counted by Twilio's usage records.
twilio:messages_sentMessages received
Inbound SMS and MMS messages received on your Twilio numbers in the period.
twilio:messages_receivedTotal messages
Every message sent and received in the period, across SMS, MMS and WhatsApp.
twilio:messages_totalSMS sent
Outbound SMS messages in the period.
twilio:sms_sentSMS received
Inbound SMS messages in the period.
twilio:sms_receivedMMS sent
Outbound MMS messages in the period. Twilio only offers MMS in the United States and Canada, so accounts outside those countries always report zero.
twilio:mms_sentMMS received
Inbound MMS messages in the period. Twilio only offers MMS in the United States and Canada, so accounts outside those countries always report zero.
twilio:mms_receivedWhatsApp messages
WhatsApp template and service messages sent in the period. Free conversation windows are billed separately and are not counted here.
twilio:whatsapp_messagesMessage segments
Billable segments across every message in the period. A long text is split into several segments, which is what Twilio charges for.
twilio:message_segmentsMessages delivered
Outbound messages confirmed as delivered by the carrier, including WhatsApp messages marked as read.
twilio:delivered_messagesMessages undelivered
Outbound messages the carrier accepted but could not deliver, usually because the number is unreachable or blocked.
twilio:undelivered_messagesMessages failed
Outbound messages Twilio could not hand to the carrier at all.
twilio:failed_messagesDelivery rate
Share of outbound messages confirmed as delivered, over the messages that reached a final state. Messages still in transit are left out of the calculation.
twilio:delivery_rateFailure rate
Share of outbound messages that failed or were not delivered, over the messages that reached a final state.
twilio:failure_rateTotal calls
Calls handled by the account in the period, inbound and outbound.
twilio:calls_totalInbound calls
Calls received on your Twilio numbers in the period.
twilio:calls_inboundOutbound calls
Calls placed from the account in the period.
twilio:calls_outboundCall minutes
Billed voice minutes in the period. Twilio rounds each call up to the next minute, so this is what you pay for rather than exact talk time.
twilio:call_minutesAverage call duration
Average talk time of answered calls, measured in real seconds rather than billed minutes.
twilio:avg_call_durationAnswered calls
Calls that were answered and completed in the period.
twilio:completed_callsBusy calls
Calls that reached a busy signal.
twilio:busy_callsUnanswered calls
Calls that rang without being answered.
twilio:no_answer_callsFailed calls
Calls that could not be connected.
twilio:failed_callsAnswer rate
Share of calls that were answered, over the calls that reached a final state.
twilio:answer_rateTotal spend
Everything Twilio charged the account in the period, as reported by its own usage total. Costs are estimates until Twilio closes the invoice.
twilio:total_spendSMS and MMS spend
Amount charged for SMS and MMS traffic in the period.
twilio:messaging_spendWhatsApp spend
Amount charged for WhatsApp traffic in the period. Meta moved WhatsApp to per-template pricing in July 2025, so comparisons across that date are not equivalent.
twilio:whatsapp_spendVoice spend
Amount charged for voice calls in the period.
twilio:voice_spendPhone numbers spend
Amount charged for the phone numbers the account keeps.
twilio:phone_numbers_spend
Charts
6 metrics
Messages over time
Messages sent and received on each day of the period. Twilio groups usage by UTC day, so a day here may not match your local calendar exactly.
twilio:messages_by_dayDelivery rate over time
Share of messages delivered on each day of the period. Twilio groups by UTC day, so a day here may not match your local calendar exactly.
twilio:delivery_rate_by_dayCalls over time
Calls handled on each day of the period. Twilio groups by UTC day, so a day here may not match your local calendar exactly.
twilio:calls_by_daySpend over time
Amount Twilio charged on each day of the period. Twilio groups by UTC day, so a day here may not match your local calendar exactly.
twilio:spend_by_dayMessages by channel
How the period's message volume splits across SMS, MMS and WhatsApp.
twilio:messages_by_channelMessages by direction
How the period's message volume splits between outbound and inbound.
twilio:messages_by_direction
Tables
5 metrics
Volume and spend by channel
Messages and amount charged for each channel in the period.
twilio:channel_summarySpend by product
Amount Twilio charged for each product in the period. Anything outside the listed products is grouped under Other, so the rows always add up to total spend.
twilio:spend_by_categoryOutbound messages by status
Final state of the outbound messages in the period, as reported by Twilio. Inbound messages are not included.
twilio:messages_by_statusMost frequent errors
Twilio error codes that appeared most often in the period, with the message Twilio returned for each one.
twilio:top_error_codesCalls by status
Final state of the calls in the period, as reported by Twilio.
twilio:calls_by_status
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
