Dependencies (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.

Dependencies are packages or modules that your Projects depend on.

The rate limit is up to 150 requests per minute, per user.

List all dependencies

post

Dependencies are packages/modules that your projects depend on. Current rate limit is up to 150 requests per minute, per user.

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

sortBystring · enumoptional

The field to sort results by.

Example: dependency

Available options:

orderstring · enumoptional

The direction to sort results by.

Available options:

pagenumber · doubleoptional

The page of results to fetch.

perPagenumber · doubleoptional

The number of results to fetch per page (maximum is 1000).

Body

filtersobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/org/{orgId}/dependencies' \
  --header 'Content-Type: application/json' \
  --data '{
    "filters": {
      "languages": [
        "cpp",
        "dockerfile",
        "dotnet",
        "elixir",
        "golang",
        "helm",
        "java",
        "javascript",
        "kubernetes",
        "linux",
        "php",
        "python",
        "ruby",
        "scala",
        "swift",
        "terraform"
      ],
      "projects": [],
      "dependencies": [],
      "licenses": [],
      "severity": [
        "critical",
        "high",
        "medium",
        "low"
      ],
      "depStatus": ""
    }
  }'

200

200

{
  "results": [
    {
      "id": "[email protected]",
      "name": "gulp",
      "version": "3.9.1",
      "latestVersion": "4.0.0",
      "latestVersionPublishedDate": "2018-01-01T01:29:06.863Z",
      "firstPublishedDate": "2013-07-04T23:27:07.828Z",
      "isDeprecated": false,
      "deprecatedVersions": [
        "0.0.1",
        "0.0.2",
        "0.0.3"
      ],
      "licenses": [
        {
          "id": "snyk:lic:npm:gulp:MIT",
          "title": "MIT license",
          "license": "MIT"
        }
      ],
      "dependenciesWithIssues": [
        "[email protected]",
        "[email protected]"
      ],
      "type": "npm",
      "projects": [
        {
          "name": "atokeneduser/goof",
          "id": "6d5813be-7e6d-4ab8-80c2-1e3e2a454545"
        }
      ]
    }
  ],
  "total": 1
}