> This page is for APIs.

> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# call.member.list

GET /

List room members

Reference: https://signalwire.com/docs/apis/relay/client/fabric/call-member-list

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: call.member.list
  version: subpackage_callMemberList.call.member.list
  description: List room members
channels:
  /:
    description: List room members
    publish:
      operationId: subpackage_callMemberList.call.member.list-publish
      summary: call.member.list response
      message:
        name: onCallMemberListResponse
        title: call.member.list response
        payload:
          $ref: '#/components/schemas/call.member.list_callMemberListResponse'
    subscribe:
      operationId: subpackage_callMemberList.call.member.list-subscribe
      summary: call.member.list
      message:
        name: callMemberList
        title: call.member.list
        payload:
          $ref: '#/components/schemas/call.member.list_callMemberListRequest'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsCallMemberListMessagesCallMemberListResponseJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallMemberListMessagesCallMemberListResponseJsonrpc
    FabricCallMemberType:
      type: string
      enum:
        - member
      description: Always `member`.
      title: FabricCallMemberType
    Fabric.CallMember:
      type: object
      properties:
        member_id:
          type: string
          description: The member ID. Equals the member's call ID.
        call_id:
          type: string
          description: The member's call ID.
        node_id:
          type: string
          description: The node the member's call leg lives on.
        room_id:
          type: string
          description: The room ID. On a 1:1 call this is the call ID.
        room_session_id:
          type: string
          description: The room session ID. On a 1:1 call this is the call ID.
        type:
          $ref: '#/components/schemas/FabricCallMemberType'
          description: Always `member`.
        name:
          type: string
          description: >-
            Display name: the subscriber's name when the leg belongs to a
            subscriber, otherwise the dialed number or address. Absent when none
            of these is known.
        parent_id:
          type: string
          description: The call that created this member's call, when there is one.
        address_id:
          type: string
          description: The Resource address the call is associated with, when known.
        subscriber_id:
          type: string
          description: The subscriber the call belongs to, when known.
        visible:
          type: boolean
          description: Always `true` on a 1:1 call.
        handraised:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        audio_muted:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        video_muted:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        deaf:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        echo_cancellation:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        auto_gain:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        noise_suppression:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        denoise:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        lowbitrate:
          type: boolean
          description: Reported as `false` on a 1:1 call.
        meta:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            The public metadata set on the call. An empty object when none is
            set.
      required:
        - member_id
        - call_id
        - node_id
        - room_id
        - room_session_id
        - type
        - visible
        - handraised
        - audio_muted
        - video_muted
        - deaf
        - echo_cancellation
        - auto_gain
        - noise_suppression
        - denoise
        - lowbitrate
        - meta
      description: >-
        The member object for a 1:1 (non-conference) Call Fabric call. Carried
        on

        `member.joined` and `member.left`, inside `call.joined`'s
        `room_session.members`, and

        returned by `call.member.list` on a 1:1 call. Unlike the conference
        `Member`, it is

        keyed by `member_id` (no `id`) and has no volume, sensitivity, or
        position fields. The

        boolean state fields report their defaults.
      title: Fabric.CallMember
    Fabric.Member:
      type: object
      properties:
        id:
          type: string
          description: The member ID.
        room_id:
          type: string
          description: The room this member belongs to.
        room_session_id:
          type: string
          description: The room session this member belongs to.
        name:
          type: string
          description: Friendly display name.
        type:
          type: string
          description: The member type, such as `member` or `screen`.
        call_id:
          type: string
          description: >-
            The member's call ID. Present on join events and where the member is
            addressed directly.
        parent_id:
          type: string
          description: >-
            Associated parent member, for a screenshare or an additional-device
            member.
        audio_muted:
          type: boolean
          description: Whether the member's audio is muted.
        video_muted:
          type: boolean
          description: Whether the member's video is muted.
        handraised:
          type: boolean
          description: Whether the member has their hand raised.
        visible:
          type: boolean
          description: Whether the member is visible in the layout.
        deaf:
          type: boolean
          description: Whether the member is deafened (not hearing the conference audio).
        input_volume:
          type: number
          format: double
          description: >-
            Input (microphone) volume, in decibels, from -50 to 50. May be
            fractional.
        output_volume:
          type: number
          format: double
          description: >-
            Output (speaker) volume, in decibels, from -50 to 50. May be
            fractional.
        input_sensitivity:
          type: number
          format: double
          description: Input (microphone) sensitivity, from 0.0 to 100.0.
        requested_position:
          type: string
          description: The member's last-requested layout position.
        meta:
          type: object
          additionalProperties:
            description: Any type
          description: Customer-provided metadata for the member.
        node_id:
          type: string
          description: >-
            The node the member's call leg lives on. Present on most member
            events.
        updated:
          type: array
          items:
            type: string
          description: The fields that changed — present on the `member.updated` event.
      required:
        - id
        - room_id
        - room_session_id
        - name
        - type
        - audio_muted
        - video_muted
        - handraised
        - visible
        - deaf
        - input_volume
        - output_volume
        - input_sensitivity
        - requested_position
        - meta
      description: >-
        A member of a Call Fabric conference — one participant's state. Carried
        on the

        `member.updated`, `member.joined`, and `member.left` events and returned
        by

        `call.member.list` in a conference. Fields match the Video API's
        `Member`.


        On a 1:1 (non-conference) call, member data uses the `CallMember` shape
        instead,

        keyed by `member_id` rather than `id`.
      title: Fabric.Member
    FabricFabricMemberListResultMembersItems:
      oneOf:
        - $ref: '#/components/schemas/Fabric.CallMember'
        - $ref: '#/components/schemas/Fabric.Member'
      title: FabricFabricMemberListResultMembersItems
    Fabric.FabricMemberListResult:
      type: object
      properties:
        code:
          type: string
          description: >-
            Result code as a string. `"200"` is success. Failures use `"400"`
            (bad request),

            `"403"` (permission denied, or the operation does not apply to this
            call),

            `"404"` (not found), `"409"` (conflict), or `"500"` (internal
            error). When the

            request could not be delivered, `code` is a named string instead,
            such as

            `"response_timeout"`, `"invalid_params"`, `"not_available"`,
            `"parse_error"`, or

            `"unknown:<n>"`.
        message:
          type: string
          description: >-
            Human-readable description of the result. Always `"Success"` on
            success; on failure it describes the error, for example `"Permission
            denied"`.
        members:
          type: array
          items:
            $ref: '#/components/schemas/FabricFabricMemberListResultMembersItems'
          description: >-
            The members currently in the room. On a 1:1 call these are
            `CallMember` objects (keyed by `member_id`); in a conference they
            are `Member` objects.
      required:
        - code
        - members
      description: >-
        The result of `call.member.list`: the standard `FabricResult` fields
        plus the room's members.
      title: Fabric.FabricMemberListResult
    JsonRpcErrorCode0:
      type: string
      enum:
        - '-32000'
      title: JsonRpcErrorCode0
    JsonRpcErrorCode1:
      type: string
      enum:
        - '-32001'
      title: JsonRpcErrorCode1
    JsonRpcErrorCode2:
      type: string
      enum:
        - '-32002'
      title: JsonRpcErrorCode2
    JsonRpcErrorCode3:
      type: string
      enum:
        - '-32003'
      title: JsonRpcErrorCode3
    JsonRpcErrorCode4:
      type: string
      enum:
        - '-32004'
      title: JsonRpcErrorCode4
    JsonRpcErrorCode5:
      type: string
      enum:
        - '-32005'
      title: JsonRpcErrorCode5
    JsonRpcErrorCode6:
      type: string
      enum:
        - '-32600'
      title: JsonRpcErrorCode6
    JsonRpcErrorCode7:
      type: string
      enum:
        - '-32601'
      title: JsonRpcErrorCode7
    JsonRpcErrorCode8:
      type: string
      enum:
        - '-32602'
      title: JsonRpcErrorCode8
    JsonRpcErrorCode9:
      type: string
      enum:
        - '-32603'
      title: JsonRpcErrorCode9
    JsonRpcErrorCode10:
      type: string
      enum:
        - '-32700'
      title: JsonRpcErrorCode10
    JsonRpcErrorCode:
      oneOf:
        - $ref: '#/components/schemas/JsonRpcErrorCode0'
        - $ref: '#/components/schemas/JsonRpcErrorCode1'
        - $ref: '#/components/schemas/JsonRpcErrorCode2'
        - $ref: '#/components/schemas/JsonRpcErrorCode3'
        - $ref: '#/components/schemas/JsonRpcErrorCode4'
        - $ref: '#/components/schemas/JsonRpcErrorCode5'
        - $ref: '#/components/schemas/JsonRpcErrorCode6'
        - $ref: '#/components/schemas/JsonRpcErrorCode7'
        - $ref: '#/components/schemas/JsonRpcErrorCode8'
        - $ref: '#/components/schemas/JsonRpcErrorCode9'
        - $ref: '#/components/schemas/JsonRpcErrorCode10'
      title: JsonRpcErrorCode
    JsonRpcError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/JsonRpcErrorCode'
          description: >-
            The error code — a negative integer identifying the failure. See
            `JsonRpcErrorCode` for the full list of values and meanings.
        message:
          type: string
          description: A human-readable description of what went wrong.
        original_request:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            An echo of the request that failed — the full JSON-RPC frame you
            sent

            (`jsonrpc`, `id`, `method`, `params`). Always present.
        requester_nodeid:
          type: string
          description: >-
            The node that sent the failed request. Present only on some routing
            errors.
        requester_identity:
          type: string
          description: >-
            The identity of the requester. Present only on some routing errors;
            same value as `requester_nodeid`.
        responder_nodeid:
          type: string
          description: >-
            The node that was handling the request. Present only on some routing
            errors.
        responder_identity:
          type: string
          description: >-
            The identity of the responder. Present only on some routing errors;
            same value as `responder_nodeid`.
        last_hop_timeout:
          type: boolean
          description: >-
            `true` when the request timed out on its final hop inside
            SignalWire. Present only on some timeout errors.
      required:
        - code
        - message
        - original_request
      description: >-
        A JSON-RPC 2.0 error object, delivered on the `error` field of a
        `JsonRpcResponse` when

        a request fails at the protocol level (bad version, authentication,
        scope, params, or

        your project's connection limit). It replaces `result` — a frame carries
        one or the other, never both.
      title: JsonRpcError
    call.member.list_callMemberListResponse:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallMemberListMessagesCallMemberListResponseJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: The id of the request this responds to.
        result:
          $ref: '#/components/schemas/Fabric.FabricMemberListResult'
          description: The method result. Present when the request succeeded.
        error:
          $ref: '#/components/schemas/JsonRpcError'
          description: >-
            Present instead of `result` when the request failed at the protocol
            level.
      required:
        - jsonrpc
        - id
      description: >-
        A JSON-RPC response frame correlated to a request by `id`. On success
        the frame carries

        `result` (the method result). If the request fails at the protocol level
        — an

        incompatible version, failed authentication, insufficient scope, invalid
        params, or your

        project's connection limit — the frame carries `error` instead of
        `result`. Many

        method-level failures (for example most Calling failures) are reported
        the other way: a

        normal `result` whose own `code` is not `"200"`. Each method documents
        which form its

        failures take.


        An `error` returned for `signalwire.connect` is followed by the service
        closing the

        WebSocket; open a new connection to try again. The same happens when

        `signalwire.reauthenticate` sends credentials that are rejected, except
        for a

        Subscriber Access Token. Errors on any other request leave the
        connection open.
      title: call.member.list_callMemberListResponse
    ChannelsCallMemberListMessagesCallMemberListRequestJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallMemberListMessagesCallMemberListRequestJsonrpc
    ChannelsCallMemberListMessagesCallMemberListRequestMethod:
      type: string
      enum:
        - call.member.list
      description: The name of the JSON-RPC method being invoked.
      title: ChannelsCallMemberListMessagesCallMemberListRequestMethod
    Fabric.Target:
      type: object
      properties:
        node_id:
          type: string
          description: The node the target's call leg lives on.
        call_id:
          type: string
          description: The call ID the target was created through.
        member_id:
          type: string
          description: >-
            The member ID of the target. Equals `call_id` for a call leg that is
            not in a conference.
      required:
        - node_id
        - call_id
        - member_id
      description: >-
        Addresses a call leg in a Call Fabric session. Call Fabric identifies
        legs explicitly

        with `{node_id, call_id, member_id}`. Capture these from your
        `call.state` and member

        events and echo them back on later requests.
      title: Fabric.Target
    Fabric.MemberListParams:
      type: object
      properties:
        self:
          $ref: '#/components/schemas/Fabric.Target'
          description: The call leg you're operating from — your own leg on this call.
        target:
          $ref: '#/components/schemas/Fabric.Target'
          description: >-
            The call leg addressing the room whose members to list — required.
            Normally set `target` equal to `self`.
      required:
        - self
        - target
      description: Parameters for `call.member.list`.
      title: Fabric.MemberListParams
    call.member.list_callMemberListRequest:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsCallMemberListMessagesCallMemberListRequestJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: Request id, echoed on the correlated response.
        method:
          $ref: >-
            #/components/schemas/ChannelsCallMemberListMessagesCallMemberListRequestMethod
          description: The name of the JSON-RPC method being invoked.
        params:
          $ref: '#/components/schemas/Fabric.MemberListParams'
          description: The method's input parameters.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        A JSON-RPC request frame. `Method` is the method name; `Params` is the
        method's input.
      title: call.member.list_callMemberListRequest

```