Beveiligingsscans

Beveiligingsoverzicht opvragen

GET/v1/organization/security/overview

Vraagt scannerstatus en een samenvatting van bevindingen voor de gescande organisatie-IP's op.

curl --request GET \
  --url https://api.serverside.com/v1/organization/security/overview \
  --header 'Authorization: Bearer <api-key>'

{
  "success": true,
  "data": {
    "status": {
      "status": "UNKNOWN",
      "lastScan": "2026-01-15T09:30:00Z",
      "nextScan": "2026-01-15T09:30:00Z",
      "isScanRunning": true,
      "intervalSeconds": 123
    },
    "metadata": {
      "scanStarted": "2026-01-15T09:30:00Z",
      "scanFinished": "2026-01-15T09:30:00Z",
      "durationSeconds": 123
    },
    "summary": {
      "targetsWithFindings": 123,
      "totalFindings": 123,
      "openPorts": 123,
      "vulnerable": 123,
      "severityCounts": {
        "critical": 123,
        "high": 123,
        "medium": 123,
        "low": 123,
        "info": 123,
        "unknown": 123
      }
    },
    "targetCount": 123
  }
}

Autorisatie

Authorizationstringheaderverplicht
Organisatie-API-sleutel (org_...), gemaakt in de cloudconsole op https://cloud.serverside.com en één keer getoond, verstuurd als Authorization: Bearer <key>. Authenticeert als de organisatie.

Vereiste toestemming: organization.networking.read

Antwoord

200 · application/json

OK

successbooleanverplicht
Toegestane waarden:true
dataobject | nullverplicht