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 .jsv suffix or ?format=jsv

HTTP + JSV

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/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
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-01,
		LastLoginTime: 0001-01-01,
		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:04:34.4341579-04:00,
	Device: Desktop
}