Licenses (v1)

This document uses the v1 API, which will eventually be deprecated, as further Snyk developments are now focused on the REST API. For more details, see the v1 API.

Note: When you import or update Projects, changes will be reflected in the endpoint results after a one-hour delay.

List all licenses

post

Required permissions

• View Organization
• View Project
• View Project Snapshot

Path parameters

orgIdstringrequired

The organization ID to list projects for. The API_KEY must have access to this organization.

Example: 4a18d42f-0706-4ad0-b127-24078731fbed

Query parameters

sortByall ofoptional

The field to sort results by.

The field to sort results by.

orderall ofoptional

The direction to sort results by.

The direction to sort results by.

Body

filtersobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/org/{orgId}/licenses' \
  --header 'Content-Type: application/json' \
  --data '{
    "filters": {
      "languages": [
        "node",
        "ruby",
        "java",
        "cpp"
      ],
      "projects": [],
      "dependencies": [],
      "licenses": [],
      "severity": [
        "none",
        "high",
        "medium",
        "low"
      ]
    }
  }'

200

200

{
  "results": [
    {
      "id": "MIT",
      "severity": "none",
      "instructions": "",
      "dependencies": [
        {
          "id": "[email protected]",
          "name": "accepts",
          "version": "1.0.0",
          "packageManager": "npm"
        }
      ],
      "projects": [
        {
          "name": "atokeneduser/goof",
          "id": "6d5813be-7e6d-4ab8-80c2-1e3e2a454545"
        }
      ]
    }
  ],
  "total": 1
}