---
title: "List members of a conversation"
method: GET
path: "/conversations/{convId}/members"
tags: ["conversations"]
---

# List members of a conversation

`GET /conversations/{convId}/members`

Returns all members of a specific conversation.

**Permission:** `Conversations Read` required.

**Monitoring:** Optional. With Monitoring OFF, you can only list members of your own conversations. With Monitoring ON, you can list members of any conversation within your supervision scope.

## Path parameters

- `convId` integer, required

## Response `200`

Successful operation — the member list is returned.

- MemberList
  - `conversation_id` integer
  - `list_member` Member[], nullable — This field is used when the flag marged is turn on
    - `conversation_user_id` integer
    - `user` MemberRingover
      - `user_id` integer
      - `initial` string
      - `color` string
      - `firstname` string
      - `lastname` string
      - `company` string
      - `concat_name` string
      - `email` string
      - `picture` string
      - `is_sms_write` boolean — is not displayed if the user does not have the `is_sms_write` right
      - `is_administrator` boolean — is not displayed if the user is not an administrator
    - `ivr` MemberIvr
      - `id` integer
      - `name` string
      - `scenario_id` integer
      - `color` string
    - `group` object — Can be `null` (mutually exclusive with ivr and group)
      - `id` integer — The identifier of the group
      - `name` string — The name of the group
      - `color` string
    - `alphanumeric` string, nullable — Can be `null` if the `number` is filled
    - `number` FormatNumber
      - `raw` integer
      - `country_code` string
      - `country` string
      - `e164` string
      - `international` string
      - `international_alt` string
      - `national` string
      - `national_alt` string
      - `rfc3966` string
      - `is_short_code` boolean
    - `contact` Contact
      - `contact_id` integer
      - `is_shared` boolean
      - `im_owner` string
      - `social_service` string, nullable
      - `social_service_id` string
      - `social_profile_url` string, nullable
      - `social_data` string, nullable
      - `firstname` string
      - `lastname` string
      - `company` string
      - `concat_name` string
      - `color` string
      - `initial` string
      - `profile_picture` string, nullable
      - `creation_date` string, date-time
      - `numbers` integer[], nullable
    - `picture` string, nullable
    - `is_administrator` boolean
  - `list_member_count` integer, nullable
  - `list_internal_member` Member[], nullable — This field is used when the flag marged is turn off
    - `conversation_user_id` integer
    - `user` MemberRingover
      - `user_id` integer
      - `initial` string
      - `color` string
      - `firstname` string
      - `lastname` string
      - `company` string
      - `concat_name` string
      - `email` string
      - `picture` string
      - `is_sms_write` boolean — is not displayed if the user does not have the `is_sms_write` right
      - `is_administrator` boolean — is not displayed if the user is not an administrator
    - `ivr` MemberIvr
      - `id` integer
      - `name` string
      - `scenario_id` integer
      - `color` string
    - `group` object — Can be `null` (mutually exclusive with ivr and group)
      - `id` integer — The identifier of the group
      - `name` string — The name of the group
      - `color` string
    - `alphanumeric` string, nullable — Can be `null` if the `number` is filled
    - `number` FormatNumber
      - `raw` integer
      - `country_code` string
      - `country` string
      - `e164` string
      - `international` string
      - `international_alt` string
      - `national` string
      - `national_alt` string
      - `rfc3966` string
      - `is_short_code` boolean
    - `contact` Contact
      - `contact_id` integer
      - `is_shared` boolean
      - `im_owner` string
      - `social_service` string, nullable
      - `social_service_id` string
      - `social_profile_url` string, nullable
      - `social_data` string, nullable
      - `firstname` string
      - `lastname` string
      - `company` string
      - `concat_name` string
      - `color` string
      - `initial` string
      - `profile_picture` string, nullable
      - `creation_date` string, date-time
      - `numbers` integer[], nullable
    - `picture` string, nullable
    - `is_administrator` boolean
  - `list_internal_member_count` integer, nullable
  - `list_external_member` Member[], nullable — This field is used when the flag marged is turn off
    - `conversation_user_id` integer
    - `user` MemberRingover
      - `user_id` integer
      - `initial` string
      - `color` string
      - `firstname` string
      - `lastname` string
      - `company` string
      - `concat_name` string
      - `email` string
      - `picture` string
      - `is_sms_write` boolean — is not displayed if the user does not have the `is_sms_write` right
      - `is_administrator` boolean — is not displayed if the user is not an administrator
    - `ivr` MemberIvr
      - `id` integer
      - `name` string
      - `scenario_id` integer
      - `color` string
    - `group` object — Can be `null` (mutually exclusive with ivr and group)
      - `id` integer — The identifier of the group
      - `name` string — The name of the group
      - `color` string
    - `alphanumeric` string, nullable — Can be `null` if the `number` is filled
    - `number` FormatNumber
      - `raw` integer
      - `country_code` string
      - `country` string
      - `e164` string
      - `international` string
      - `international_alt` string
      - `national` string
      - `national_alt` string
      - `rfc3966` string
      - `is_short_code` boolean
    - `contact` Contact
      - `contact_id` integer
      - `is_shared` boolean
      - `im_owner` string
      - `social_service` string, nullable
      - `social_service_id` string
      - `social_profile_url` string, nullable
      - `social_data` string, nullable
      - `firstname` string
      - `lastname` string
      - `company` string
      - `concat_name` string
      - `color` string
      - `initial` string
      - `profile_picture` string, nullable
      - `creation_date` string, date-time
      - `numbers` integer[], nullable
    - `picture` string, nullable
    - `is_administrator` boolean
  - `list_external_member_count` integer, nullable

## Other responses

- `204` — No members found — the conversation has no participants.
- `400` — Invalid conversation ID format.
- `401` — Unauthorized — missing or invalid API token, or missing `Conversations Read` permission.
- `404` — Conversation not found — no conversation matches the provided ID.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)