Reporting API (v1)

This document uses the v1 API. For more details, see the v1 API.

Get list of issues

Returns any issues that are present during the specified timeframe. For example, if an issue from 2018 is still considered a vulnerable today, it will show up in all reports from its inception to the current day. This data can take up to 9 hours to refresh.Note: A vulnerability that was introduced and then resolved on the same day will not show up in the response.

Required permissions

• View Project for every Organization in filters.orgs

• View Organization Reports for every Organization in filters.orgs

post

/reporting/issues

Query parameters

fromstringrequired

The date you wish to fetch results from, in the format YYYY-MM-DD

Example: 2017-07-01

tostringrequired

The date you wish to fetch results until, in the format YYYY-MM-DD

Example: 2017-07-07

pagenumber · double

The page of results to request

Example: 1

perPagenumber · double

The number of results to return per page (Maximum: 1000)

Example: 100

sortByall of

The key to sort results by

orderstring

The direction to sort results.

Example: asc

groupByall of

Set to issue to group the same issue in multiple projects

Body

filtersfilters6

any

Example: {"filters":{"identifier":"","ignored":false,"patched":false,"fixable":false,"isFixed":false,"isUpgradable":false,"isPatchable":false,"isPinnable":false,"orgs":[],"severity":["critical","high","medium","low"],"exploitMaturity":["mature","proof-of-concept","no-known-exploit","no-data"],"types":["vuln","license","configuration"],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[],"issues":[],"priorityScore":{"min":0,"max":1000}}}

Responses

application/json; charset=utf-8

application/json; charset=utf-8

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/reporting/issues?from=2017-07-01&to=2017-07-07' \
  --header 'Content-Type: application/json' \
  --data '{"filters":{"identifier":"","ignored":false,"patched":false,"fixable":false,"isFixed":false,"isUpgradable":false,"isPatchable":false,"isPinnable":false,"orgs":[],"severity":["critical","high","medium","low"],"exploitMaturity":["mature","proof-of-concept","no-known-exploit","no-data"],"types":["vuln","license","configuration"],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[],"issues":[],"priorityScore":{"min":0,"max":1000}}}'

200

400

200

{
  "total": 1,
  "results": [
    [
      {
        "url": "text",
        "id": "text",
        "name": "text",
        "source": "text",
        "packageManager": "text",
        "targetFile": "text"
      }
    ]
  ]
}

Get list of latest issues

Returns issues currently in existence. This data can take up to 9 hours to refresh

Required permissions

• View Project for every Organization in filters.orgs

• View Organization Reports for every Organization in filters.orgs

post

/reporting/issues/latest

Query parameters

pagenumber · double

The page of results to request

Example: 1

perPagenumber · double

The number of results to return per page (Maximum: 1000)

Example: 100

sortByall of

The key to sort results by

orderstring

The direction to sort results.

Example: asc

groupByall of

Set to issue to group the same issue in multiple projects

Body

filtersfilters6

any

Example: {"filters":{"identifier":"","ignored":false,"patched":false,"fixable":false,"isFixed":false,"isUpgradable":false,"isPatchable":false,"isPinnable":false,"orgs":[],"severity":["critical","high","medium","low"],"exploitMaturity":["mature","proof-of-concept","no-known-exploit","no-data"],"types":["vuln","license","configuration"],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[],"issues":[],"priorityScore":{"min":0,"max":1000}}}

Responses

application/json; charset=utf-8

application/json; charset=utf-8

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/reporting/issues/latest' \
  --header 'Content-Type: application/json' \
  --data '{"filters":{"identifier":"","ignored":false,"patched":false,"fixable":false,"isFixed":false,"isUpgradable":false,"isPatchable":false,"isPinnable":false,"orgs":[],"severity":["critical","high","medium","low"],"exploitMaturity":["mature","proof-of-concept","no-known-exploit","no-data"],"types":["vuln","license","configuration"],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[],"issues":[],"priorityScore":{"min":0,"max":1000}}}'

200

400

200

{
  "total": 1,
  "results": [
    [
      {
        "url": "text",
        "id": "text",
        "name": "text",
        "source": "text",
        "packageManager": "text",
        "targetFile": "text"
      }
    ]
  ]
}

Get test counts

Returns the number of tests conducted within a time frame. This data is updated in real time

Required permissions

• View Project for every Organization in filters.orgs

• View Organization Reports for every Organization in filters.orgs

post

/reporting/counts/tests

Query parameters

fromstringrequired

The date you wish to count tests from, in the format YYYY-MM-DD

Example: 2017-07-01

tostringrequired

The date you wish to count tests until, in the format YYYY-MM-DD

Example: 2017-07-03

groupByall of

The field to group results by

Body

filtersfilters9

any

Example: {"filters":{"isPrivate":false,"issuesPrevented":false,"orgs":[],"projects":[]}}

Responses

application/json; charset=utf-8

application/json; charset=utf-8

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/reporting/counts/tests?from=2017-07-01&to=2017-07-03' \
  --header 'Content-Type: application/json' \
  --data '{"filters":{"isPrivate":false,"issuesPrevented":false,"orgs":[],"projects":[]}}'

200

400

200

{
  "results": [
    {
      "count": 0,
      "isPrivate": {
        "true": 0,
        "false": 0
      }
    }
  ]
}

Get project counts

Returns project counts within a time frame. This data can take up to 9 hours to refresh

Required permissions

• View Project for every Organization in filters.orgs

• View Organization Reports for every Organization in filters.orgs

post

/reporting/counts/projects

Query parameters

fromstringrequired

The date you wish to fetch results from, in the format YYYY-MM-DD

Example: 2017-07-01

tostringrequired

The date you wish to fetch results until, in the format YYYY-MM-DD

Example: 2017-07-03

Body

filtersfilters8

any

Example: {"filters":{"orgs":[],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[]}}

Responses

application/json; charset=utf-8

application/json; charset=utf-8

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/reporting/counts/projects?from=2017-07-01&to=2017-07-03' \
  --header 'Content-Type: application/json' \
  --data '{"filters":{"orgs":[],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[]}}'

200

400

200

{
  "results": [
    {
      "day": "2017-07-01",
      "count": 0
    },
    {
      "day": "2017-07-02",
      "count": 0
    },
    {
      "day": "2017-07-03",
      "count": 0
    }
  ]
}

Get latest project counts

Returns the number of projects currently in existence. This data can take up to 9 hours to refresh.

• Params#### Required permissions

• View Project for every Organization in filters.orgs

• View Organization Reports for every Organization in filters.orgs

post

/reporting/counts/projects/latest

Body

filtersfilters8

any

Example: {"filters":{"orgs":[],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[]}}

Responses

application/json; charset=utf-8

application/json; charset=utf-8

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/reporting/counts/projects/latest' \
  --header 'Content-Type: application/json' \
  --data '{"filters":{"orgs":[],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[]}}'

200

400

200

{
  "results": [
    {
      "day": "2017-07-01",
      "count": 0
    }
  ]
}

Get issue counts

Returns issue counts within a time frame. This data can take up to 9 hours to refresh

Required permissions

• View Project for every Organization in filters.orgs

• View Organization Reports for every Organization in filters.orgs

post

/reporting/counts/issues

Query parameters

fromstringrequired

The date you wish to fetch results from, in the format YYYY-MM-DD

Example: 2017-07-01

tostringrequired

The date you wish to fetch results until, in the format YYYY-MM-DD

Example: 2017-07-03

groupByall of

The field to group results by

Body

filtersfilters7

any

Example: {"filters":{"ignored":false,"patched":false,"fixable":false,"isUpgradable":false,"isPatchable":false,"isPinnable":false,"orgs":[],"severity":["critical","high","medium","low"],"types":["vuln","license","configuration"],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[],"priorityScore":{"min":0,"max":1000}}}

Responses

application/json; charset=utf-8

application/json; charset=utf-8

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/reporting/counts/issues?from=2017-07-01&to=2017-07-03' \
  --header 'Content-Type: application/json' \
  --data '{"filters":{"ignored":false,"patched":false,"fixable":false,"isUpgradable":false,"isPatchable":false,"isPinnable":false,"orgs":[],"severity":["critical","high","medium","low"],"types":["vuln","license","configuration"],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[],"priorityScore":{"min":0,"max":1000}}}'

200

400

200

{
  "results": [
    {
      "day": "2017-07-01",
      "count": 0,
      "severity": {
        "critical": 0,
        "high": 0,
        "medium": 0,
        "low": 0
      }
    },
    {
      "day": "2017-07-02",
      "count": 0,
      "severity": {
        "critical": 0,
        "high": 0,
        "medium": 0,
        "low": 0
      }
    },
    {
      "day": "2017-07-03",
      "count": 0,
      "severity": {
        "critical": 0,
        "high": 0,
        "medium": 0,
        "low": 0
      }
    }
  ]
}

Get latest issue counts

Returns the number of issues currently in existence. This data can take up to 9 hours to refresh

Required permissions

• View Project for every Organization in filters.orgs

• View Organization Reports for every Organization in filters.orgs

post

/reporting/counts/issues/latest

Query parameters

groupByall of

The field to group results by

Body

filtersfilters7

any

Example: {"filters":{"ignored":false,"patched":false,"fixable":false,"isUpgradable":false,"isPatchable":false,"isPinnable":false,"orgs":[],"severity":["critical","high","medium","low"],"types":["vuln","license","configuration"],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[],"priorityScore":{"min":0,"max":1000}}}

Responses

application/json; charset=utf-8

application/json; charset=utf-8

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.snyk.io/v1/reporting/counts/issues/latest' \
  --header 'Content-Type: application/json' \
  --data '{"filters":{"ignored":false,"patched":false,"fixable":false,"isUpgradable":false,"isPatchable":false,"isPinnable":false,"orgs":[],"severity":["critical","high","medium","low"],"types":["vuln","license","configuration"],"languages":["node","javascript","ruby","java","scala","python","golang","php","dotnet","swift-objective-c","elixir","docker","linux","dockerfile"],"projects":[],"priorityScore":{"min":0,"max":1000}}}'

200

400

200

{
  "results": [
    {
      "day": "2017-07-01",
      "count": 0,
      "severity": {
        "critical": 0,
        "high": 0,
        "medium": 0,
        "low": 0
      }
    }
  ]
}