Chapter 3: License information

Using the REST API, details of the license and the current status of subscription based licenses (when applicable) in cOS Core can be retrieved. The information is sent back by cOS Core in JSON format and consists of the values that can also be provided by using the cOS Core CLI license command.

The license shows information about registration key, subscription details and status of subscription based licenses (SECaaS).

Sending the Request

To retrieve license information from cOS Core, an HTTP GET should be sent as follows:

/api/oper/license

SECaaS Specific Information

An Example JSON Reply

Below is an example of a typical JSON reply for an IP rule set with a single entry:

  {
	"error": false,
	"license": {
	  "registration_key": "1234-1234-1234-1234",
	  "subscription_based": true,
	  "issued_date": "2023-10-26",
	  "lastmodified_date": "2023-10-21 22:04:23",
	  "expiration_date": "2023-12-01",
	  "techsupport_date": "2023-12-01",
	  "idp_date": "2023-12-01",
	  "av_date": "2023-12-01",
	  "wcf_date": "2023-12-01",
	  "di_date": "2023-12-01",
	  "dcc_date": "2023-12-01",
	  "incenter_date": "2023-12-01",
	  "iprep_date": "2023-12-01"
	},
	"secaas": {
	  "status": "Running normally",
	  "server_reached": true,
	  "last_reached": "2023-10-31 11:52:43",
	  "last_attempt": "2023-10-31 11:52:42",
	  "last_result": "License is up to date",
	  "seconds_until_next_attempt": 14384,
	  "seconds_until_reduced_mode": -1
	}
  }