OpenAI is partnering with Hacktron to find vulnerabilities in its systems. Read the announcement.

Skip to content Hacktron Sign in [S]
Hacktron Sign in [S] Customers Blog Docs Contact Sign in

Get package verdict

1 min
, View, ChatGPT, Claude, Perplexity, OpenAPI

Copy page

Get package verdict

View MarkdownOpen in ChatGPTOpen in ClaudeOpen in PerplexityDownload OpenAPI

Returns a fast dependency verdict for a single package. GitHub Action scans use it to flag known-malicious dependencies. The package version is a query parameter.

For scoped npm packages, such as @scope/name, use GET /hfw/verdict/{ecosystem}/{scope}/{packageName} instead.

This is a public, fast-mode endpoint. It covers feed-backed verdicts only and normally returns straight away. To wait briefly for an upstream verdict, set wait_seconds. It may move behind the X-Api-Key header later.

Request

GET /hfw/verdict/{ecosystem}/{packageName}

This endpoint takes no API key.

Path parameters

ParameterDescription
ecosystem
string, required
One of npm or pypi.
packageName
string, required

Query parameters

ParameterDescription
version
string, required
Package version to check.
wait_seconds
number
Seconds to wait for an upstream verdict. Fast mode normally returns immediately. Default 0. At least 0. At most 8.

Responses

200 OK

FieldDescription
status
string, required
One of ready, pending, or scanning.
ecosystem
string, required
One of npm or pypi.
package
string, required
version
string, required
level
string, required
One of clean, suspicious, malicious, or unknown.
confidence
string, required
summary
string, required
findings
array of object, required
source
string
osv_id
string
[↓] [↑] [enter] to visit
Menu
[M]
Next in menu
[J]
Previous in menu
[K]
Find
[F]
Ask
[A]
Sign in
[S]
Copy page
[C]
Listen
[L]
Justification
[R]
Language
[G]
Dark mode
[D]
High contrast
[H]
Shortcuts
[I]
Close
[Esc]