Account Details

API version3.2
Last Update04/18/2023
AuthenticationYES
HTTP MethodPOST
Rate limitedYES
Requests per rate limit10/min
Response FormatJSON
Change HistoryAdded a new “score_type”

Use this API to fetch your account details

API URL

Copy

Request Parameters

KeyDatatypeParameter TypeRequiredDescriptionDefault
access_tokenstringHeaderYesaccess token which archived from OAuth authentication step
score_typestringBodyOptionalSpecify what score type used to filter along with the field filter.score Value can be: "opswat_score", "cvss2_ score", "cvss3_score"opswat_score

Response HTTP Code

See auto$

Response Parameters

KeyDataTypeDescription
namestringAccount Name
emailstringOwner email address
last_loginstringThe last date when the owner user logged into My OPSWAT Central Management console
date_createdstringDate when the account was created
devices_allowedintMaximal number of devices is allowed to be monitored by on the account
devices_usedintNumber of monitored devices on the account
license_keystringAccount license key
devices_by_statusArray <object>
devices_by_status.statusstring
  • compliant : device is compliance with policy
  • non-compliant : device is non-compliance with policy
  • exempted : device is exempted
  • unknown : device is not installed My OPSWAT Central Management agent
devices_by_status.number_of_devicesintNumber of devices by status
devices_by_issue_severityArray <object>
devices_by_issue_severity.severitystring
  • critical : device has critical issues
  • warning : device has warning issues
  • no_issue: device doesn't have any issues
devices_by___issue_severity.number_of_devicesintNumber of devices by issue severity
devices_by_vulnerability_severityArray <object>
devices_by_vulnerability_severity.severitystring

Vulnerability severity:

Value can be: "critical", "important", "moderate", "low", "unknown", "high", "medium".

devices_by_vulnerability_severity.number_of_devicesintNumber of devices by vulnerability severity

Example

Example request using "score_type"

Copy

Example Response

Copy

History

ActionVersionURL
Account Details3.1auto$
Account Details3.0auto$
Account Details2.0auto$
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard