Skip to main content

GetUser (v1,v2)

July 21, 2025

This API can be used to retrieve the information of a backup user.

The settings can be found on the AhsayCBS web console at:

  • Backup / Restore > Users, Groups & Policies > Backup User > %User Name%

 

v1 GetUser.do


URL

https://CBS.EXAMPLE.COM/obs/api/json/GetUser.do

Deprecated Since Version: 7.15.6.38

 

v2 GetUser.do


URL

https://CBS.EXAMPLE.COM/obs/api/json/2/GetUser.do

Available Since Version: 9.7

Parameters

Key Type Description
SysUser String Username of an AhsayCBS System User with Admin or API role.
SysPwd String Password matching SysUser.
LoginName String Backup user name.
Owner String Owner of the backup user (if applicable).
Return Values
Key Type Description
Status String "OK" or "Error"
Data JSON Object Details of the user.
Message String Error message, it only appears if status displays "Error".
ExptType String The type of exception, will only be displayed if the status is "Error".
JSON Objects

User

Key Type Description
AccessToken String Client API token that is used by OBC, should have no use to customers.
AdGroup String Legacy v6 Advertisement group (not used by AhsayCBS).
AdGroups Array Legacy v6 Advertisement groups (not used by AhsayCBS).
Alias String Display name.
BackupSetIdList Array ID number of each backup set.
Bandwidth Long v6 bandwidth
ClientRunVersion String Version of the backup client used.
ClientType String Type of backup client, either ACB or OBM.
ComputerNameDirList Array Path to the client logs.
ContactList JSON Object See ContactList.
DoubleEncodedName String Gets the double URL encoded name of the backup user.
EmailReportSettings JSON Object See EmailReportSettings.
EncodedName String Encoded name of the backup user.
File String Path to users.xml.
ForgotPasswordSettings JSON Object See ForgotPasswordSettings.
FullName String For legacy v6 backup sets. The value is only set with the value of "LongLoginName" for get profile request received from Backup Client.
GroupPolicySettings JSON Object See GroupPolicySettings.
HashedPassword Boolean Legacy, unused by AhsayCBS.
HomeDir String Path of the User Home.
HostCount Integer Current client host limit in use.
HostInfo JSON Object Number of CPU in client computer of each Run on Client backup set and Owner of each Run on Client backup set.
Hostname String AhsayCBS server host name.
HostQuota Long Client host limit.
HostQuotaEnabled Boolean True / False
HostSet JSON Object See HostSet.
Id Long Millisecond time format.
ImportDate Long Millisecond time format (0c=cnot imported user).
Language String Language used.
LastClientLoginTime Long Time of last login in backup client, in millisecond time format.
LastLoginTime Long Time of last login, in millisecond time format.
LastShowingLicViolationTime Long License violation time.
LastSuccessfulLoginInfo JSON Object Info about the successful login by the user including IP Address, application & time.
LdapSettings JSON Object See LdapSettings.
Locked Boolean True / False
LockedByMFA Boolean Whether account is locked due to too many MFA failure because of wrong passcode.
LongLoginName String If user is owned by Sub-Admin the response will include the Username appended with Sub-Admin ID number (example, JohnDoe#12345).
MailboxUsage Integer Count for Mailbox usage.
ModuleSettings JSON Object See ModuleSettings.
ModulesSettings JSON Object See ModulesSettings.
MoveUserHomeRecord JSON Object Record for moving User Home.
Name String User name.
NewBSetName String Backup set name when Default Backup Set Name policy setting is disabled.
Notes String User notes.
OpenDirectUsageCount Integer Count for OpenDirect usage.
Owner String Owner of the backup user.
Password String Hashed password.
PasswordHistory JSON Object See PasswordHistory.
PreV7 Boolean True / False
ProxySettings JSON Object See ProxySettings.
QuotaList JSON Object (Array) Array list (see QuotaList).
RegistrationDate Long Timestamp of registration date.
RoutineJobsSettings JSON Object See RoutineJobsSettings.
RunDirectQuota Integer Quota for Run Direct.
RunDirectQuotaEnabled Boolean True / False
SavePassword Boolean True / False
SecurityIdentifier String For client to handle Schedule/CDP/Reminder in Windows.
SecuritySettings JSON Object v8.3 SecuritySetting entity of the backup user including the phone list, whether individual MFA is enabled or not, etc.
ServerSettings JSON Object Settings for returning to backup client only.
SoftwareUpdateSettings JSON Object See SoftwareUpdateSettings.
Status String Status of the backup user, either Suspended or Enable.
SuspendPaidUserDate String Suspend date for Paid/Trial user in YYYYMMDD format.
Timezone String Time zone.
TopDir String Path to User Home.
TotalStatistics JSON Object See TotalStatistics.
TrialDays Long Days for trial.
Type String Type of user, either TRIAL or PAID. Default to TRIAL if not specified.
Updated Boolean Whether user was updated in cache but not yet saved to users.xml.
UploadEncryptionKey Boolean True / False
UserHome String Path to the User Home.
UserId String Client user name.
UserLockSettings JSON Object See UserLockSettings.
UserSuspendSettings JSON Object See UserSuspendSettings.
V6File String Path to v6 Profile.xml (regardless if AhsayCBS created user or import).
WindowsEventLogSettings JSON Object See WindowsEventLogSettings.
QuotaType String Type of quota, either TOTAL_QUOTA or PER_DESTINATION_QUOTA.
StorageQuota Long Total quota in GB.
EnableAUA Boolean Enable / disable Auto Update Agent.

QuotaList

Key Type Description
Enabled Boolean True / False
DestinationName String Name of the backup destination.
DestinationKey String ID of the predefined destination or "OBS" for quota on AhsayCBS.
Quota Long Unit in bytes.

ContactList

Key Type Description
Company String Name of the company of the contact.
Email String Email address of the contact.
Address String Address of the contact.
EmailCertificate String Email certificate of the contact.
Website String Website of the contact.
Name String Name of the contact.
Phone1 String Phone number of the contact.
Phone2 String Alternate phone number of the contact.
EncryptEmail Boolean True / False

EmailReportSettings

Key Type Description
SendBkpRpt Boolean True / False
Usage Long Usage statistics.
SmtpAuthUser String SMTP authorized user.
ReportSenderEmail String Email address of the report sender.
SendBkpRptMode String Mode for sending backup reports.
SmtpHostName String Host name of the SMTP.
MissedBkpInterval Long Missed backup intervals.
SmtpPort String Port used for SMTP (e.g.8629).
SendMissedBkpRpt Boolean True / False
SendStorageAlert Boolean True / False
SmtpAuthPwd String Password for SMTP.
Email String Email address.
Enabled Boolean True / False

ForgotPasswordSettings

Key Type Description
RequestTime Long Time requested.
ResetTime Long Time reset.

GroupPolicySettings

Key Type Description
UserGroupIDList Array Assigned User Group(s) ID.
ExcludeNetworkShare Boolean Legacy v6 Policy Group option, not available to update/use in AhsayCBS.
GroupQuota Integer/Long Group quota backups.
UsedGroupQuota Integer/Long Total group quota used.
FileSizeLimit Long Files restricted to specified size.

HostInfo

Key Type Description
Hosts Array Number of CPU socket and host name.

HostSet

Key Type Description
"String":"string" String Contains host name of device installed with client.

LastSuccessfulLoginInfo

Key Type Description
Type String OS and Browser or client type used to login.
PhoneNumber Long Phone number if MFA is used.
IpAddress String IP address used to login.
Time Long Time of last login in millisecond time format.
Id Long Timestamp in millisecond time format (auto-generate).

LdapSettings

Key Type Description
LdapUser Boolean True / False.
LastDeleteTime Long Time last deleted.
LastDisableTime Long Time last disabled.
FirstAuthFailureTime Long Time of first authentication failure.

ModuleSettings

Key Type Description
CDPEnabled Boolean If feature is enabled.
DeduplicationEnabled Boolean If feature is enabled.
DeltaMergeEnabled Boolean If feature is enabled.
InFileDeltaEnabled Boolean If feature is enabled.
LotusDominoBackupEnabled Boolean If feature is enabled.
LotusNotesBackupEnabled Boolean If feature is enabled.
MariaDBBackupEnabled Boolean If feature is enabled.
MobileEnabled Boolean If AhsayMOB is enabled (deprecated v8.5+).
MobileQuota Long Quota value for AhsayMOB (deprecated v8.5+).
MobileV2Enabled Boolean If Ahsay Mobile feature is enabled.
MobileV2Quota Long Value fixed at 10 when MobileV2Enabled=true.
MSExchangeBackupEnabled Boolean If feature is enabled.
MSExchangDAGServerQuota Long Quota value for MS Exchange Server.
MSExchangeMailboxBackupEnabled Boolean If feature is enabled.
MSExMailboxQuota Long Quota value for MS Exchange Mailbox module.
MSHyperVBackupEnabled Boolean If feature is enabled.
MSHyperVVMQuota Long Quota value for Hyper-V.
MSHyperVVMQuotaType String Quota type, either Guest VM or Socket.
MSSQLBackupEnabled Boolean If feature is enabled.
MSWindowsSystemBackupEnabled Boolean If feature is enabled.
MSWindowsSystemStateBackupEnabled Boolean If feature is enabled.
MySQLBackupEnabled Boolean If feature is enabled.
NasClientEnabled Boolean If Synology NAS feature is enabled.
Office365MailEnabled Boolean If feature is enabled.
Office365MailQuota Long Quota value for Microsoft 365 Backup.
OpenDirectEnabled Boolean If feature is enabled.
OpenDirectQuota Long Quota value for OpenDirect. Only works on pre-v9.13 AhsayCBS.
OracleBackupEnabled Boolean If feature is enabled.
PostgreSQLBackupEnabled Boolean If feature is enabled.
QnapEnabled Boolean If QNAP NAS feature is enabled.
ShadowCopyEnabled Boolean If feature is enabled.
ShadowProtectBackupEnabled Boolean If feature is enabled.
VMwareBackupEnabled Boolean If feature is enabled.
VMwareVMQuota Long Quota value for VMware.
VMwareVMQuotaType String Quota type, either Guest VM or Socket.

PasswordHistory

Key Type Description
PasswordLastModifiedTime Long Time password was last modified.
HistoryList Array Array list of password history.

MoveUserHomeRecord

Key Type Description
Dest String Destination User Home path.
StartTime Long Millisecond time format.
Source String Source User Home path.

ProxySettings

Key Type Description
Type String Proxy type.
Username String Proxy username used to login.
Port String Port for the proxy.
Enabled Boolean True / False
Host String Hostname or IP of the proxy.
Password String Password used to login to the proxy.

RoutineJobsSettings

Key Type Description
QuotaRemindPercentage Long Backup quota reminder to user if backup quota is over a certain percentage.
InactiveReportLastSentTime Long Time when last inactive report was sent.

SecuritySettings

Key Type Description
UserLockSettings Object See UserLockSettings.
Id String ID of the user.
LastFailureTime Long Time of last failure.
LockedTime Long Time user has been locked.
LoginFailureCount Long Number of failed logins.
PhoneList Array Array list of registered phones.
Id Long ID of phone.
Verified Boolean True / False
VerifiedTime Long Time phone number was verified.
PhoneNumber Long Phone number.
CountryCode Long Country code of the phone number.
Enable Boolean True / False
SendLimitSettings Object List of setting for sending limit.
LastSendTime Long Time last sent.
SendCount Integer Number of times.
RecoverySettings Object List of settings for recovery
Token String Special key for recovery of user account.
ExpiryTime Long Time limit when token is valid.

TotalStatistics

Key Type Description
RetentionAreaUncompressedSize Long Uncompressed size of Retention Area.
DataAreaFileCount Integer File count of Data Area.
DataAreaUncompressedSize Long Uncompressed size of Data Area.
DataAreaCompressedSize Long Compressed size of Data Area.
RetentionAreaCompressedSize Long Compressed size of Retention Area.
RetentionAreaFileCount Integer File count of Retention Area.
TotalRecycleBinUncompressedSize Long Total uncompressed size all the user's backup sets in recycle bin.
TotalRecycleBinCompressedSize Long Total compressed size all the user's backup sets in recycle bin.
TotalRecycleBinFileCount Long Total file count of all the user's backup sets in recycle bin.

UserLockSettings

Key Type Description
LastFailureTime Long Time of last failure.
LockedTime Long Time user has been locked.
LoginFailureCount Integer Number of failed logins.

UserSuspendSettings

Key Type Description
Enabled Boolean True / False
Date Long Timestamp in millisecond time format.

windowsEventLogSettings

Key Type Description
Enabled Boolean True / False
LogProfile Boolean True / False
LogServices Boolean True / False
LogUtilities Boolean True / False
LogBackup Boolean True / False
LogError Boolean True / False
LogSoftwareUpdate Boolean True / False
LogReport Boolean True / False
LogLoginLogout Boolean True / False
LogInfo Boolean True / False
LogBuy Boolean True / False
LogLicense Boolean True / False
LogWarn Boolean True / False
LogRestore Boolean True / False

ModuleUsage

Key Type Description
MSExMailbox Long Usage of MSExMailbox module license.
MSHyperVVM Long Usage of MSHyperVVM module license.
MSVMwareVM Long Usage of MSVMwareVM module license.
Office365Mail Long Usage of Office365Mail module license.
HostCount Long Usage of OBM / ACB license.
Example

INPUT

{
	"SysUser":"system",
	"SysPwd":"system1",
	"LoginName":"obm2"
}

OUTPUT

{
	"Status":"OK",
	"Data":{
		"Timezone":"1098",
		"ClientRunVersion":"",
		"Owner":"",
		"HostCount":1,
		"SoftwareUpdateSettings":{
			"ReadOnly":false,
			"Enabled":true,
			"Id":""
		},
		"ModuleSettings":{
			"MobileQuota":0,
			"VMwareVMQuotaType":"GUESTVM",
			"VMwareVMQuota":0,
			"MobileEnabled":false,
			"DeltaMergeEnabled":false,
			"MSExchangeMailboxBackupEnabled":false,
			"DeduplicationEnabled":false,
			"MariaDBBackupEnabled":false,
			"OracleBackupEnabled":false,
			"QnapEnabled":false,
			"MSExchangeBackupEnabled":false,
			"OpenDirectEnabled":false,
			"VMwareBackupEnabled":false,
			"InFileDeltaEnabled":false,
			"MSHyperVVMQuota":0,
			"MySQLBackupEnabled":false,
			"MobileV2Quota":0,
			"LotusDominoBackupEnabled":false,
			"OpenDirectQuota":0,
			"MobileV2Enabled":false,
			"ReadOnly":false,
			"Office365MailQuota":0,
			"MSHyperVVMQuotaType":"GUESTVM",
			"NasClientEnabled":false,
			"MSSQLBackupEnabled":false,
			"MSExchangDAGServerQuota":0,
			"ShadoeProtectBackupEnabled":false,
			"MSWindowsSystemStateBackupEnabled":false,
			"MSHyperVBackupEnabled":false,
			"ShadowCopyEnabled":false,
			"LotusNotesBackupEnabled":false,
			"Id":"",
			"Office365MailEnabled":false,
			"CDPEnabled":false,
			"MSExMailboxQuota":0,
			"MSWindowsSystemBackupEnabled":false
		},
		"PasswordHistory":{
			"ReadOnly":false,
			"HistoryList":[],
			"PasswordLastModifiedTime":1687069108460,
			"Id":""
		},
		"RunDirectQuotaEnabled":false,
		"Name":"obm2",
		"AccessToken":"E1C9029954184F92B858280B9A6A3EBAA4F8809CA3E441C198ED5C2DE57918C3",
		"UserHome":"C:\\Program Files\\AhsayCBS\\user\\obm2",
		"LastSuccessfulLoginInfo":null,
		"WindowsEventLogSettings":{
			"ReadOnly":false,
			"LogLoginLogout":false,
			"LogInfo":false,
			"LogLicense":false,
			"Enabled":false,
			"LogUtilities":false,
			"LogError":false,
			"LogServices":false,
			"Id":"",
			"LogSoftwareUpdate":false,
			"LogProfile":false,
			"LogRestore":false,
			"LogBackup":false,
			"LogWarn":false,
			"LogBuy":false,
			"LogReport":false
		},
		"UserSuspendSettings":{
			"ReadOnly":false,
			"Enabled":false,
			"Id":"",
			"Date":0
		},
		"Status":"ENABLE",
		"ReadOnly":false,
		"LockedByMFA":false,
		"OpenDirectUsageCount":0,
		"EncodedName":"obm2",
		"MobileUserID":null,
		"Updated":false,
		"SavePassword":false,
		"BackupSetIdList":[],
		"Hostname":"jcvm.com",
		"MailboxUsage":0,
		"TrialDays":2592000000,
		"DoubleEncodedName":"obm2",
		"LastClientLoginTime":-1,
		"PlanAmount":-1,
		"UploadEncryptionKey":false,
		"GroupPolicySettings":{
			"ReadOnly":false,
			"UserGroupIDList":[-1],
			"ExcludeNetworkShare":false,
			"GroupQuota":0,
			"Id":"",
			"UserGroupQuota":0,
			"FileSizeLimit":0
		},
		"YearPlan":null,
		"LastShowingLicViolationTime":-1,
		"Id":"1687069108461",
		"RunDirectQuota":1,
		"File":"C:\\Program Files\\AhsayCBS\\con\\users.xml",
		"MobileAuthenticationSettings":{
			"Enable":false,
			"LastCountryCode":""
		},
		"ForgotPasswordSettings":{
			"ReadOnly":false,
			"Token":"",
			"RequestTime":-1,
			"Id":"",
			"ResetTime":-1
		},
		"LdapSettings":{
			"ReadOnly":false,
			"LdapUser":false,
			"LastDeleteTime":0,
			"LastDisableTime":0,
			"Id":"",
			"FirstAuthFailureTime":-1
		},
		"TopDir":"C:\\Program Files\\AhsayCBS\\user",
		"EnableAUA":true,
		"ClientType":"OBM",
		"RegistrationDate":1687069108460,
		"QuotaList":[
			{
				"DestinationKey":"OBS",
				"Quota":5368091200,
				"DestinationName":"AhsayCBS",
				"Enabled":true
			},
			{
				"DestinationKey":"-1687068833705",
				"Quota":0,
				"DestinationName":"Local-1",
				"Enabled":false
			},
			{
				"DestinationKey":"-1686815201815",
				"Quota":0,
				"DestinationName":"AhsayCBS-1",
				"Enabled":false
			}
		],
		"ProxySettings":{
			"ReadOnly":false,
			"Type":"",
			"Username":"",
			"Port":"",
			"Enabled":false,
			"Host":"",
			"Id":"",
			"Password":""
		},
		"HostQuotaEnabled":false,
		"AdGroups":[1],
		"ComputerNameDirList":null,
		"SecuritySettings":{
			"UserLockSettings":{
				"LockedTime":-1,
				"LastFailureTime":-1,
				"LoginFailureCount":0
			},
			"PhoneList":[],
			"Enable":false,
			"SendLimitSettings":{
				"LastSendTime":-1,
				"SendCount":0
			},
			"RecoverySettings":{
				"Token":"",
				"ExpiryTime":-1
			}
		},
		"AdGroup":"1",
		"SuspendPaidUserDate":"19700101",
		"MobileBackupSettings":{
			"DeviceList":[]
		},
		"HostSet":{
			"":""
		},
		"Locked":false,
		"CloudbackoGoDriveEnabled":false,
		"Language":"en",
		"ServerSettings":null,
		"HomeDir":"C:\\Program Files\\AhsayCBS\\user\\obm2",
		"Bandwidth":0,
		"StorageQuota":100,
		"class":"com.ahsay.obs.core.cxp.User",
		"HashedPassword":true,
		"SecurityIdentifier":"",
		"Notes":"",
		"Password":"BSJEajFurvvTdkh1V4+1Asgw6wjjIpkgK3rJ00y5S87B0=",
		"RemovingLogs":null,
		"NewBSetName":"BackupSet-0",
		"ImportDate":0,
		"UserLockSettings":{
			"LockedTime":-1,
			"LastFailureTime":-1,
			"LoginFailureCount":0
		},
		"TotalStatistics":{
			"TotalRecycleBinUncompressedSize":0,
			"DataAreaFileCount":0,
			"TotalRestoreCompressedSize":0,
			"TotalRecycleBinFileCount":0,
			"LastBackupCompressedSize":0,
			"DataAreaCompressedSize":0,
			"LastBackupUncompressedSize":0,
			"RetentionAreaFileCount":0,
			"RetentionAreaUncompressedSize":0,
			"DataAreaUncompressedSize":0,
			"TotalUploadCompressedSize":0,
			"LastBackupFileCount":0,
			"TotalUploadFileCount":0,
			"TotalRestoreFileCount":0,
			"TotalRecycleBinCompressedSize":0,
			"RetentionAreaCompressedSize":0
		},
		"QuotaType":"PER_DESTINATION_QUOTA",
		"V6File":"C:\\Program Files\\AhsayCBS\\user\\obm2\\db\\Profile.xml",
		"RoutineJobSettings":{
			"ReadOnly":false,
			"QuotaRemindPercentage":0,
			"Id":"",
			"InactiveReportLastSentTime":-1
		},
		"LongLoginName":"obm2",
		"ContactList":[
			{
				"ReadOnly":false,
				"Company":"",
				"Phone1":"",
				"Email":"obm2@example.com",
				"Address":"",
				"EmailCertificate":"",
				"Phone2":"",
				"EncryptEmail":false,
				"Website":"",
				"Id":"1687069108462",
				"Name":""
			}
		],
		"EmailReportSettings:{
			"SendBkpRpt":false,
			"ReadOnly":false,
			"Usage":0,
			"Email":"",
			"ReportSenderEmail":"",
			"SmtpAuthUser":"",
			"Enabled":false,
			"SendBkpRptMode":"",
			"SmtpHostName":"",
			"MissedBkpInterval":0,
			"SmtpProtocol":"",
			"Id":"",
			"SmtpPort":"",
			"SendMissedBkpRpt":false,
			"SendStorageAlert":false,
			"SmtpAuthPwd":""
		},
		"LastLoginTime":0,
		"Type":"PAID",
		"UsedHostQuota":0,
		"Alias":"",
		"UserId":"obm2",
		"FullName":null,
		"PreV7":false,
		"TrialExpiryDate":0,
		"MoveUserHomeRecord":null,
		"HostQuota":1,
		"HostInfo":""
	}			
}