YM REST Services

<back to all web services

EventVirtualUsers

Requires Authentication
Requires any of the roles:admin, oauthadmin
The following routes are available for this service:
GET/Ams/{ClientID}/Event/{EventId}/VirtualUsers/{UserEmail}Return the details for a virtual user.
EventVirtualUsers Parameters:
NameParameterData TypeRequiredDescription
EventIdpathintNo
UserEmailpathstringNo
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
EventVirtualUsersResponse Parameters:
NameParameterData TypeRequiredDescription
UserformUserNo
UserSettingsformUserSettingsNo
User Parameters:
NameParameterData TypeRequiredDescription
IdformstringNo
FirstNameformstringNo
LastNameformstringNo
EmailformstringNo
TypeformUserPlanTypeNo
PmiformlongNo
TimeZoneformstringNo
VerifiedformintNo
DepartmentformstringNo
CreatedAtformDateTimeNo
LastLoginTimeformDateTimeNo
PictureURLformstringNo
AccountIDformstringNo
AccountNumberformlongNo
StatusformUserStatusNo
UserSettings Parameters:
NameParameterData TypeRequiredDescription
ScheduleMeetingformUserSettingsScheduleMeetingNo
FeatureformUserSettingsFeatureNo
UserSettingsScheduleMeeting Parameters:
NameParameterData TypeRequiredDescription
HostVideoformboolNo
ParticipantsVideoformboolNo
AudioTypeformMeetingAudioTypeNo
JoinBeforeHostformboolNo
ForcePersonalMeetingIDJoinBeforeHostPasswordformboolNo
GenerateRequirePasscodeForParticipantsByPhoneformboolNo
UsePersonalMeetingIDWhenSchedulingMeetingformboolNo
UsePersonalMeetingIDWhenStartingInstantMeetingformboolNo
RequirePasscodeForSchedulingNewMeetingsformboolNo
RequirePasswordForScheduledMeetingsformboolNo
DefaultPasswordForScheduledMeetingsformstringNo
RequirePasswordForInstantMeetingsformboolNo
RequirePasswordForPersonalMeetingIDMeetingsformRequirePasswordForPMIMeetingsTypeNo
PersonalMeetingIDPasswordformstringNo
EmbedPasswordInJoinLinkformboolNo
PersonalMeetingformboolNo
UserSettingsFeature Parameters:
NameParameterData TypeRequiredDescription
MeetingCapacityformintNo
LargeMeetingformboolNo
large_meeting_capacityformintNo
WebinarformboolNo
WebinarCapacityformintNo
ChinaMeetingformboolNo
IndiaMeetingformboolNo
ZoomPhoneformboolNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /Ams/{ClientID}/Event/{EventId}/VirtualUsers/{UserEmail} HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/csv
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"User":{"Id":"String","FirstName":"String","LastName":"String","Email":"String","Type":"Basic","Pmi":0,"TimeZone":"String","Verified":0,"Department":"String","CreatedAt":"0001-01-01T00:00:00.0000000","LastLoginTime":"0001-01-01T00:00:00.0000000","PictureURL":"String","AccountID":"String","AccountNumber":0,"Status":"Active"},"UserSettings":{"ScheduleMeeting":{"HostVideo":false,"ParticipantsVideo":false,"AudioType":"TelephonyAndVoIP","JoinBeforeHost":false,"ForcePersonalMeetingIDJoinBeforeHostPassword":false,"GenerateRequirePasscodeForParticipantsByPhone":false,"UsePersonalMeetingIDWhenSchedulingMeeting":false,"UsePersonalMeetingIDWhenStartingInstantMeeting":false,"RequirePasscodeForSchedulingNewMeetings":false,"RequirePasswordForScheduledMeetings":false,"DefaultPasswordForScheduledMeetings":"String","RequirePasswordForInstantMeetings":false,"RequirePasswordForPersonalMeetingIDMeetings":"OnlyMeetingsWithJoinBeforeHostEnabled","PersonalMeetingIDPassword":"String","EmbedPasswordInJoinLink":false,"PersonalMeeting":false},"Feature":{"MeetingCapacity":0,"LargeMeeting":false,"large_meeting_capacity":0,"Webinar":false,"WebinarCapacity":0,"ChinaMeeting":false,"IndiaMeeting":false,"ZoomPhone":false}},"EventId":0,"UserEmail":"String","MemberID":0,"ClientID":0,"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}},"BypassCache":false,"DateCached":"2024-05-03T08:47:28.1769653-04:00","Device":"Desktop"}