Visit Support

API for JVM Inventory

The JVM Inventory API allows you to create and download reports to get insights into your connected JVM runtimes.

Reports are generated asynchronously. By using the endpoint, a task to generate a report is created. In response, you get a unique report identifier. With this identifier, you can retrieve the report.

Request Report Generation

You can request the generation of a report with a POST call to and a set of parameters.

Request Parameters

Argument Default Description



Array of filters for one or more of the following:

  • hostName

  • vmId

  • tags

  • state



Timestamp for the start of the report.

Example: "2023-02-15T00:00:00.000+0200`



Timestamp for the end of the report.

Similar to from.



List of fields by which the components (name + version) are grouped. The order of the fields directly affects the result of the grouping. The values of the groupBy fields are presented in the data items of the response. In addition, the count field corresponding to the number of VMs included in each group is returned.

Format: <field_name>.

The count field can be used to sort data, for example, using count=ASC.
To group by time period, use the keywords year, month, week, or day. When using week, the week number of the year will be used (Calendar.WEEK_OF_YEAR).



A set of fields and the desired sort order for their values.

Format: <field_name>=<sort_order>.

Sort order values:

  • ASC - ascending

  • DESC - descending

Example Request

curl -X 'POST' \ '' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -H 'x-api-key: l91uNwWPDt5z2oa13wmQAPDfGv5Ti4T7bEQZKoXg' \ -d '{ "filter": [ "hostName = '\''localhost'\''", "vmId != '\''a79b38cd-787b-4203-ba6d-9197c0e3fe19'\''", "tags.owner CONTAINS '\''elena'\''", "state = '\''SUCCEEDED'\''" ], "groupBy": [ "state", "agentVersion" ], "sortBy": [ "lastHeardTime=DESC", "tags.owner=DESC" ], "from": "3d", "to": "3d", "reportName": "My report #1" }'

Example Response

In response, you will get a reportId that can be used with the GET endpoint to retrieve the report.

{ "reportId": "1cc40ee6-87a7-4147-b02d-7d26ce0387d0", "state": "PROCESSING", "userId": "[email protected]", "params": { ... }, "requestTime": "2023-02-15T00:00:00.000Z" }

Retrieve the Report

You can retrieve a report with a GET call to /public/report/jvmInventory/YOUR_REPORT_ID.

The response must be checked to define if the data is available, based on the following possible return data:

  • state: State of the request, one of the following options:



    • FAILED



  • stateMessages: More info related to the state.

  • errors: Errors while creating the report (if applicable).

Large reports are split into pages (up to 5.5MB per page). You can find the total number of pages in the response and use this value to retrieve all the report pages.

Regardless of whether a report is generated successfully or not, when the generation is finished, at least one page of the report is available for retrieval.

Example Request

curl -X 'GET' \ '' \ -H 'accept: application/json' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json'

Example Response

{ "reportId": "1cc40ee6-87a7-4147-b02d-7d26ce0387d0", "userId": "[email protected]", "params": { ... }, "from": "2023-07-13T16:42:37.268", "to": "2023-07-13T16:42:37.268", "state": "PROCESSING", "requestTime": "2023-07-13T16:42:37.268", "startTime": "2023-07-13T16:42:37.268", "finishTime": "2023-07-13T16:42:47.231", "data": [ {} ], "afterToken": "2", "totalCount": 35352, "stateMessages": [ "1st message", "2nd message" ] }

Delete a Report

You can delete a report with a DELETE call to

Example Request

curl -X 'DELETE' \ '' \ -H 'accept: application/json' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json'

Example Response

HTTP 204: Report deleted successfully.