Skip to main content

GetLicense (v1,v2)

July 21, 2025

This API can be used to collect the license and usage information of your AhsayCBS server.

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

  • System Settings > License > Backup

v1 GetLicense.do 


URL

https://CBS.EXAMPLE.COM/cbs/api/json/GetLicense.do

Available Since Version: 8.3

v2 GetLicense.do 


Since AhsayCBS version 8.3, the following add-on modules are combined into one add-on module, to make these modules that were previously separated, interchangeable:

  • Hyper-V and VMware (per Guest VM)
  • Hyper-V and VMware (per Socket)
  • NAS - Synology and NAS - QNAP
  • AhsayOBM and AhsayACB Microsoft 365

To facilitate such changes, a new version of the GetLicense.do API (v2 GetLicense.do) was introduced with the following parameters:

Key Type Description
VMQuota String Hyper-V or VMware Guest VM quota
UsedVMQuota String Used Hyper-V or VMware Guest VM quota
RemainVMQuota String Available Hyper-V or VMware Guest VM quota
HypervisorSocketQuota String Hyper-V or VMware Socket quota
UsedHypervisorSocketQuota String Used Hyper-V or VMware Socket quota
RemainHypervisorSocketQuota String Available Hyper-V or VMware Socket quota
NasQuota String Synology or QNAP NAS client quota
UsedNasQuota String Used Synology or QNAP NAS client quota
RemainNasQuota String Available Synology or QNAP NAS client quota
Office365Quota String AhsayOBM or AhsayACB Microsoft 365 quota
UsedOffice365Quota String Used AhsayOBM or AhsayACB Microsoft 365 quota
RemainOffice365Quota String Available AhsayOBM or AhsayACB Microsoft 365 quota

For AhsayCBS pre-8.3, you should use the v1 API instead. For all other new versions, use the v2 API to get accurate licensing details.

URL

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

Available Since Version: 9.1

Parameters

Key Type Description
SysUser String Username of an AhsayCBS System User with Admin, API or Read-Only API role.
SysPwd String Password matching SysUser.
Return Values
Key Type Description
Status String "OK" or "Error"
Data ConfigData Contains the particulars of a user's license.
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

Licensing Data

Key Type Description
Key String Product key
Licensee String Licensee name
ProductName String Name of the product, e.g. "Offsite Backup Software, OEM Edition".
Version String Version of the AhsayCBS.
UseProxy Boolean Enable / disable the use of proxy defined in the AhsayCBS to connect to the internet.
LicTypeName String Name of license type.
MaxObmUsers String Maximu number of AhsayOBM user CALs.
UsedObmQuota String Used AhsayOBM user CALs.
RemainObmQuota String Remaining AhsayOBM user CALs.
ExpiryDate String Expiry date of the license key.
SupExpDate String Expiry date of the software support.
MaxQuota String Maximum backup quota of a user.
Ip String The IP address of AhsayCBS registered.
Port String The connection port of AhsayCBS registered.
Mac String The MAC address of the network card that AhsayCBS registered.
MaxUsers String Maximum number of users allowed.
AcbClientEnabled Boolean Enable / disable the use of the AhsayACB client module.
DagUseObm String Used AhsayOBM CALs due to DAG usage.
AcbUseObm String Used AhsayOBM CALs due to no AhsayACB CALs.
EnableReplication Boolean Enable / disable the use of the replication module.
EnableMSExchangeMailbox Boolean Enable / disable the use of the Exchange Mailbox module.
ExchangeMailboxQuota String Exchange Mailbox quota.
UsedExchangeMailboxQuota String Used Exchange Mailbox quota.
RemainExchangeMailboxQuota String Remaining Exchange Mailbox quota.
VMQuota String Hyper-V / VMware (Per Guest VM) quota.
UsedVMQuota String Used Hyper-V / VMware (Per Guest VM) quota.
RemainVMQuota String Remaining Hyper-V / VMware (Per Guest VM) quota.
HypervisorSocketQuota String Hyper-V / VMware (Per Socket) quota.
Used HypervisorSocketQuota String Used Hyper-V / VMware (Per Socket) quota.
RemainHypervisorSocketQuota String Remaining Hyper-V / VMware (Per Socket) quota.
EnableMobile Boolean Enable / disable the use of Ahsay Mobile.
MobileQuota String AhsayMOB quota.
UsedMobileQuota String Used AhsayMOB quota.
RemainMobileQuota String Remaining AhsayMOB quota.
Office365Quota String AhsayACB / AhsayOBM Microsoft 365 quota.
UsedOffice365Quota String Used AhsayACB / AhsayOBM Microsoft 365 quota.
RemainOffice365Quota String Remaining AhsayACB / AhsayOBM Microsoft 365 quota.
OpenDirectQuota String Granular Restore / OpenDirect quota. Only works on pre-v9.13 AhsayCBS.
UsedOpenDirectQuota String Used Granular Restore / OpenDirect quota. Only works on pre-v9.13 AhsayCBS.
RemainOpenDirectQuota String Remaining Granular Restore / OpenDirect quota. Only works on pre-v9.13 AhsayCBS.
NasQuota String Synology / QNAP - NAS client quota.
UsedNasQuota String Used Synology / QNAP - NAS client quota.
RemainNasQuota String Remaining Synology / QNAP - NAS clien quota.
Deactivated Boolean Disable / enable license key.
EnableNasServer Boolean Enable / disable the NAS server module.
EnableUbs Boolean Enable / disable the AhsayUBS module.
EnableHa Boolean Enable / disable the HA module.
MobileQuotaV2 String Ahsay Mobile backup quota.
UsedMobileV2Quota String Used Ahsay Mobile backup quota.
RemainMobileV2Quota String Remaining Ahsay Mobile backup quota.
Example

INPUT

{
	"SysUser":"api_user",
	"SysPwd":"qWeRtY123456!@#$%"
}

OUTPUT

{
	"Status":"OK",
	"Data":{
		"MobileQuota":"2000",
		"HypervisorSocketQuota":"4000",
		"ExpiryDate":"12/31/2024",
		"RemainMobileV2Quota":"32980",
		"ProductName":"Ahsay Cloud Backup Suite",
		"MaxUsers":"7100",
		"Port":"8081",
		"RemainVMQuota":"22000",
		"LicenseFile":"",
		"RemainObmQuota":"5099",
		"Version":"9.5.4.0",
		"NasQuota":"2010",
		"EnableCbs":true,
		"UsedNasQuota":"2",
		"Licensee":"EvaluationOnly",
		"RemainMobileQuota":"2000",
		"RemainOffice365Quota":"4000",
		"UsedObmQuota":"1",
		"UsedAcbRepQuota":0,
		"RemainAcbRepQuota":2000,
		"MaxObmUsers":"5100",
		"RemainOpenDirectQuota":"2000",
		"EnableUbs":true,
		"Mac":"08-00-27-72-37-A8",
		"RemainAcbQuota":"1999",
		"AcbRepQuota":2000,
		"UsedMobileQuota":"0",
		"RemainNasQuota":"2008",
		"UsedMobileV2Quota":"20",
		"RemainExchangeMailboxQuota":"2000",
		"RemainHypervisorSocketQuota":"4000",
		"Key":"62pMG-YPD6I-3ggaG-b5MCT-XX",
		"EnableHa":false,
		"ObmRepQuota":5100,
		"Description":"",
		"Ip":"127.0.0.1",
		"MaxAcbUsers":"2000",
		"UsedHypervisorSocketQuota":"0",
		"DagUseObm":"0",
		"UsedVMQuota":"0",
		"MobileQuotaV2":"33000",
		"AcbUseObm":"0",
		"UsedExchangeMailboxQuota":"0",
		"RemainObmRepQuota":5100,
		"UsedAcbQuota":"1",
		"OpenDirectQuota":"2000",
		"LicType":4,
		"UseProxy":false,
		"SupExpDate":"12/31/2024",
		"LicTypeName":"OEM License",
		"VMQuota":"22000",
		"Office365Quota":"4000",
		"AcbUseObmRep":0,
		"BrandedProductName":"",
		"UsedOffice365Quota":"0",
		"ExchangeMailboxQuota":"2000",
		"DateFormat":"MM/dd/yyyy",
		"MaxQuota":"UNLIMITED",
		"UsedOpenDirectQuota":"0",
		"UsedObmRepQuota":0
	}
}