API Resources

POST
/v3/purls

PURLのリストに関連する脆弱性をリクエストする(1回のリクエストにつき最大100件)

指定されたPURLに基づいて、このエンドポイントは関連する脆弱性を含むPURLのリストを返します。

サポートされているパッケージマネージャのリストはこちらで確認できます。

1回のリクエストで送信できるPURLは最大 100 件です。これを超えるリクエストは 400 で拒否されます。詳細はエラーを参照してください。100件を超えるPURLを検索する場合は、100件以下のバッチに分割し、バッチごとにリクエストを送信してください。

リクエストボディ

purls
list required
Package URL Schemes。1回のリクエストにつき最大 100 件です。

リクエスト例

curl --request POST \
  --url https://api.vulncheck.com/v3/purls \
  --header 'Authorization: Bearer insert_token_here' \
  --data '[
  "pkg:hex/coherence@0.1.2",
  "pkg:conan/assimp@5.1.0",
  "pkg:conan/crossguid@0.2.2",
]'

レスポンス

{
  "_benchmark": 0.173334,
  "_meta": {
    "timestamp": "2025-12-12T21:22:37.41976683Z",
    "total_documents": 1
  },
  "data": [
    {
      "purl": "pkg:hex/coherence@0.1.2",
      "purl_struct": {
        "type": "hex",
        "namespace": "",
        "name": "coherence",
        "version": "0.1.2",
        "qualifiers": null,
        "subpath": ""
      },
      "cves": [
        "CVE-2018-20301"
      ],
      "vulnerabilities": [
        {
          "detection": "CVE-2018-20301",
          "fixed_version": "0.5.2"
        }
      ]
    }
  ]
}

エラー

PURLが100件を超えるリクエストは 400 を返します。たとえば、101件のPURLを送信した場合は次のレスポンスが返されます:

{
  "error": true,
  "errors": [
    "101 > max size 100: too many purls"
  ]
}