# Get Library Version Vulnerability Trends

Returns the trend of the number of vulnerabilities in a library over past versions.
Define the scope of the trend with the parameters 'before' denoting the number of versions before the current version, and 'after'.
Does not support generic library types like Debian, RPM and Ruby

Endpoint: GET /api/v2.0/orgs/{orgToken}/libraries/{libraryUuid}/vulnerabilityTrends
Version: 2.0
Security: bearer-key

## Security:

  - `bearer-key` (unknown)
    http bearer JWT

## Path parameters:

  - `orgToken` (string, required)
    org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: **Integrate** tab > **API Key**).

  - `libraryUuid` (string, required)
    library UUID (get a project's library by running Library - Project > Get Project Libraries.

## Query parameters:

  - `startVersion` (string)

  - `before` (integer)

  - `after` (integer)

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `supportToken` (string)
    Example: 1171c60d

  - `retVal` (object)

  - `retVal.trends` (array)

  - `retVal.trends.name` (string)
    Example: Apache Ant Core

  - `retVal.trends.version` (string)
    Example: 1.8.2

  - `retVal.trends.type` (string)
    Example: MAVEN_ARTIFACT

  - `retVal.trends.current` (boolean)

  - `retVal.trends.vulnerabilities` (array)

  - `retVal.trends.vulnerabilities.name` (string)
    Example: CVE-2021-42392

  - `retVal.trends.vulnerabilities.type` (string)
    Enum: "CVE", "WS"

  - `retVal.trends.vulnerabilities.description` (string)
    Example: Security vulnerability found in plexus-utils before 3.0.24. XML injection found in XmlWriterUtil.java

  - `retVal.trends.vulnerabilities.score` (number)
    Example: 5

  - `retVal.trends.vulnerabilities.severity` (string)
    Enum: "HIGH", "MEDIUM", "LOW"

  - `retVal.trends.vulnerabilities.publishDate` (string)

  - `retVal.trends.vulnerabilities.modifiedDate` (string)

  - `retVal.trends.vulnerabilities.vulnerabilityScoring` (array)

  - `retVal.trends.vulnerabilities.vulnerabilityScoring.score` (number)
    Example: 5

  - `retVal.trends.vulnerabilities.vulnerabilityScoring.severity` (string)
    Enum: "LOW", "HIGH", "MEDIUM"

  - `retVal.trends.vulnerabilities.vulnerabilityScoring.type` (string)
    Enum: "CVSS_2", "CVSS_3"

  - `retVal.trends.vulnerabilities.vulnerabilityScoring.scoreMetadataVector` (string)
    Example: CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H

  - `retVal.trends.vulnerabilities.vulnerabilityScoring.extraData` (object)

  - `retVal.trends.vulnerabilities.references` (array)

  - `retVal.trends.vulnerabilities.references.value` (string)
    Example: https://github.com/codehaus-plexus/plexus-utils/commit/f933e5e78dc2637e485447ed821fe14904f110de

  - `retVal.trends.vulnerabilities.references.source` (string)
    Example: CERT

  - `retVal.trends.vulnerabilities.references.url` (string)
    Example: https://github.com/codehaus-plexus/plexus-utils/commit/f933e5e78dc2637e485447ed821fe14904f110de

  - `retVal.trends.vulnerabilities.references.signature` (boolean)

  - `retVal.trends.vulnerabilities.references.advisory` (boolean)

  - `retVal.trends.vulnerabilities.references.patch` (boolean)

  - `retVal.trends.vulnerabilities.effectiveInfo` (object)

  - `retVal.trends.vulnerabilities.effectiveInfo.referenceCount` (integer)

  - `retVal.trends.vulnerabilities.effectiveInfo.shieldValue` (integer)
    RED(15), YELLOW(10), GREY(8), NO_SHIELD(6), GREEN(5)

  - `retVal.trends.vulnerabilities.threatAssessment` (object)

  - `retVal.trends.vulnerabilities.threatAssessment.exploitCodeMaturity` (string)
    Enum: "UNPROVEN", "POC_CODE", "FUNCTIONAL", "HIGH", "NOT_DEFINED"

  - `retVal.trends.vulnerabilities.threatAssessment.epssPercentage` (number)
    Example: 0.8

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (*/*):

  - `supportToken` (string)
    Example: 1171c60d

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (*/*):

  - `supportToken` (string)
    Example: 1171c60d