Get a list of Conference Participants Summaries for a Conference.

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://twilio.demo.bump-doc.com/doc/insights/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "Insights MCP server": {
    "url": "https://twilio.demo.bump-doc.com/doc/insights/mcp"
  }
}

Close
GET /v1/Conferences/{ConferenceSid}/Participants

Get a list of Conference Participants Summaries for a Conference.

Path parameters

  • ConferenceSid string Required

    The unique SID identifier of the Conference.

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

Query parameters

  • ParticipantSid string

    The unique SID identifier of the Participant.

  • Label string

    User-specified label for a participant.

  • Events string

    Conference events generated by application or participant activity; e.g. hold, mute, etc.

  • 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
    • participants array[object]
      Hide participants attributes Show participants attributes object
      • participant_sid string | null

        SID for this participant.

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

      • label string | null

        The user-specified label of this participant.

      • conference_sid string | null

        The unique SID identifier of the Conference.

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

      • call_sid string | null

        Unique SID identifier of the call that generated the Participant resource.

        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}$.

      • call_direction string

        Call direction of the participant; inbound or outbound.

        Values are inbound or outbound.

      • from string | null

        Caller ID of the calling party.

      • to string | null

        Called party.

      • call_status string

        Call status of the call that generated the participant.

        Values are answered, completed, busy, fail, noanswer, ringing, or canceled.

      • country_code string | null

        ISO alpha-2 country code of the participant based on caller ID or called number.

      • is_moderator boolean | null

        Boolean. Indicates whether participant had startConferenceOnEnter=true or endConferenceOnExit=true.

      • join_time string(date-time) | null

        ISO 8601 timestamp of participant join event.

      • leave_time string(date-time) | null

        ISO 8601 timestamp of participant leave event.

      • duration_seconds integer | null

        Participant durations in seconds.

      • outbound_queue_length integer | null

        Add Participant API only. Estimated time in queue at call creation.

      • outbound_time_in_queue integer | null

        Add Participant API only. Actual time in queue in seconds.

      • jitter_buffer_size string

        The Jitter Buffer Size of this Conference Participant. One of large, small, medium or off.

        Values are large, small, medium, or off.

      • is_coach boolean | null

        Boolean. Indicated whether participant was a coach.

      • coached_participants array[string] | null

        Call SIDs coached by this participant.

      • participant_region string

        Twilio region where the participant media originates.

        Values are us1, us2, au1, br1, ie1, jp1, sg1, de1, or in1.

      • conference_region string

        The Conference Region of this Conference Participant. One of us1, us2, au1, br1, ie1, jp1, sg1 or de1.

        Values are us1, us2, au1, br1, ie1, jp1, sg1, de1, or in1.

      • call_type string

        The Call Type of this Conference Participant. One of carrier, client or sip.

        Values are carrier, client, or sip.

      • processing_state string

        Processing state of the Participant Summary. Will be in_progress while data is being aggregated, timeout if Twilio couldn't process the summary in 24hrs, and complete once aggregations and analysis has ended.

        Values are complete, in_progress, or timeout.

      • properties object | null

        Participant properties and metadata.

      • events object | null

        Object containing information of actions taken by participants. Contains a dictionary of URL links to nested resources of this Conference Participant.

      • metrics object | null

        Object. Contains participant call quality metrics.

      • url string(uri) | null

        The URL of this resource.

    • 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/Conferences/{ConferenceSid}/Participants
curl \
 --request GET 'https://insights.twilio.com/v1/Conferences/{ConferenceSid}/Participants' \
 --user "username:password"
Response examples (200)
{
  "meta": {
    "page": 0,
    "page_size": 25,
    "first_page_url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants?PageSize=25&Page=0",
    "previous_page_url": null,
    "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants?PageSize=25&Page=0",
    "next_page_url": null,
    "key": "participants"
  },
  "participants": [
    {
      "participant_sid": "CPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "label": null,
      "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "call_direction": "outbound",
      "from": "+10000000000",
      "to": "+10000000001",
      "call_status": "completed",
      "country_code": "US",
      "is_moderator": true,
      "join_time": "2021-10-08T02:58:51Z",
      "leave_time": "2021-10-08T02:59:55Z",
      "duration_seconds": 65,
      "outbound_queue_length": 0,
      "outbound_time_in_queue": 3361,
      "jitter_buffer_size": null,
      "is_coach": false,
      "coached_participants": null,
      "participant_region": "us1",
      "conference_region": "us1",
      "call_type": "carrier",
      "processing_state": "complete",
      "properties": {
        "start_conference_on_enter": true,
        "end_conference_on_exit": false,
        "play_early_media": true,
        "enter_muted": false,
        "beep_on_enter": false,
        "beep_on_exit": false
      },
      "metrics": {
        "inbound": {
          "total_packets_lost": 0,
          "total_packets_received": 70,
          "packet_loss_percentage": 0,
          "jitter": {
            "avg": 0.41,
            "max": 0.84
          },
          "latency": {
            "avg": 0,
            "max": 0
          },
          "mos": 4.4
        },
        "outbound": {
          "total_packets_lost": 0,
          "total_packets_received": 126,
          "packet_loss_percentage": 0,
          "jitter": {
            "avg": 0.01,
            "max": 0.01
          },
          "latency": {
            "avg": 0,
            "max": 0
          },
          "mos": 4.4
        }
      },
      "events": null,
      "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/CPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    },
    {
      "participant_sid": "CPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
      "label": null,
      "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "call_direction": "outbound",
      "from": "+10000000000",
      "to": "+10000000002",
      "call_status": "completed",
      "country_code": "US",
      "is_moderator": true,
      "join_time": "2021-10-08T02:58:52Z",
      "leave_time": "2021-10-08T02:59:54Z",
      "duration_seconds": 63,
      "outbound_queue_length": 0,
      "outbound_time_in_queue": 321,
      "jitter_buffer_size": null,
      "is_coach": false,
      "coached_participants": null,
      "participant_region": "us1",
      "conference_region": "us1",
      "call_type": "carrier",
      "processing_state": "complete",
      "properties": {
        "start_conference_on_enter": false,
        "end_conference_on_exit": false,
        "early_media": false,
        "enter_muted": true,
        "beep_on_enter": false,
        "beep_on_exit": false
      },
      "metrics": {
        "inbound": {
          "total_packets_lost": 0,
          "total_packets_received": 16,
          "packet_loss_percentage": 0,
          "jitter": {
            "avg": 0.26,
            "max": 0.45
          },
          "latency": {
            "avg": 0,
            "max": 0
          },
          "mos": 4.4
        },
        "outbound": {
          "total_packets_lost": 0,
          "total_packets_received": 42,
          "packet_loss_percentage": 0,
          "jitter": {
            "avg": 0.03,
            "max": 0.08
          },
          "latency": {
            "avg": 0,
            "max": 0
          },
          "mos": 4.4,
          "tags": [
            "silent"
          ]
        }
      },
      "events": {
        "mute": [
          1633705131000
        ]
      },
      "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/CPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab"
    }
  ]
}
{
  "meta": {
    "page": 0,
    "page_size": 25,
    "first_page_url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants?Label=client&PageSize=25&Page=0",
    "previous_page_url": null,
    "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants?Label=client&PageSize=25&Page=0",
    "next_page_url": null,
    "key": "participants"
  },
  "participants": [
    {
      "participant_sid": "CPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "call_direction": "outbound",
      "from": "+10000000000",
      "to": "+10000000001",
      "call_status": "completed",
      "country_code": "US",
      "is_moderator": true,
      "join_time": "2021-10-08T02:58:51Z",
      "leave_time": "2021-10-08T02:59:55Z",
      "duration_seconds": 65,
      "label": "client",
      "outbound_queue_length": 0,
      "outbound_time_in_queue": 3361,
      "jitter_buffer_size": null,
      "is_coach": false,
      "coached_participants": null,
      "participant_region": "us1",
      "conference_region": "us1",
      "call_type": "carrier",
      "processing_state": "complete",
      "properties": {
        "start_conference_on_enter": true,
        "end_conference_on_exit": false,
        "play_early_media": true,
        "enter_muted": false,
        "beep_on_enter": false,
        "beep_on_exit": false
      },
      "metrics": {
        "inbound": {
          "total_packets_lost": 0,
          "total_packets_received": 70,
          "packet_loss_percentage": 0,
          "jitter": {
            "avg": 0.41,
            "max": 0.84
          },
          "latency": {
            "avg": 0,
            "max": 0
          },
          "mos": 4.4
        },
        "outbound": {
          "total_packets_lost": 0,
          "total_packets_received": 96,
          "packet_loss_percentage": 0,
          "jitter": {
            "avg": 0.01,
            "max": 0.01
          },
          "latency": {
            "avg": 0,
            "max": 0
          },
          "mos": 4.4
        }
      },
      "events": null,
      "url": "https://insights.twilio.com/v1/Conferences/CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/CPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ]
}