Returns a list of all policies | Dependency-Track unofficial

6 parameters

pageNumberstringoptional

The page to return. To be used in conjunction with <code>pageSize</code>.

Default:1

pageSizestringoptional

Number of elements to return per page. To be used in conjunction with <code>pageNumber</code>.

Default:100

offsetstringoptional

Offset to start returning elements from. To be used in conjunction with <code>limit</code>.

limitstringoptional

Number of elements to return per page. To be used in conjunction with <code>offset</code>.

sortNamestringoptional

Name of the resource field to sort on.

sortOrderstringoptional

Ordering of items when sorting with <code>sortName</code>.

Allowed:asc, desc

2 status codes

200A list of all policies

globalbooleanoptional

includeChildrenbooleanoptional

invertTagMatchbooleanoptional

namestringrequired

onlyLatestProjectVersionbooleanoptional

operatorstringrequired

Allowed:ALLANY

policyConditionsarray<object>optional

projectsarray<object>optional

tagsarray<object>optional

uuidstringrequired

violationStatestringrequired

Allowed:INFOWARNFAIL

401Unauthorized

Error handling

A 401 is returned: Unauthorized.

import { Client } from "dependency-track-unofficial-sdk";

const client = new Client({
  baseUrl: "http://localhost:8081/api",
  auth: { apiKey: process.env.API_KEY },
});

const result = await client.policy.list({
  pageNumber: 1,
  pageSize: 20,
  offset: 0,
  limit: 20,
  sortName: "Untitled",
});

[
  {
    "global": true,
    "includeChildren": true,
    "invertTagMatch": true,
    "name": "Example Name",
    "onlyLatestProjectVersion": true,
    "operator": "ALL",
    "policyConditions": [
      {
        "operator": "IS",
        "policy": {
          "global": true,
          "includeChildren": true,
          "invertTagMatch": true,
          "name": "Example Name",
          "onlyLatestProjectVersion": true,
          "operator": "ALL",
          "policyConditions": [
            {
              "operator": null,
              "policy": null,
              "subject": null,
              "uuid": null,
              "value": null,
              "violationType": null
            }
          ],
          "projects": [
            {
              "accessTeams": null,
              "active": null,
              "author": null,
              "authors": null,
              "bomRef": null,
              "children": null,
              "classifier": null,
              "collectionLogic": null,
              "collectionTag": null,
              "cpe": null,
              "description": null,
              "directDependencies": null,
              "externalReferences": null,
              "group": null,
              "inactiveSince": null,
              "isLatest": null,
              "lastBomImport": null,
              "lastBomImportFormat": null,
              "lastInheritedRiskScore": null,
              "lastVulnerabilityAnalysis": null,
              "manufacturer": null,
              "metadata": null,
              "metrics": null,
              "name": null,
              "parent": null,
              "publisher": null,
              "purl": null,
              "supplier": null,
              "swidTagId": null,
              "tags": null,
              "uuid": null,
              "version": null,
              "versions": null
            }
          ],
          "tags": [
            {
              "name": null
            }
          ],
          "uuid": "550e8400-e29b-41d4-a716-446655440000",
          "violationState": "INFO"
        },
        "subject": "AGE",
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "value": "example_value",
        "violationType": "LICENSE"
      }
    ],
    "projects": [
      {
        "accessTeams": [
          {
            "apiKeys": [
              null
            ],
            "ldapUsers": [
              null
            ],
            "managedUsers": [
              null
            ],
            "mappedLdapGroups": [
              null
            ],
            "mappedOidcGroups": [
              null
            ],
            "name": "Example Name",
            "oidcUsers": [
              null
            ],
            "permissions": [
              null
            ],
            "serviceAccounts": [
              null
            ],
            "uuid": "550e8400-e29b-41d4-a716-446655440000"
          }
        ],
        "active": true,
        "author": "example_value",
        "authors": [
          {
            "email": "user@example.com",
            "name": "Example Name",
            "phone": "+44 7700 900123"
          }
        ],
        "bomRef": "example_value",
        "children": [
          {
            "accessTeams": [
              null
            ],
            "active": true,
            "author": "example_value",
            "authors": [
              null
            ],
            "bomRef": "example_value",
            "children": [
              null
            ],
            "classifier": "APPLICATION",
            "collectionLogic": "AGGREGATE_DIRECT_CHILDREN",
            "collectionTag": {
              "name": null
            },
            "cpe": "example_value",
            "description": "Example description",
            "directDependencies": "example_value",
            "externalReferences": [
              null
            ],
            "group": "example_value",
            "inactiveSince": 1,
            "isLatest": true,
            "lastBomImport": 1,
            "lastBomImportFormat": "example_value",
            "lastInheritedRiskScore": 1,
            "lastVulnerabilityAnalysis": 1,
            "manufacturer": {
              "contacts": null,
              "name": null,
              "urls": null
            },
            "metadata": {
              "authors": null,
              "supplier": null,
              "tools": null
            },
            "metrics": {
              "components": null,
              "critical": null,
              "findingsAudited": null,
              "findingsTotal": null,
              "findingsUnaudited": null,
              "firstOccurrence": null,
              "high": null,
              "inheritedRiskScore": null,
              "kev": null,
              "lastOccurrence": null,
              "low": null,
              "medium": null,
              "policyViolationsAudited": null,
              "policyViolationsFail": null,
              "policyViolationsInfo": null,
              "policyViolationsLicenseAudited": null,
              "policyViolationsLicenseTotal": null,
              "policyViolationsLicenseUnaudited": null,
              "policyViolationsOperationalAudited": null,
              "policyViolationsOperationalTotal": null,
              "policyViolationsOperationalUnaudited": null,
              "policyViolationsSecurityAudited": null,
              "policyViolationsSecurityTotal": null,
              "policyViolationsSecurityUnaudited": null,
              "policyViolationsTotal": null,
              "policyViolationsUnaudited": null,
              "policyViolationsWarn": null,
              "suppressed": null,
              "unassigned": null,
              "vulnerabilities": null,
              "vulnerableComponents": null
            },
            "name": "Example Name",
            "parent": {
              "accessTeams": null,
              "active": null,
              "author": null,
              "authors": null,
              "bomRef": null,
              "children": null,
              "classifier": null,
              "collectionLogic": null,
              "collectionTag": null,
              "cpe": null,
              "description": null,
              "directDependencies": null,
              "externalReferences": null,
              "group": null,
              "inactiveSince": null,
              "isLatest": null,
              "lastBomImport": null,
              "lastBomImportFormat": null,
              "lastInheritedRiskScore": null,
              "lastVulnerabilityAnalysis": null,
              "manufacturer": null,
              "metadata": null,
              "metrics": null,
              "name": null,
              "parent": null,
              "publisher": null,
              "purl": null,
              "supplier": null,
              "swidTagId": null,
              "tags": null,
              "uuid": null,
              "version": null,
              "versions": null
            },
            "publisher": "example_value",
            "purl": "https://example.com",
            "supplier": {
              "contacts": null,
              "name": null,
              "urls": null
            },
            "swidTagId": "550e8400-e29b-41d4-a716-446655440000",
            "tags": [
              null
            ],
            "uuid": "550e8400-e29b-41d4-a716-446655440000",
            "version": "example_value",
            "versions": [
              null
            ]
          }
        ],
        "classifier": "APPLICATION",
        "collectionLogic": "AGGREGATE_DIRECT_CHILDREN",
        "collectionTag": {
          "name": "Example Name"
        },
        "cpe": "example_value",
        "description": "Example description",
        "directDependencies": "example_value",
        "externalReferences": [
          {
            "comment": "example_value",
            "type": "vcs",
            "url": "https://example.com"
          }
        ],
        "group": "example_value",
        "inactiveSince": 1,
        "isLatest": true,
        "lastBomImport": 1,
        "lastBomImportFormat": "example_value",
        "lastInheritedRiskScore": 1,
        "lastVulnerabilityAnalysis": 1,
        "manufacturer": {
          "contacts": [
            {
              "email": null,
              "name": null,
              "phone": null
            }
          ],
          "name": "Example Name",
          "urls": [
            "https://example.com"
          ]
        },
        "metadata": {
          "authors": [
            {
              "email": null,
              "name": null,
              "phone": null
            }
          ],
          "supplier": {
            "contacts": [
              null
            ],
            "name": "Example Name",
            "urls": [
              null
            ]
          },
          "tools": {
            "components": [
              null
            ],
            "services": [
              null
            ]
          }
        },
        "metrics": {
          "components": 1,
          "critical": 1,
          "findingsAudited": 1,
          "findingsTotal": 42,
          "findingsUnaudited": 1,
          "firstOccurrence": 1,
          "high": 1,
          "inheritedRiskScore": 1,
          "kev": 1,
          "lastOccurrence": 1,
          "low": 1,
          "medium": 1,
          "policyViolationsAudited": 1,
          "policyViolationsFail": 1,
          "policyViolationsInfo": 1,
          "policyViolationsLicenseAudited": 1,
          "policyViolationsLicenseTotal": 42,
          "policyViolationsLicenseUnaudited": 1,
          "policyViolationsOperationalAudited": 1,
          "policyViolationsOperationalTotal": 42,
          "policyViolationsOperationalUnaudited": 1,
          "policyViolationsSecurityAudited": 1,
          "policyViolationsSecurityTotal": 42,
          "policyViolationsSecurityUnaudited": 1,
          "policyViolationsTotal": 42,
          "policyViolationsUnaudited": 1,
          "policyViolationsWarn": 1,
          "suppressed": 1,
          "unassigned": 1,
          "vulnerabilities": 1,
          "vulnerableComponents": 1
        },
        "name": "Example Name",
        "parent": {
          "accessTeams": [
            {
              "apiKeys": null,
              "ldapUsers": null,
              "managedUsers": null,
              "mappedLdapGroups": null,
              "mappedOidcGroups": null,
              "name": null,
              "oidcUsers": null,
              "permissions": null,
              "serviceAccounts": null,
              "uuid": null
            }
          ],
          "active": true,
          "author": "example_value",
          "authors": [
            {
              "email": null,
              "name": null,
              "phone": null
            }
          ],
          "bomRef": "example_value",
          "children": [
            {
              "accessTeams": null,
              "active": null,
              "author": null,
              "authors": null,
              "bomRef": null,
              "children": null,
              "classifier": null,
              "collectionLogic": null,
              "collectionTag": null,
              "cpe": null,
              "description": null,
              "directDependencies": null,
              "externalReferences": null,
              "group": null,
              "inactiveSince": null,
              "isLatest": null,
              "lastBomImport": null,
              "lastBomImportFormat": null,
              "lastInheritedRiskScore": null,
              "lastVulnerabilityAnalysis": null,
              "manufacturer": null,
              "metadata": null,
              "metrics": null,
              "name": null,
              "parent": null,
              "publisher": null,
              "purl": null,
              "supplier": null,
              "swidTagId": null,
              "tags": null,
              "uuid": null,
              "version": null,
              "versions": null
            }
          ],
          "classifier": "APPLICATION",
          "collectionLogic": "AGGREGATE_DIRECT_CHILDREN",
          "collectionTag": {
            "name": "Example Name"
          },
          "cpe": "example_value",
          "description": "Example description",
          "directDependencies": "example_value",
          "externalReferences": [
            {
              "comment": null,
              "type": null,
              "url": null
            }
          ],
          "group": "example_value",
          "inactiveSince": 1,
          "isLatest": true,
          "lastBomImport": 1,
          "lastBomImportFormat": "example_value",
          "lastInheritedRiskScore": 1,
          "lastVulnerabilityAnalysis": 1,
          "manufacturer": {
            "contacts": [
              null
            ],
            "name": "Example Name",
            "urls": [
              null
            ]
          },
          "metadata": {
            "authors": [
              null
            ],
            "supplier": {
              "contacts": null,
              "name": null,
              "urls": null
            },
            "tools": {
              "components": null,
              "services": null
            }
          },
          "metrics": {
            "components": 1,
            "critical": 1,
            "findingsAudited": 1,
            "findingsTotal": 42,
            "findingsUnaudited": 1,
            "firstOccurrence": 1,
            "high": 1,
            "inheritedRiskScore": 1,
            "kev": 1,
            "lastOccurrence": 1,
            "low": 1,
            "medium": 1,
            "policyViolationsAudited": 1,
            "policyViolationsFail": 1,
            "policyViolationsInfo": 1,
            "policyViolationsLicenseAudited": 1,
            "policyViolationsLicenseTotal": 42,
            "policyViolationsLicenseUnaudited": 1,
            "policyViolationsOperationalAudited": 1,
            "policyViolationsOperationalTotal": 42,
            "policyViolationsOperationalUnaudited": 1,
            "policyViolationsSecurityAudited": 1,
            "policyViolationsSecurityTotal": 42,
            "policyViolationsSecurityUnaudited": 1,
            "policyViolationsTotal": 42,
            "policyViolationsUnaudited": 1,
            "policyViolationsWarn": 1,
            "suppressed": 1,
            "unassigned": 1,
            "vulnerabilities": 1,
            "vulnerableComponents": 1
          },
          "name": "Example Name",
          "parent": {
            "accessTeams": [
              null
            ],
            "active": true,
            "author": "example_value",
            "authors": [
              null
            ],
            "bomRef": "example_value",
            "children": [
              null
            ],
            "classifier": "APPLICATION",
            "collectionLogic": "AGGREGATE_DIRECT_CHILDREN",
            "collectionTag": {
              "name": null
            },
            "cpe": "example_value",
            "description": "Example description",
            "directDependencies": "example_value",
            "externalReferences": [
              null
            ],
            "group": "example_value",
            "inactiveSince": 1,
            "isLatest": true,
            "lastBomImport": 1,
            "lastBomImportFormat": "example_value",
            "lastInheritedRiskScore": 1,
            "lastVulnerabilityAnalysis": 1,
            "manufacturer": {
              "contacts": null,
              "name": null,
              "urls": null
            },
            "metadata": {
              "authors": null,
              "supplier": null,
              "tools": null
            },
            "metrics": {
              "components": null,
              "critical": null,
              "findingsAudited": null,
              "findingsTotal": null,
              "findingsUnaudited": null,
              "firstOccurrence": null,
              "high": null,
              "inheritedRiskScore": null,
              "kev": null,
              "lastOccurrence": null,
              "low": null,
              "medium": null,
              "policyViolationsAudited": null,
              "policyViolationsFail": null,
              "policyViolationsInfo": null,
              "policyViolationsLicenseAudited": null,
              "policyViolationsLicenseTotal": null,
              "policyViolationsLicenseUnaudited": null,
              "policyViolationsOperationalAudited": null,
              "policyViolationsOperationalTotal": null,
              "policyViolationsOperationalUnaudited": null,
              "policyViolationsSecurityAudited": null,
              "policyViolationsSecurityTotal": null,
              "policyViolationsSecurityUnaudited": null,
              "policyViolationsTotal": null,
              "policyViolationsUnaudited": null,
              "policyViolationsWarn": null,
              "suppressed": null,
              "unassigned": null,
              "vulnerabilities": null,
              "vulnerableComponents": null
            },
            "name": "Example Name",
            "parent": {
              "accessTeams": null,
              "active": null,
              "author": null,
              "authors": null,
              "bomRef": null,
              "children": null,
              "classifier": null,
              "collectionLogic": null,
              "collectionTag": null,
              "cpe": null,
              "description": null,
              "directDependencies": null,
              "externalReferences": null,
              "group": null,
              "inactiveSince": null,
              "isLatest": null,
              "lastBomImport": null,
              "lastBomImportFormat": null,
              "lastInheritedRiskScore": null,
              "lastVulnerabilityAnalysis": null,
              "manufacturer": null,
              "metadata": null,
              "metrics": null,
              "name": null,
              "parent": null,
              "publisher": null,
              "purl": null,
              "supplier": null,
              "swidTagId": null,
              "tags": null,
              "uuid": null,
              "version": null,
              "versions": null
            },
            "publisher": "example_value",
            "purl": "https://example.com",
            "supplier": {
              "contacts": null,
              "name": null,
              "urls": null
            },
            "swidTagId": "550e8400-e29b-41d4-a716-446655440000",
            "tags": [
              null
            ],
            "uuid": "550e8400-e29b-41d4-a716-446655440000",
            "version": "example_value",
            "versions": [
              null
            ]
          },
          "publisher": "example_value",
          "purl": "https://example.com",
          "supplier": {
            "contacts": [
              null
            ],
            "name": "Example Name",
            "urls": [
              null
            ]
          },
          "swidTagId": "550e8400-e29b-41d4-a716-446655440000",
          "tags": [
            {
              "name": null
            }
          ],
          "uuid": "550e8400-e29b-41d4-a716-446655440000",
          "version": "example_value",
          "versions": [
            {
              "active": null,
              "isLatest": null,
              "uuid": null,
              "version": null
            }
          ]
        },
        "publisher": "example_value",
        "purl": "https://example.com",
        "supplier": {
          "contacts": [
            {
              "email": null,
              "name": null,
              "phone": null
            }
          ],
          "name": "Example Name",
          "urls": [
            "https://example.com"
          ]
        },
        "swidTagId": "550e8400-e29b-41d4-a716-446655440000",
        "tags": [
          {
            "name": "Example Name"
          }
        ],
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "version": "example_value",
        "versions": [
          {
            "active": true,
            "isLatest": true,
            "uuid": "550e8400-e29b-41d4-a716-446655440000",
            "version": "example_value"
          }
        ]
      }
    ],
    "tags": [
      {
        "name": "Example Name"
      }
    ],
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "violationState": "INFO"
  }
]

Request

Response

Errors