Table of Contents

API : Flexcare : Videochat : List rooms

Introduction

This will list rooms based on customer and date, from and to

Request

URL https://api.telecomx.dk/flexcare/videochat/meetings
Method GET
Access level RESELLER, ADMIN
Query customer Customer id.
dateFrom Date from, defaults to today
dateTo Date to, defaults to today

Query example

https://api.telecomx,dk/flexcare/videochat/meetings?customer=12345678901234567890ABCD&dateForm=2025-11-01&dateTo=2025-11-03

Response

JSON object
_id ObjecId Unique id of the Conference
customer  ObjectId  Unique id of the customer
employee  ObjectId  Unique id of the employee who created conference in telecomx platform
uri String Uri to identify meeting, created by Medcom
pin String Pin to access conference, created by Medcom
desktopLink String  Link for desktop devices, created by Medcom
clinicalLink  String Link for clinic devices, created by Medcom
mobileLink String  Link for mobile devices, created by Medcom
state String State of conference: CREATED, STARTED, CLOSED
created Date(ISO) Date of when conference is created
devices Array List of IptvDevices added to thie conference
devices[]._id  ObjectId  Unique id of the device
devices[].technicalRoomNumber  String  Room number, location
devices[].serial String Serial number of the device
devices[].name String Name of device
devices[].deviceId String Id generated by the device
settings Object Current readonly data about the device.
devices[].settings.medcomUri String Url wich telecomx platform can communicate with medcom platform
devices[].settings.cameraOn Boolean If camera is set to on or off at the start of each meeting
devices[].settings.microphoneOn Boolean If micrphone is set to on or off at the start of each meeting
devices[].settings.setVolume Boolean If tablet should set volume niveu before each meeting
devices[].settings.addParticipant Boolean Adds a option to add participants to meeting by email or sms, this is done trough Medcom platform
devices[].settings.volume Number Sets the tablet volume before each meeting
devices[].settings.quality String Sets the meeting quality to: LOW, MEDIUM, HIGH, VERY_HIGH
commands Array List of commands send to device during a meeting
devices[].commands[]._id  ObjectId  Name of product
devices[].commands[].type  String  Type of command: START_MEETING, START_MEETING, CAMERA_ON, MICROPHONE_ON, SET_QUALITY, SET_VOLUME, HANGUP,
devices[].commands[].volume Number Sets the volume niveu
devices[].commands[].value Boolean If type is either MICROPHON_ON or CAMERA_ON, it turns on or off the camera or microphone based on the value
devices[].commands[].quality String Sets the meeting quality to: LOW, MEDIUM, HIGH, VERY_HIGH
devices[].commands[].fetched Boolean Indicates if android device has fetched the command
devices[].commands[].executed Boolean Indicates if android device has executed the command

Example

[
  {
    _id: ObjectId('1234567890123457890CCCC'),
    subject: 'Årlig sundheds check',
    description: 'Gennemgang af patient forløb',
    startTime: '2025-11-04T10:40:23.223+00:00',
    endTime: '2025-11-04T11:40:23.223+00:00',
    externalId: '88f73951-70a6-47f6-be21-d0be415db9e0',
    uuid: 'c6c5365a-2b3c-44ec-82d6-69cdaef8fbbc',
    customer: ObjectId('1234567890123457890CCCC'),
    uri: 'test@rooms.dk',
    pin: '1234',
    desktopLink: 'https://s.test.dias.rm.dk/QcT',
    clinicalLink: 'https://rooms.dk/webapp/?conference=test@rooms.dk&pin=1234&name=Patient',
    mobileLink: 'https://s.test.dias.rm.dk/YuP',
    state: 'CREATED',
    created: ISODate('2016-01-01T00:00:00.000Z'),
    startTimeMedcom: '2025-11-04T10:40:23 +00:00',
    endTimeMedcom: '2025-11-04T11:40:23 +00:00',
    guestDesktopLink: 'https://portal.vconf.dk/?url=test@rooms.dkk&pin=1234',
    hostDesktopLink; 'https://portal.vconf.dk/?url=test@rooms.dk&pin=1234',
    clinicalLink: '',
    mobilLink: 'https://m.vconf.dk/bb4418ce6323',
    participants: [
        {
            type: 'SMS',
            value: '+4545454545',
            reference: '1234567890123457890CCCC',
            smsStatus: 'Delivered'
        }
    ],
    devices: [
        {
            _id: ObjectId('1234567890123457890CCCC'),
            serial: 'FLXCA1700937',
            name: 'Test',
            deviceId: '1700937',
            settings: {
                 medcomUri: 'https://rooms.dk',
                 cameraOn: false,
                 microphoneOn: true,
                 setVolume: true,
                 addParticipant: false,
                 volume: 80,
                 quality: 'HIGH'
            }
        }
    ]
  }
]

Errors

Error code Message Description
403 token Access denied
404 customer Customer not found
422 Invalid data Data is not valid in query
500 internal_error <Unspecified>