List installed packages on server

GET

/apt/installed/{hostname}

Last modified:2026-09-29 18:51:36

OperationId:ListInstalledPackages

Lists the NetSapiens packages installed on one server, with every version you could install instead.

Requires Super User scope.

The answer comes from a cache that is cleared after every apt change on that server. Set skipcache to true to read apt again, which is slower.

The list ends with one entry whose application is repo. It is not a package: its version is the highest repository version configured on the server, and upgradable says whether a newer repository version is published. Use GET /apt/repos/{hostname} for the details.

Use all_options to pick a version for POST /apt/install/{hostname}.

When the request is forwarded and the named server answers with an error, that server's status and body are passed through unchanged.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

Installed packages on the server, then the repo entry.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error

🔴502Peer Unreachable

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/apt/installed/core1.example.com?skipcache=true' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Installed packages

[
  {
    "application": "netsapiens-nms",
    "name": "netsapiens-nms-alpha",
    "type": "alpha",
    "version": "46.0.0-alpha.47",
    "version_full": "2:46.0.0-alpha.47-noble",
    "version_index": 45999999.10047,
    "architecture": "amd64",
    "state": "installed",
    "hostname": "core1.example.com",
    "upgradable": true,
    "upgradable_to": "46.0.0-alpha.52",
    "upgradable_full": "2:46.0.0-alpha.52-noble",
    "upgradable_index": 45999999.10052,
    "all_options": [
      {
        "application": "netsapiens-nms",
        "name": "netsapiens-nms-alpha",
        "version": "46.0.0-alpha.52",
        "version_full": "2:46.0.0-alpha.52-noble",
        "codename": "noble",
        "version_index": 45999999.10052,
        "type": "alpha"
      },
      {
        "application": "netsapiens-nms",
        "name": "netsapiens-nms",
        "version": "45.2.3",
        "version_full": "2:45.2.3-noble",
        "codename": "noble",
        "version_index": 45002003.5,
        "type": "ga"
      }
    ]
  },
  {
    "application": "repo",
    "description": "The Max version of the repo available on this server",
    "version": "46.0",
    "hostname": "core1.example.com",
    "upgradable": false,
    "upgradable_to": "46.0"
  }
]

Modified at 2026-09-29 18:51:36

List installed packages across cluster

Refresh package lists on receiving server