conversations

List conversations

Changed on Nov 20, 2025

Returns the first 100 available conversations by default. Use limit_offset and limit_count to paginate: the first X conversations are skipped and the following Y are returned.

Permission: Conversations Read required.

Monitoring: Optional. With Monitoring OFF, only your own conversations are returned. With Monitoring ON, you can see all team conversations (subject to your supervision scope). Supervisors see conversations of supervised users; admins see all.

get/conversations

Request

Base URL
https://public-api.ringover.com/v2
URL
https://public-api.ringover.com/v2/conversations
Auth
API key in header Authorization

Query parameters

filterstring[]

Type of conversation

[
  "ALL"
]

limit_countinteger

Example:100

Maximum number of results to return per page. Default: server-defined.

limit_offsetinteger

Number of elements that will be ignored

Response

Successful operation — the conversation list is returned.

team_idinteger

user_idinteger

filter'ALL' | 'INTERNAL' | 'EXTERNAL' | 'COLLABORATIVE'

limit_offset_settedinteger

limit_count_settedinteger

total_conversation_countinteger

conversation_list_countinteger

Example response

{
  "team_id": 123456,
  "user_id": 654321,
  "filter": "ALL",
  "limit_count_setted": 1,
  "total_conversation_count": 8,
  "conversation_list": [
    {
      "conversation_id": 222111,
      "type": "INTERNAL",
      "tags": [
        "tag1",
        "tag2"
      ],
      "star": [
        "STAR1"
      ],
      "name": "My favorite conversation",
      "purpose": "Description of my favorite conversation",
      "user_list": {
        "user_id": 123456,
        "initial": "PM",
        "color": "3CC8C8",
        "firstname": "Pauline",
        "lastname": "Martin",
        "company": "Ringover",
        "concat_name": "Pauline Martin",
        "email": "pauline.martin@ringover.com",
        "picture": "https://cdn77.ringover.com/img/users/default.jpg"
      },
      "internal": [
        {
          "user": {
            "user_id": 654321,
            "initial": "JD",
            "color": "3CC8C8",
            "firstname": "John",
            "lastname": "Doe",
            "company": "MyCompany",
            "concat_name": "John Doe",
            "email": "myemail@domain.com",
            "picture": "https://my.image.com/default.jpg",
            "is_sms_write": true,
            "is_administrator": true
          },
          "ivr": {
            "id": 657657,
            "name": "MyIVR",
            "scenario_id": 777777,
            "color": "FFD54F"
          },
          "group": {
            "id": 999999,
            "name": "myIVR",
            "color": "FFD54F"
          },
          "number": {
            "raw": 184800000,
            "country_code": "33",
            "country": "FR",
            "e164": "+33184800000",
            "international": "+33 1 84 80 00 00",
            "international_alt": "33184800000",
            "national": "01 84 80 00 00",
            "national_alt": "0184800000",
            "rfc3966": "tel:+33-1-84-80-00-00"
          },
          "contact": {
            "contact_id": 654321,
            "is_shared": true,
            "social_service_id": "00P7U000015Ei75YBX",
            "firstname": "John",
            "lastname": "Do",
            "company": "DoeCompany",
            "concat_name": "John Doe",
            "color": "3CC8C8",
            "initial": "JD",
            "creation_date": "2018-08-12T12:12:40.53Z",
            "numbers": [
              331797500010
            ]
          },
          "picture": "https://my.image.com/default.jpg"
        }
      ],
      "external": [
        {
          "user": {
            "user_id": 654321,
            "initial": "JD",
            "color": "3CC8C8",
            "firstname": "John",
            "lastname": "Doe",
            "company": "MyCompany",
            "concat_name": "John Doe",
            "email": "myemail@domain.com",
            "picture": "https://my.image.com/default.jpg",
            "is_sms_write": true,
            "is_administrator": true
          },
          "ivr": {
            "id": 657657,
            "name": "MyIVR",
            "scenario_id": 777777,
            "color": "FFD54F"
          },
          "group": {
            "id": 999999,
            "name": "myIVR",
            "color": "FFD54F"
          },
          "number": {
            "raw": 184800000,
            "country_code": "33",
            "country": "FR",
            "e164": "+33184800000",
            "international": "+33 1 84 80 00 00",
            "international_alt": "33184800000",
            "national": "01 84 80 00 00",
            "national_alt": "0184800000",
            "rfc3966": "tel:+33-1-84-80-00-00"
          },
          "contact": {
            "contact_id": 654321,
            "is_shared": true,
            "social_service_id": "00P7U000015Ei75YBX",
            "firstname": "John",
            "lastname": "Do",
            "company": "DoeCompany",
            "concat_name": "John Doe",
            "color": "3CC8C8",
            "initial": "JD",
            "creation_date": "2018-08-12T12:12:40.53Z",
            "numbers": [
              331797500010
            ]
          },
          "picture": "https://my.image.com/default.jpg"
        }
      ],
      "last_message": {
        "message_id": 11223344,
        "user": {
          "user_id": 123456,
          "team_id": 123456,
          "initial": "PM",
          "color": "3CC8C8",
          "firstname": "Pauline",
          "lastname": "Martin",
          "company": "Ringover",
          "email": "pauline.martin@ringover.com",
          "picture": "https://cdn77.ringover.com/img/users/default.jpg",
          "concat_name": "Pauline Martin"
        },
        "contact": {
          "contact_id": 654321,
          "is_shared": true,
          "social_service_id": "00P7U000015Ei75YBX",
          "firstname": "John",
          "lastname": "Do",
          "company": "DoeCompany",
          "concat_name": "John Doe",
          "color": "3CC8C8",
          "initial": "JD",
          "creation_date": "2018-08-12T12:12:40.53Z",
          "numbers": [
            331797500010
          ]
        },
        "number": {
          "raw": 184800000,
          "country_code": "33",
          "country": "FR",
          "e164": "+33184800000",
          "international": "+33 1 84 80 00 00",
          "international_alt": "33184800000",
          "national": "01 84 80 00 00",
          "national_alt": "0184800000",
          "rfc3966": "tel:+33-1-84-80-00-00"
        },
        "buffer": "Hello World",
        "direction": "IN",
        "archive_date": "2019-03-11T12:20:50.52Z",
        "creation_date": "2018-12-21T12:20:50.52Z",
        "update_date": "2018-12-21T12:20:50.52Z"
      },
      "total_messages_count": 8,
      "creation_date": "2018-06-12T23:23:40.99Z",
      "update_date": "2019-02-12T12:20:50.52Z"
    }
  ],
  "conversation_list_count": 1
}

Changes

Nov 20, 2025d92d55716cc3 Revision changes
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the // response's property format changed from date to date-time for status
- breaking
  the ///// response's property format changed from date to date-time for status
- breaking
  the ///// response's property format changed from date to date-time for status
- breaking
  the /// response's property format changed from date to date-time for status
- breaking
  the //// response's property format changed from date to date-time for status
- breaking
  the /// response's property format changed from date to date-time for status
- breaking
  the // response's property format changed from date to date-time for status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- info
  api operation id getConversations was added
- info
  added the optional property //// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history