# Get Project Due Diligence Info

Returns a due diligence report listing the source and license information for all libraries in a project

Endpoint: GET /api/v2.0/projects/{projectToken}/libraries/licenses
Version: 3.0.1
Security: bearer-key

## Query parameters:

  - `pageSize` (string)
    Enter the number of items to return in each page of the result.

  - `page` (string)
    Enter the page number to display in the result. Page numbers start at 0

  - `search` (any)
    Filter your search to return items whose property has a specific value.
Use the syntax:  where a colon (:) separates between property, operation and value.
+ Property: the name of the property of the item
+ Operation:
    +  - true if the value is identical to this value.
    +  - true if the value is identical to one of the items in this comma-separated list. E.g. in:value1,value2,value3
    +  - true if the property's value is contained within this value
    +  - true if this regular expression resolves as true.
        The regex is not case sensitive, and special characters must be escaped with a backslash.
        Special characters include space, double quote ("), '', '#', '%', '{', '}', vertical bar ('|'), backslash, '^'.
        To pass an escaped character in a URL in Postman, encode it first.
        E.g. to return all items whose value begins with  or , use regex:^a
+ Value: the value of the property.

To combine multiple filters, separate each filter with a semicolon with no space. E.g.  property1:operation1:value1;property2:operation2:value2

This endpoint supports filtering on the following properties and its supported operators:
+ componentName[like | equals | regex]:value
+ copyrights[like | regex]:value
+ license[equals | in]:value
+ licenseRisk[equals | in]:value
+ licenseType[equals | in]:value

  - `sort` (any)
    Sort search results alphabetically on an item's property by entering  followed by the property name.
E.g. enter  to sort alphabetically by their email addresses from a-z ascending.To sort in descending order (z-a), add a minus sign ('-'). E.g. .

You can sort by the following properties:
+ componentName
+ copyrights
+ license
+ licenseRisk
+ licenseType

## Path parameters:

  - `projectToken` (string, required)
    project UUID (by running Entities - Product > Get Product Projects) or Project Token (from the Mend SCA App:  tab > ).

## Response 200 fields (application/json):

  - `additionalData` (object)
    + : The total count of data points returned in an API response.
+ : Defines whether the current page represents the conclusion of the API response. When “true”, this signifies you are viewing the last page of the API response. When “false”, this indicates there are further pages remaining.
    Example: {"totalItems":"422","isLastPage":"true"}

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

  - `retVal` (array)

  - `retVal.uuid` (string)

  - `retVal.name` (string)

  - `retVal.component` (object)

  - `retVal.component.description` (string)
    Example: "Component description"

  - `retVal.component.componentType` (string)
    Enum: "Library"

  - `retVal.component.type` (string)

  - `retVal.component.libraryType` (string)
    Example: "REDHAT_PACKAGE_MODULE"

  - `retVal.component.directDependency` (boolean)

  - `retVal.component.dependencyType` (string)
    Example: "Direct / Transitive"

  - `retVal.component.references` (object)

  - `retVal.component.references.url` (string)
    Example: "https://www.gnupg.org/related_software/pinentry/98"

  - `retVal.component.references.homePage` (string)
    Example: "https://www.gnupg.org/related_software/pinentry/89"

  - `retVal.component.references.downloadLink` (string)
    Example: "https://www.gnupg.org/related_software/pinentry/09"

  - `retVal.component.references.issueUrl` (string)
    Example: "https://www.gnupg.org/related_software/pinentry/87"

  - `retVal.component.references.pomUrl` (string)
    Example: "https://www.gnupg.org/related_software/pinentry/76"

  - `retVal.component.references.scmUrl` (string)
    Example: "https://www.gnupg.org/related_software/pinentry/65"

  - `retVal.component.references.genericPackageIndex` (string)
    Example: "5"

  - `retVal.component.references.nugetGallery` (string)

  - `retVal.component.references.tags` (string)
    Example: "Important"

  - `retVal.component.references.copyright` (string)
    Example: "Copyright 2002-2015 g10 Code GmbH"

  - `retVal.component.references.hasNotice` (boolean)

  - `retVal.component.groupId` (string)
    Example: "org.springframework.boot"

  - `retVal.component.artifactId` (string)
    Example: "spring-boot"

  - `retVal.component.version` (string)
    Example: "3.0.5"

  - `retVal.license` (object)

  - `retVal.license.liabilityReference` (string)
    Example: "https://repo.maven.apache.org/maven2/org/jruby/ext/posix/jna-posix/1.0.3/jna-posix-1.0.3.pom"

  - `retVal.license.assignedBy` (object)

  - `retVal.license.assignedBy.email` (string)
    Example: "jon.smith@mail.com"

  - `retVal.license.assignedBy.userType` (string)
    Enum: "REGULAR", "SERVICE", "SCAN_SUMMARY_RECEIVER"

  - `retVal.license.assignedBy.accountStatus` (string)
    Enum: "ACTIVE", "INACTIVE", "LOCKOUT"

  - `retVal.license.textUrl` (string)

  - `retVal.license.customDisclaimer` (string)

  - `retVal.license.information` (string)
    Example: "distribution=repo&remoteUrl=https://repo.maven.apache.org/maven2/org/jruby/ext/posix/jna-posix/1.0.3/jna-posix-1.0.3.pom"

  - `retVal.riskScore` (object)

  - `retVal.riskScore.explanation` (string)
    Example: "http://en.wikipedia.org/wiki/Academic_Free_License"

  - `retVal.riskScore.indicatingText` (string)
    Example: "1) Grant of Copyright License..."

  - `retVal.copyrights` (array)
    Example: ["Copyright 2010 Cloud Conscious, LLC"]

  - `retVal.extraData` (object)

  - `retVal.extraData.homepage` (string)
    Example: "https://api.github.com/repos/SR-dude/AvP-Wine/zipball/original"

  - `retVal.extraData.authors` (array)

  - `retVal.extraData.authors.author` (string)
    Example: "The Apache Software Foundation"

  - `retVal.extraData.authors.authorUrl` (string)
    Example: "http://www.apache.org/"

  - `retVal.project` (object)

  - `retVal.project.path` (string)
    Example: "My Product"

  - `retVal.project.productName` (string)
    Example: "My Product"

  - `retVal.project.productUuid` (string)
    Example: "123e4567-e89b-12d3-a456-426655440000"

  - `retVal.techTags` (array)

  - `retVal.purl` (string)

## Response 400 fields (*/*):

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

## Response 403 fields (*/*):

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