# 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: 3.0.1
Security: bearer-key

## Path parameters:

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

  - `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 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.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)

## Response 400 fields (*/*):

  - `supportToken` (string)
    Example: "1171c60d"

## Response 403 fields (*/*):

  - `supportToken` (string)
    Example: "1171c60d"