Skip to content

List software vulnerabilities that affect you

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
curl --request GET \  --url https://api.xovris.ai/v1/vulnerabilities \  --header 'Authorization: Bearer <token>'

A token that can read is enough.

Done.

Media typeapplication/json
object
readAt
required
One of:
string
sources
required
object
osv
required
One of:
string
kev
required
One of:
string
epss
required
One of:
string
inventory
required
object
assets
required
number
packages
required
number
covered
required
number
notCovered
required
number
exposures
required
Array<object>
object
severity
required
string
Allowed values: high medium low critical unknown
why
required
string
kev
required
One of:
object
cveID
required
string
dateAdded
required
string
dueDate
string
knownRansomwareCampaignUse
string
epss
required
One of:
number
exploitation
One of:
object
at
required
string
source
required
string
url
required
string
said
required
string
structured
required
boolean
sources
required
number
installed
required
object
asset
required
string
ecosystem
required
string
name
required
string
version
required
string
internetFacing
boolean
importance
string
Allowed values: high low critical normal
loaded
boolean
priority
required
string
Allowed values: low exploited_now likely_soon serious
risk
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
reach
string
Allowed values: unknown loaded installed_only
cves
required
Array<string>
fixedIn
required
One of:
string
vuln
required
object
id
required
string
aliases
Array<string>
summary
string
database_specific
object
severity
string
id
required
string
firstSeenAt
required
string
assetName
required
string
upgrades
required
Array<object>
object
asset
required
string
ecosystem
required
string
name
required
string
from
required
string
to
required
One of:
string
closes
required
number
worst
required
string
Allowed values: low exploited_now likely_soon serious
unfixed
required
Array<string>
id
required
string
assetName
required
string
fix
required
One of:
object
state
required
string
requestedAt
required
One of:
string
verifiedAt
required
One of:
string
error
required
One of:
string
provenBy
required
One of:
object
words
required
string
title
required
string
source
required
string
licence
required
string
url
required
string
trials
required
number
passed
required
number
rehearsedAt
required
string
unknown
required
Array<object>
object
installed
required
object
asset
required
string
ecosystem
required
string
name
required
string
version
required
string
internetFacing
boolean
importance
string
Allowed values: high low critical normal
loaded
boolean
vuln
required
string
plan
required
One of:
object
on
required
boolean
empty
required
One of:
object
message
required
string
next
required
string
problem
required
One of:
string
measure
required
object
kevOpen
required
number
kevOpenPast48h
required
number
ransomwareOpen
required
number
oldestKevSince
required
One of:
string
target
required
number
Allowed values: 0

Example

{  "readAt": "string",  "sources": {    "osv": "string",    "kev": "string",    "epss": "string"  },  "inventory": {    "assets": 1,    "packages": 1,    "covered": 1,    "notCovered": 1  },  "exposures": [    {      "severity": "high",      "why": "string",      "kev": {        "cveID": "string",        "dateAdded": "string",        "dueDate": "string",        "knownRansomwareCampaignUse": "string"      },      "epss": 1,      "exploitation": {        "at": "string",        "source": "string",        "url": "string",        "said": "string",        "structured": true,        "sources": 1      },      "installed": {        "asset": "string",        "ecosystem": "string",        "name": "string",        "version": "string",        "internetFacing": true,        "importance": "high",        "loaded": true      },      "priority": "low",      "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        }      },      "reach": "unknown",      "cves": [        "string"      ],      "fixedIn": "string",      "vuln": {        "id": "string",        "aliases": [          "string"        ],        "summary": "string",        "database_specific": {          "severity": "string"        }      },      "id": "string",      "firstSeenAt": "string",      "assetName": "string"    }  ],  "upgrades": [    {      "asset": "string",      "ecosystem": "string",      "name": "string",      "from": "string",      "to": "string",      "closes": 1,      "worst": "low",      "unfixed": [        "string"      ],      "id": "string",      "assetName": "string",      "fix": {        "state": "string",        "requestedAt": "string",        "verifiedAt": "string",        "error": "string"      },      "provenBy": {        "words": "string",        "title": "string",        "source": "string",        "licence": "string",        "url": "string",        "trials": 1,        "passed": 1,        "rehearsedAt": "string"      }    }  ],  "unknown": [    {      "installed": {        "asset": "string",        "ecosystem": "string",        "name": "string",        "version": "string",        "internetFacing": true,        "importance": "high",        "loaded": true      },      "vuln": "string"    }  ],  "plan": {    "on": true  },  "empty": {    "message": "string",    "next": "string"  },  "problem": "string",  "measure": {    "kevOpen": 1,    "kevOpenPast48h": 1,    "ransomwareOpen": 1,    "oldestKevSince": "string",    "target": 0  }}

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.