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"
      ]
    }
  ]
}
Example: "Messages sent" in October, compared to September.

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_sent
  • Messages received

    Inbound SMS and MMS messages received on your Twilio numbers in the period.

    twilio:messages_received
  • Total messages

    Every message sent and received in the period, across SMS, MMS and WhatsApp.

    twilio:messages_total
  • SMS sent

    Outbound SMS messages in the period.

    twilio:sms_sent
  • SMS received

    Inbound SMS messages in the period.

    twilio:sms_received
  • MMS 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_sent
  • MMS 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_received
  • WhatsApp messages

    WhatsApp template and service messages sent in the period. Free conversation windows are billed separately and are not counted here.

    twilio:whatsapp_messages
  • Message 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_segments
  • Messages delivered

    Outbound messages confirmed as delivered by the carrier, including WhatsApp messages marked as read.

    twilio:delivered_messages
  • Messages undelivered

    Outbound messages the carrier accepted but could not deliver, usually because the number is unreachable or blocked.

    twilio:undelivered_messages
  • Messages failed

    Outbound messages Twilio could not hand to the carrier at all.

    twilio:failed_messages
  • Delivery 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_rate
  • Failure rate

    Share of outbound messages that failed or were not delivered, over the messages that reached a final state.

    twilio:failure_rate
  • Total calls

    Calls handled by the account in the period, inbound and outbound.

    twilio:calls_total
  • Inbound calls

    Calls received on your Twilio numbers in the period.

    twilio:calls_inbound
  • Outbound calls

    Calls placed from the account in the period.

    twilio:calls_outbound
  • Call 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_minutes
  • Average call duration

    Average talk time of answered calls, measured in real seconds rather than billed minutes.

    twilio:avg_call_duration
  • Answered calls

    Calls that were answered and completed in the period.

    twilio:completed_calls
  • Busy calls

    Calls that reached a busy signal.

    twilio:busy_calls
  • Unanswered calls

    Calls that rang without being answered.

    twilio:no_answer_calls
  • Failed calls

    Calls that could not be connected.

    twilio:failed_calls
  • Answer rate

    Share of calls that were answered, over the calls that reached a final state.

    twilio:answer_rate
  • Total 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_spend
  • SMS and MMS spend

    Amount charged for SMS and MMS traffic in the period.

    twilio:messaging_spend
  • WhatsApp 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_spend
  • Voice spend

    Amount charged for voice calls in the period.

    twilio:voice_spend
  • Phone 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_day
  • Delivery 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_day
  • Calls 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_day
  • Spend 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_day
  • Messages by channel

    How the period's message volume splits across SMS, MMS and WhatsApp.

    twilio:messages_by_channel
  • Messages 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_summary
  • Spend 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_category
  • Outbound messages by status

    Final state of the outbound messages in the period, as reported by Twilio. Inbound messages are not included.

    twilio:messages_by_status
  • Most frequent errors

    Twilio error codes that appeared most often in the period, with the message Twilio returned for each one.

    twilio:top_error_codes
  • Calls 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.