Skip to main content

SBOM Scan REST API

The SBOM Scan API can parse an SBOM to find vulnerabilities.

Permissions

Before you can use all endpoints of this API, you must have one of the following accounts with the required roles:

  • An API user account with the Results API role.
  • A UI user account with the Administrator, Executive, Reviewer, Sandbox User, Security Insights, or Security Lead role.

Authentication

This API requires secure authentication to Veracode.

Supported formats

The SBOM Scan API can scan SBOMs in the following formats:

  • CycloneDX v1.2, v1.3, v1.4, and v1.5 (JSON)
  • SPDX v2.2 and v2.3 (JSON)

Using the SBOM Scan API

To get vulnerabilities of an uploaded SBOM file, send one of the following requests:

curl --location 'https://api.veracode.com/srcclr/sbom/v1/manage/scan' --header 'Authorization: {HMAC-TOKEN}' --form 'sbom-file=@"{FILE-LOCATION}"'
http --auth-type=veracode_hmac -f POST 'https://api.veracode.com/srcclr/sbom/v1/manage/scan' sbom-file@{FILE_LOCATION}

SBOM Scan API specification

Specifications for the SBOM Scan API are available on SwaggerHub.