Get a list of Call Insight Events for a Call.

GET /v1/Voice/{CallSid}/Events

Get a list of Call Insight Events for a Call.

Path parameters

  • CallSid string Required

    The unique SID identifier of the Call.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CA[0-9a-fA-F]{32}$.

Query parameters

  • Edge string | null

    The Edge of this Event. One of unknown_edge, carrier_edge, sip_edge, sdk_edge or client_edge.

    Values are unknown_edge, carrier_edge, sip_edge, sdk_edge, or client_edge.

  • PageSize integer(int64)

    How many resources to return in each list page. The default is 50, and the maximum is 1000.

    Minimum value is 1, maximum value is 1000.

  • Page integer

    The page index. This value is simply for client state.

    Minimum value is 0.

  • PageToken string

    The page token. This is provided by the API.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • events array[object]
      Hide events attributes Show events attributes object
      • timestamp string | null

        Event time.

      • call_sid string | null

        The unique SID identifier of the Call.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CA[0-9a-fA-F]{32}$.

      • account_sid string | null

        The unique SID identifier of the Account.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

      • edge string | null

        The Edge of this Event. One of unknown_edge, carrier_edge, sip_edge, sdk_edge or client_edge.

        Values are unknown_edge, carrier_edge, sip_edge, sdk_edge, or client_edge.

      • group string | null

        Event group.

      • level string | null

        The Level of this Event. One of UNKNOWN, DEBUG, INFO, WARNING or ERROR.

        Values are UNKNOWN, DEBUG, INFO, WARNING, or ERROR.

      • name string | null

        Event name.

      • carrier_edge object | null

        Represents the connection between Twilio and our immediate carrier partners. The events here describe the call lifecycle as reported by Twilio's carrier media gateways.

      • sip_edge object | null

        Represents the Twilio media gateway for SIP interface and SIP trunking calls. The events here describe the call lifecycle as reported by Twilio's public media gateways.

      • sdk_edge object | null

        Represents the Voice SDK running locally in the browser or in the Android/iOS application. The events here are emitted by the Voice SDK in response to certain call progress events, network changes, or call quality conditions.

      • client_edge object | null

        Represents the Twilio media gateway for Client calls. The events here describe the call lifecycle as reported by Twilio's Voice SDK media gateways.

    • meta object
      Hide meta attributes Show meta attributes object
      • first_page_url string(uri)
      • key string
      • next_page_url string(uri) | null
      • page integer
      • page_size integer
      • previous_page_url string(uri) | null
      • url string(uri)
GET /v1/Voice/{CallSid}/Events
curl \
 --request GET 'https://insights.twilio.com/v1/Voice/{CallSid}/Events' \
 --user "username:password"
Response examples (200)
{
  "meta": {
    "key": "events",
    "url": "https://insights.twilio.com/v1/Voice/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?PageSize=50&Page=0",
    "page": 0,
    "page_size": 50,
    "next_page_url": null,
    "first_page_url": "https://insights.twilio.com/v1/Voice/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?PageSize=50&Page=0",
    "previous_page_url": null
  },
  "events": [
    {
      "edge": "sdk_edge",
      "name": "error",
      "group": "connection",
      "level": "ERROR",
      "call_sid": "CA03a02b156c6faa96c86906f7e9ad0f38",
      "sdk_edge": {
        "error": {
          "code": 31600
        },
        "metadata": {
          "sdk": {
            "os": {
              "name": "android",
              "version": "4.3"
            },
            "type": "twilio-voice-android",
            "device": {
              "arch": "armeabi-v7a",
              "type": "GT-I9300",
              "model": "GT-I9300",
              "vendor": "samsung"
            },
            "version": "4.5.1",
            "platform": "android",
            "selected_region": "gll"
          },
          "city": "Mountain View",
          "location": {
            "lat": 37.4192,
            "lon": -122.0574
          },
          "ip_address": "108.177.7.83",
          "client_name": "GTI9300323095d271b890c91568931321395",
          "country_code": "US",
          "country_subdivision": "California"
        }
      },
      "sip_edge": null,
      "timestamp": "2019-09-19T22:15:23Z",
      "account_sid": "AC998c10b68cbfda9f67277f7d8f4439c9",
      "client_edge": null,
      "carrier_edge": null
    }
  ]
}
{
  "meta": {
    "key": "events",
    "url": "https://insights.twilio.com/v1/Voice/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?PageSize=5&Page=10",
    "page": 10,
    "page_size": 5,
    "next_page_url": null,
    "first_page_url": "https://insights.twilio.com/v1/Voice/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?PageSize=5&Page=0",
    "previous_page_url": "https://insights.twilio.com/v1/Voice/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?PageSize=5&Page=9&PageToken=PT10"
  },
  "events": [
    {
      "edge": "sdk_edge",
      "name": "error",
      "group": "connection",
      "level": "ERROR",
      "call_sid": "CA03a02b156c6faa96c86906f7e9ad0f38",
      "sdk_edge": {
        "error": {
          "code": 31600
        },
        "metadata": {
          "sdk": {
            "os": {
              "name": "android",
              "version": "4.3"
            },
            "type": "twilio-voice-android",
            "device": {
              "arch": "armeabi-v7a",
              "type": "GT-I9300",
              "model": "GT-I9300",
              "vendor": "samsung"
            },
            "version": "4.5.1",
            "platform": "android",
            "selected_region": "gll"
          },
          "city": "Mountain View",
          "location": {
            "lat": 37.4192,
            "lon": -122.0574
          },
          "ip_address": "108.177.7.83",
          "client_name": "GTI9300323095d271b890c91568931321395",
          "country_code": "US",
          "country_subdivision": "California"
        }
      },
      "sip_edge": null,
      "timestamp": "2019-09-19T22:15:23Z",
      "account_sid": "AC998c10b68cbfda9f67277f7d8f4439c9",
      "client_edge": null,
      "carrier_edge": null
    }
  ]
}