EDR: How to get sensor versions using REST API
search cancel

EDR: How to get sensor versions using REST API


Article ID: 289434


Updated On:


Carbon Black EDR (formerly Cb Response)


Pull a list of sensors with the REST API to view the sensor version on each endpoint.


  • VMware Carbon Black EDR (EDR): All versions
  • VMware Carbon Black Hosted EDR (Hosted EDR): All versions


The /api/v1/sensor REST API call will return a JSON response with a list of sensors and related meta information. There is a field in the JSON response called "build_version_string" that contains a zero-padded version number that represents the sensor version installed on the endpoint. For example, a build_version_string "" indicates the sensor version. There is also an "os_environment_display_string" that contains the operating system version if needed.

Using the REST API requires authentication, so it is easiest to first log into the EDR server console UI. After login, modify the URL to include /api/v1/sensor (leave the domain portion of the URL). Additional parameters are added to the query to ensure that sensors with a pending uninstall request and previously uninstalled sensors are not included, as show below:


Please note that the rows parameter will need to be increased to accommodate your total sensor count, but this could lead to a performance impact with a large number of sensors. Alternatively, you can request a smaller number of rows over multiple queries and increment the start parameter with each query to denote which row to start returning results from.