Skip to content

Vulnerabilities the release's SBOM components are affected by

GET
/v1/orgs/{org}/releases/{release}/vulnerabilities
curl --request GET \
--url 'https://example.com/v1/orgs/example/releases/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/vulnerabilities?include=resolved&limit=50' \
--header 'Authorization: Bearer <token>'

The items are advisories: one per OSV, NVD or CSAF record, so one CVE can appear several times. A release’s number of problems is the number of distinct groups (the keys in each item’s groups), which finding-groups lists one by one.

Most urgent first: known exploited (CISA KEV, or ENISA’s list from a source other than CISA), then CVSS, then EPSS. Matching runs in the worker, so a new upload shows its vulnerabilities shortly after, not in the upload response. Findings resolved by VEX (not_affected, fixed) are left out unless include=resolved.

A page at a time (up to 200 advisories, 50 by default): while more is true, ask again with after set to next. A page that is cut keeps every component of its advisories.

org
required
string

Organization (tenant) slug, e.g. alpenrobotik

release
required
string format: uuid
include
string
Allowed values: resolved

Resolved: also list findings VEX marked not_affected or fixed

limit
integer
default: 50 >= 1 <= 200
after
string

The next of the previous page

A page of vulnerabilities

Media typeapplication/json
object
items
required
Array<object>

An advisory the release is affected by. Several advisories can name one CVE; a release’s number of problems is the number of distinct groups (finding-groups lists them).

object
groups
required

The keys of the finding groups the advisory is in (its CVEs, or source:id for an advisory without one)

Array<string>
conflict
required

One of the advisory’s groups has sources that disagree (see finding-groups)

boolean
source
required

Osv: matched by package URL; nvd: matched by CPE; csaf: a provider’s CSAF advisory, matched by its product’s package URL or CPE

string
Allowed values: osv nvd csaf
id
required

Advisory or record ID, e.g. “DSA-5343-1”, “GHSA-…”, “CVE-2023-0286”

string
cves
required
Array<string>
title
required
string
severity

NVD severity of the worst CVE (CRITICAL

string
cvss_score

Highest NVD CVSS base score of the CVEs

number
known_exploited
required

One of the CVEs is in CISA’s KEV catalog, or on ENISA’s exploited list from a source other than CISA

boolean
epss

Highest EPSS probability of the CVEs (0-1)

number
euvd_ids
required

The EUVD IDs (ENISA’s EU Vulnerability Database, e.g. EUVD-2025-4893) of the record’s CVEs, sorted; empty when ENISA has none or this installation doesn’t sync the EUVD.

Array<string>
vendor_advisories
required

CSAF advisories of vendors and coordinators (BSI, CERT@VDE, CISA, Siemens, …) that name one of the finding’s CVEs, by ID; withdrawn ones are left out. Empty when no provider this installation syncs has one.

Array<object>
object
id
required

Record ID, :, e.g. “siemens:SSA-104023”

string
advisory_id
required

The provider’s advisory ID, e.g. “SSA-104023”

string
provider
required

The provider, e.g. “siemens”, “bsi-wid”, “cisa-ics”

string
provider_name
required

How the provider is shown, e.g. “Siemens ProductCERT”

string
publisher
required

The provider’s category

string
Allowed values: vendor coordinator
title
required
string
url
required

The advisory’s page at the provider, or its CSAF document

string
fixes
required

Products the advisory says are fixed in a version, or have a vendor fix, for the finding’s CVEs (at most 20)

Array<object>
object
product
required
string
fixed_version

The version that fixes the product

string
remediation_url

Where the vendor’s fix is

string
also_in
required

Other records that matched the same components for some of this finding’s CVEs, which this finding supersedes: one finding per component and CVE set, ranked a vendor’s CSAF advisory, a coordinator’s, OSV, then NVD. They are no findings of their own. Empty when there are none.

Array<object>
object
source
required
string
Allowed values: osv nvd csaf
id
required
string
title
required
string
url

A CSAF advisory’s page; absent for OSV and NVD records

string
first_seen
required

First matched to this release, never before the SBOM that brings it in

string format: date-time
vex_status
string
Allowed values: not_affected affected fixed under_investigation
components
required
Array<object>
object
sbom_id
required
string format: uuid
ref
required
string
name
required
string
version
string
purl
string
matched_via
required

Purl: OSV; cpe: NVD (curated list or the SBOM’s CPE); csaf_purl, csaf_cpe: a CSAF advisory’s product, by package URL or CPE; org_cpe: NVD or a CSAF advisory through the organization’s own CPE mapping; org_csaf: a CSAF advisory through the organization’s own CSAF product mapping

string
Allowed values: purl cpe csaf_purl csaf_cpe org_cpe org_csaf
next

The after of the next page; absent on the last. Opaque

string
more
required

More vulnerabilities follow next

boolean

Example

{
"items": [
{
"source": "osv",
"vendor_advisories": [
{
"publisher": "vendor"
}
],
"also_in": [
{
"source": "osv"
}
],
"vex_status": "not_affected",
"components": [
{
"matched_via": "purl"
}
]
}
]
}

Request.invalid (params.field include, limit or after)

No such object in this organization, no such organization, or the caller does not belong to it

Over the operation’s rate-limit budget (x-affectra-budget): code request.rateLimited with params.budget. Wait Retry-After seconds before trying again.

Media typeapplication/problem+json

Every error answer, Content-Type application/problem+json. The web app and integrations translate code; detail is English, for people reading curl output or CI logs, and may change wording at any time. Match on code, never on detail.

object
status
required

The HTTP status

integer
code
required

Stable error codes. A code is never renamed; new ones may be added, so a client falls back to detail for a code it doesn’t know. Another organization’s object answers notFound, the same as a missing one.

string
Allowed values: notFound internal request.invalidJson request.invalid request.alreadyExists request.timeInvalid auth.required auth.csrfMissing email.invalid accounts.passwordUnavailable locale.invalid request.rateLimited auth.sessionRequired auth.roleTooLow auth.githubTokenUploadOnly org.suspended org.required request.fieldRequired request.textInvalid request.timeout server.notReady catalog.unavailable report.invalid report.wrongTenant settings.csafNamespaceInvalid settings.digestHourInvalid settings.timeZoneInvalid sbom.invalid sbom.limitExceeded sbom.signatureInvalid sbom.signatureRequired sbom.signatureUnavailable upload.hardwareRevisionRenamed upload.malformed upload.unexpectedPart upload.sbomMissing upload.tooLarge upload.unreadable provenance.invalid provenance.sbomAttestation provenance.signatureRequired provenance.unavailable vex.vulnerabilityInvalid vex.statusInvalid vex.justificationUnknown vex.justificationNotAllowed vex.justificationRequired vex.actionRequired vex.statementTooLong vex.csafNamespaceRequired vex.csafNoStatements release.hasVexStatements finding.refInvalid mapping.purlInvalid mapping.purlVersioned mapping.purlCoveredByOsv mapping.cpeFieldInvalid mapping.builtIn mapping.csafProviderUnknown mapping.csafKindInvalid mapping.csafValueInvalid feeds.notSubscribable accounts.setupEmailLimit member.exists member.joined member.roleInvalid member.ownerGrantDenied member.ownerChangeDenied member.ownerRemoveDenied member.lastOwner github.orgInvalid github.teamInvalid github.roleInvalid github.adminRequired key.nameInvalid key.roleInvalid key.purposeInvalid product.keyInvalid product.keyExists product.keyLocked product.supportEndsInvalid alias.reportedInvalid alias.exists publisher.repositoryInvalid publisher.fieldTooLong publisher.idsIncomplete publisher.repositoryNotFound publisher.githubUnreachable publisher.workflowInvalid publisher.refPatternPrefix publisher.refPatternInvalid publisher.exists graph.vulnerabilityUnknown graph.timeout proposal.evidenceUnknown proposal.evidenceTooLarge proposal.kindInvalid proposal.basisInvalid proposal.notCarryOver proposal.basisMismatch proposal.notPending proposal.sourceSuperseded proposal.ownProposal proposal.fourEyes proposal.personRequired proposal.batchTooLarge proposal.vulnerabilityChanged proposal.reportedChanged proposal.releaseUnknown proposal.evidenceMissing notifications.unavailable notifications.findingsInvalid notifications.tokenInvalid webhook.urlRejected webhook.limitReached webhook.formatUnavailable webhook.headerInvalid webhook.eventTypesInvalid webhook.disabled events.cursorInvalid
detail
required

What went wrong

string
params
required

Values the code’s message needs, e.g. {“field”: “version”}. Only values the caller sent or may see. Empty when the message needs none.

object
key
additional properties
any

Example

{
"code": "notFound"
}
Retry-After
integer
>= 1

Seconds until a request would be allowed again, at least 1