Skip to content

See which of your devices have known vulnerabilities, by real risk

What you can call today

Every example here runs against api.xovris.ai with a key from your account’s settings. GET /v1/health and GET /v1/public/status answer without one.

GET
/v1/vulnerabilities/devices
curl --request GET \  --url https://api.xovris.ai/v1/vulnerabilities/devices \  --header 'Authorization: Bearer <token>'

A token that can read is enough.

Done.

Media typeapplication/json
object
readAt
required
One of:
string
sources
required
Array<object>
object
readAt
required
One of:
string
ageHours
required
One of:
number
stale
required
boolean
rows
required
number
problem
required
One of:
string
feed
required
string
name
required
string
url
required
string
licence
required
string
everyHours
required
number
stale
required
Array<string>
packages
Array<object>
object
deviceId
required
string
device
required
string
name
required
string
version
required
string
purl
required
string
support
required
object
state
required
string
Allowed values: unknown supported security_only end_of_support
product
required
One of:
string
cycle
required
One of:
string
eoasFrom
required
One of:
string
eolFrom
required
One of:
string
latest
required
One of:
string
supportedCycles
required
Array<string>
source
required
object
name
required
string
url
required
string
licence
required
string
readAt
required
One of:
string
why
required
string
move
object
state
required
string
Allowed values: unread offered not_offered
to
required
One of:
object
name
required
string
version
required
string
cycle
required
One of:
string
why
required
string
devices
required
Array<object>
object
id
required
string
asset
required
string
name
required
string
kind
required
string
cpe
required
string
vendor
required
string
product
required
string
productName
required
string
version
required
One of:
string
model
required
One of:
string
readFrom
required
string
readAt
required
string
evidence
required
string
exposure
required
object
internetFacing
required
One of:
boolean
managementExposed
One of:
boolean
services
Array<string>
forwards
Array<string>
basis
string
importance
required
string
Allowed values: high low critical normal
pilot
required
boolean
ring
required
string
Allowed values: critical pilot broad
via
required
One of:
string
patch
required
One of:
object
state
required
string
Allowed values: unknown up_to_date security_update unsupported
next
required
string
why
required
string
open
required
number
worst
required
One of:
string
Allowed values: low exploited_now likely_soon serious
kevOpen
required
number
topScore
required
number
topEpss
required
One of:
number
closing
required
One of:
object
to
required
string
closes
required
Array<string>
leaves
required
Array<string>
branchMove
required
boolean
support
required
One of:
object
state
required
string
Allowed values: unknown supported security_only end_of_support
product
required
One of:
string
cycle
required
One of:
string
eoasFrom
required
One of:
string
eolFrom
required
One of:
string
latest
required
One of:
string
supportedCycles
required
Array<string>
source
required
object
name
required
string
url
required
string
licence
required
string
readAt
required
One of:
string
why
required
string
fix
required
One of:
object
state
required
string
target
required
One of:
string
requestedAt
required
One of:
string
verifiedAt
required
One of:
string
error
required
One of:
string
action
required
object
kind
required
string
Allowed values: fix.software.upgrade fix.firmware.upgrade fix.os.update
mode
required
string
Allowed values: automatic guided
door
required
string
Allowed values: browser vendor-api management-protocol device-manager os-updater device-standard
ladder
required
Array<object>
object
door
required
string
Allowed values: browser vendor-api management-protocol device-manager os-updater device-standard
via
required
string
runs
required
boolean
before
required
string
apply
required
string
readBack
required
string
rollback
required
string
findings
required
Array<object>
object
name
required
string
version
required
string
severity
required
string
Allowed values: high medium low critical unknown
product
required
string
kev
required
One of:
object
cveID
required
string
dateAdded
required
string
dueDate
string
knownRansomwareCampaignUse
string
epss
required
One of:
number
asset
required
string
matched
required
string
advisory
required
object
id
required
string
title
required
string
url
required
string
source
required
string
licence
required
string
readAt
required
string
published
required
One of:
string
cves
required
Array<string>
fixedIn
required
One of:
string
branchMove
required
boolean
workaround
required
One of:
string
vendorFix
required
One of:
string
kb
required
One of:
string
cvss
required
One of:
object
version
required
string
score
required
number
vector
required
One of:
string
source
required
string
id
required
string
firstSeenAt
required
string
risk
required
object
score
required
number
priority
required
string
Allowed values: low exploited_now likely_soon serious
decision
required
string
Allowed values: track act attend track*
factors
required
Array<object>
object
name
required
string
Allowed values: exploitation exposure importance impact likelihood
value
required
string
source
required
string
weight
required
number
why
required
string
actNow
required
boolean
exploitation
One of:
object
at
required
string
source
required
string
url
required
string
said
required
string
structured
required
boolean
sources
required
number
virtualPatches
Array<object>
object
id
required
string
asset
required
string
action
required
string
state
required
string
why
required
string
changed
required
error
required
One of:
string
requestedAt
required
string
appliedAt
required
One of:
string
undoneAt
required
One of:
string
idsBlocks
Array<object>
object
id
required
string
deviceId
required
string
cves
required
Array<string>
rules
required
Array<string>
state
required
string
why
required
string
error
required
One of:
string
requestedAt
required
string
appliedAt
required
One of:
string
undoneAt
required
One of:
string
outsideProofs
Array<object>
object
asset
required
string
since
required
string
firstProvedAt
required
string
proofs
required
number
endpoint
required
object
service
required
string
interface
required
string
url
required
string
reachable
required
One of:
boolean
status
required
One of:
number
said
required
string
at
required
string
patchOrder
required
Array<string>
unknown
required
Array<object>
object
asset
required
string
name
required
string
advisory
required
One of:
string
why
required
string
measure
required
object
devices
required
number
recognised
required
number
kevOpen
required
number
kevOpenPast48h
required
number
unsupported
required
number
target
required
number
Allowed values: 0
plan
required
One of:
object
on
required
boolean
empty
required
One of:
object
message
required
string
next
required
string
problem
required
One of:
string

Example

{  "readAt": "string",  "sources": [    {      "readAt": "string",      "ageHours": 1,      "stale": true,      "rows": 1,      "problem": "string",      "feed": "string",      "name": "string",      "url": "string",      "licence": "string",      "everyHours": 1    }  ],  "stale": [    "string"  ],  "packages": [    {      "deviceId": "string",      "device": "string",      "name": "string",      "version": "string",      "purl": "string",      "support": {        "state": "unknown",        "product": "string",        "cycle": "string",        "eoasFrom": "string",        "eolFrom": "string",        "latest": "string",        "supportedCycles": [          "string"        ],        "source": {          "name": "string",          "url": "string",          "licence": "string"        },        "readAt": "string",        "why": "string"      },      "move": {        "state": "unread",        "to": {          "name": "string",          "version": "string",          "cycle": "string"        },        "why": "string"      }    }  ],  "devices": [    {      "id": "string",      "asset": "string",      "name": "string",      "kind": "string",      "cpe": "string",      "vendor": "string",      "product": "string",      "productName": "string",      "version": "string",      "model": "string",      "readFrom": "string",      "readAt": "string",      "evidence": "string",      "exposure": {        "internetFacing": true,        "managementExposed": true,        "services": [          "string"        ],        "forwards": [          "string"        ],        "basis": "string"      },      "importance": "high",      "pilot": true,      "ring": "critical",      "via": "string",      "patch": {        "state": "unknown",        "next": "string",        "why": "string",        "open": 1,        "worst": "low",        "kevOpen": 1,        "topScore": 1,        "topEpss": 1,        "closing": {          "to": "string",          "closes": [            "string"          ],          "leaves": [            "string"          ],          "branchMove": true        },        "support": {          "state": "unknown",          "product": "string",          "cycle": "string",          "eoasFrom": "string",          "eolFrom": "string",          "latest": "string",          "supportedCycles": [            "string"          ],          "source": {            "name": "string",            "url": "string",            "licence": "string"          },          "readAt": "string",          "why": "string"        },        "fix": {          "state": "string",          "target": "string",          "requestedAt": "string",          "verifiedAt": "string",          "error": "string"        },        "action": {          "kind": "fix.software.upgrade",          "mode": "automatic",          "door": "browser",          "ladder": [            {              "door": "browser",              "via": "string",              "runs": true            }          ],          "before": "string",          "apply": "string",          "readBack": "string",          "rollback": "string"        }      }    }  ],  "findings": [    {      "name": "string",      "version": "string",      "severity": "high",      "product": "string",      "kev": {        "cveID": "string",        "dateAdded": "string",        "dueDate": "string",        "knownRansomwareCampaignUse": "string"      },      "epss": 1,      "asset": "string",      "matched": "string",      "advisory": {        "id": "string",        "title": "string",        "url": "string",        "source": "string",        "licence": "string",        "readAt": "string",        "published": "string"      },      "cves": [        "string"      ],      "fixedIn": "string",      "branchMove": true,      "workaround": "string",      "vendorFix": "string",      "kb": "string",      "cvss": {        "version": "string",        "score": 1,        "vector": "string",        "source": "string"      },      "id": "string",      "firstSeenAt": "string",      "risk": {        "score": 1,        "priority": "low",        "decision": "track",        "factors": [          {            "name": "exploitation",            "value": "string",            "source": "string",            "weight": 1          }        ],        "why": "string",        "actNow": true,        "exploitation": {          "at": "string",          "source": "string",          "url": "string",          "said": "string",          "structured": true,          "sources": 1        }      }    }  ],  "virtualPatches": [    {      "id": "string",      "asset": "string",      "action": "string",      "state": "string",      "why": "string",      "changed": null,      "error": "string",      "requestedAt": "string",      "appliedAt": "string",      "undoneAt": "string"    }  ],  "idsBlocks": [    {      "id": "string",      "deviceId": "string",      "cves": [        "string"      ],      "rules": [        "string"      ],      "state": "string",      "why": "string",      "error": "string",      "requestedAt": "string",      "appliedAt": "string",      "undoneAt": "string"    }  ],  "outsideProofs": [    {      "asset": "string",      "since": "string",      "firstProvedAt": "string",      "proofs": 1,      "endpoint": {        "service": "string",        "interface": "string",        "url": "string"      },      "reachable": true,      "status": 1,      "said": "string",      "at": "string"    }  ],  "patchOrder": [    "string"  ],  "unknown": [    {      "asset": "string",      "name": "string",      "advisory": "string",      "why": "string"    }  ],  "measure": {    "devices": 1,    "recognised": 1,    "kevOpen": 1,    "kevOpenPast48h": 1,    "unsupported": 1,    "target": 0  },  "plan": {    "on": true  },  "empty": {    "message": "string",    "next": "string"  },  "problem": "string"}

Not signed in: the token is missing, expired or revoked. The answer says how to get a new one.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Signed in, but this token or role may not do this. The answer names the permission it needs.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Nothing with that id here, or it belongs to another workspace. Nothing was changed.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Any other refusal or failure. The answer says what happened and what to do next.

Media typeapplication/json
object
error
required
object
code
required

A stable code a program can branch on.

string
message
required

What happened, in plain words.

string
nextStep
required

What to do next.

string
decisionId

The recorded authorisation decision, when a role refused it.

string

Example generated

{  "error": {    "code": "example",    "message": "example",    "nextStep": "example",    "decisionId": "example"  }}

Ask Xovris

Open the full page

Your data is never used to train our AI. How your data is kept

A problem is called fixed only once it works again. How each fix is checked

XOVRIS LTD, registered in England and Wales, company number 17499910. Registered office: 66 Paul Street, London EC2A 4NA.