Pagination Support

Overview

To improve performance when retrieving large datasets, the getReportApiData API supports pagination for selected reports. Instead of returning all records in a single response, results are delivered in manageable pages.

Pagination Parameters

The following parameters control pagination behavior. They are passed in the request and reflected in the response.

Request Parameters

Parameter	Type	Description
`limit`	`integer-string`	Number of results to return per page
`page`	`integer-string`	Page number to retrieve (1-indexed)

Response Parameters

Parameter	Type	Description
`currentPage`	`integer`	The current page number in the result set
`pageSize`	`integer`	Number of records returned in the current page
`totalEntries`	`integer`	Total number of records available for the report
`totalPages`	`integer`	Total number of pages based on the specified `limit`
`isNextPage`	`boolean`	`true` if a next page is available
`isPrevPage`	`boolean`	`true` if a previous page is available

Reports Supporting Pagination

Pagination is currently enabled for the following reports under their respective modules:

Module	Reports
DM — Device Management	All Devices, Device Details Summary
AE — Asset Exposure	Assets Based On Publisher, Operating System Licenses, Software Licenses, Hardware Licenses, Outdated Applications, Blacklisted Applications, Rarely Used Applications, Device Details, Application Details, Software Asset Summary, Application By Devices
VM — Vulnerability Management	High Fidelity Attacks, All Vulnerabilities, Vulnerability Count Based On Operating System, Vulnerability Count Based On Group, Vulnerabilities by Devices, All Vulnerabilities Based On Asset
EM — Endpoint Management	All Devices, Not Scanned Devices, Device Details Summary
PM — Patch Management	Missing Patches, Missing Patches by Devices, Assets With No Patches, Missing Security Patches for Outdated Products, Outdated Asset Patches, Outdated OS Patches, Devices with Missing Security Patches, Top 10 Missing Security Patches, Top 10 Devices By Security Patches, Firmware, Installed Patches, Installed Patches by Devices, Remediation Patch Details By Task Name (Job), Third-Party Security Patches
CM — Compliance Management	Misconfigurations, Top 10 Recommended CCE Remediation

Sample Request

{
  "request": {
    "method": "getReportApiData",
    "parameters": {
      "parameterset": [{
        "parameter": [
          { "key": "organization", "value": "Saner-Org" },
          { "key": "accountid",    "value": "Saner-Account" },
          { "key": "reportapi",    "value": "All Vulnerabilities" },
          { "key": "tool",         "value": "VM" },
          { "key": "limit",        "value": "2" },
          { "key": "page",         "value": "1" },
          {
            "key": "apifilters",
            "filters": [{
              "patchType":          ["os"],
              "families":           ["unix", "windows", "macos"],
              "application":        ["bind"],
              "applicationExclude": true
            }]
          }
        ]
      }]
    }
  }
}

Sample Response

{
  "referencesview": [
    {
      "exploitability":          "No",
      "reference":               "CVE-2025-9900",
      "detectiondate":           "2026-01-09",
      "releasedate":             "2025-09-23",
      "highFidelityAttacks":     [],
      "highFidelityAttacksCount": 0,
      "zeroDayVulnerability":    "FALSE",
      "assetFamily":             ["unix"],
      "severity":                "High",
      "severityscore":           8.8,
      "patchType":               "vendor",
      "platforms":               ["cpe:/o:ubuntu:ubuntu_linux:20.04"],
      "products":                ["cpe:/a:libtiff:libtiff:5"],
      "assets":                  ["libtiff5"],
      "vulnerableInstanceCount": 1,
      "family":                  "unix",
      "hosts":                   1,
      "hostnames":               ["ubuntu-20.04-x64"],
      "totalassets":             1,
      "title":                   "Write-What-Where Vulnerability in Libtiff",
      "patch":                   "libtiff5",
      "patchcount":              1,
      "portservice":             "-"
    },
    {
      "exploitability":          "No",
      "reference":               "CVE-2025-9714",
      "detectiondate":           "2026-01-09",
      "releasedate":             "2025-09-10",
      "highFidelityAttacks":     [],
      "highFidelityAttacksCount": 0,
      "zeroDayVulnerability":    "FALSE",
      "assetFamily":             ["unix"],
      "severity":                "Medium",
      "severityscore":           5.5,
      "patchType":               "vendor",
      "platforms":               ["cpe:/o:ubuntu:ubuntu_linux:20.04"],
      "products":                ["cpe:/a:xmlsoft:libxml2"],
      "assets":                  ["libxml2"],
      "vulnerableInstanceCount": 1,
      "family":                  "unix",
      "hosts":                   1,
      "hostnames":               ["ubuntu-20.04-x64"],
      "totalassets":             1,
      "title":                   "Uncontrolled Recursion Vulnerability in libxml2 for XPath Evaluation",
      "patch":                   "libxml2",
      "patchcount":              1,
      "portservice":             "-"
    }
  ],
  "currentPage":  1,
  "pageSize":     2,
  "totalEntries": 818,
  "isNextPage":   true,
  "isPrevPage":   false,
  "totalPages":   409
}

Response Breakdown

Field	Value	Notes
`currentPage`	`1`	First page returned
`pageSize`	`2`	Matches the `limit` sent in the request
`totalEntries`	`818`	818 total vulnerability records available
`totalPages`	`409`	Ceil(818 / 2)
`isNextPage`	`true`	More pages available
`isPrevPage`	`false`	Already on the first page

Iterating Through Pages

To retrieve all records, increment the page parameter on each request until isNextPage is false.

Request page=1  →  isNextPage: true   → fetch next
Request page=2  →  isNextPage: true   → fetch next
...
Request page=409 → isNextPage: false  → done

Tip: Choose a limit that balances response size and request count. Larger limits mean fewer round-trips but larger payloads per response.