API : Flexcare : Videochat : Get room

Introduction

This endpoint gets a conference room from a device

Request

URL	https://api.telecomx.dk/flexcare/videochat/device/meeting/DEVICE_ID
Method	GET
Access level	RESELLER, ADMIN
Params	DEVICE_ID	String	Id the device

Query example

https://api.telecomx.dk/flexcare/videochat/device/meeting/1700937

Response

JSON object
meeting	Object	The room object
meeting._id	ObjectId	Unique id of a setting.
meeting.customer	ObjectId	Id of the customer.
meeting.subject	String	Medcom, room subject.
meeting.startTime	Date	Start date and time of room.
meeting.endTime	Date	End date and time of room..
meeting.description	String	Medcom, room description.
meeting.uuid	String	Medcom, Uniq id of a room.
meeting.externalId	String	Medcom, Uniq external id of a room.
meeting.created	Date	Date when room is created in TCX.
meeting.startTimeMedcom	String	Medcom, Start time and date formatted to meet medcom requirments.
meeting.endTimeMedcom	String	Medcom, End time and date formatted to meet medcom requirments.
meeting.clinicalLink	String	Medcom, Link created by medcom for applications they have.
meeting.guestDesktopLink	String	Medcom, weblink for guests.
meeting.hostDesktopLink	String	Medcom, weblink for hosts.
meeting.mobilLink	String	Medcom, weblink for mobile devices.
meeting.uri	String	Medcom, room link for tablets.
meeting.pin	String	Medcom, pin to access the room.
meeting.state	String	Medcom, State of room CREATED, STARTED CLOSED, PROVISION_PROBLEMS PROVISIONED_OK, STARTING_TO_DEPROVISION or DEPROVISION_PROBLEMS.
meeting.meetingSetting	ObjectId	Setting id.
meeting.participants	Array	List of participants
meeting.participants [].type	String	Type of invite SMS or EMAIL.
meeting.participants [].value	String	Number to send sms to or email to mail to.
meeting.participants [].reference	String	Sms only, reference number of the sms.
meeting.participants [].smsStatus	String	Status of the sms.
meeting.devices	Array	List of tablets.
meeting.devices []._id	ObjectId	Tablet id.
meeting.devices [].name	String	Tablet name.
meeting.devices [].serial	String	Tablet serial number.
meeting.devices [].deviceId	String	Tablet device id.

Example

{
    meeting: {
       _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	device	Device not found
404	customer	Customer not found
404	meeting	Meeting not found
422	Invalid data	Data is not valid in query
500	internal_error	<Unspecified>

WIKI

Table of Contents

API : Flexcare : Videochat : Get room

Introduction

Request

Query example

Response

Example

Errors