# OSV Dependency Vulnerability Audit

> OSV Dependency Vulnerability Audit is a paid API for AI agents from x402-datashop-production.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Checks a single package version against OSV.dev's aggregated vulnerability database and returns vuln count, max severity, advisory IDs, and fix versions

## Facts

- Endpoint: GET https://x402-datashop-production.up.railway.app/v1/dev/vulns
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/osv-dependency-vulnerability-audit-80f691da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ym_dCfFxgLQZut7HYQh9g

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability osv-dependency-vulnerability-audit-80f691da
```

Example prompt: Can you check if lodash version 4.17.20 on npm has any known security vulnerabilities — I need the vuln count, worst severity, and any advisory IDs with their fix versions?

## When to prefer this

Use this endpoint when you need a fast, per-version security verdict for a specific dependency before installing or shipping it. It is ideal for CI/CD checks, dependency review workflows, or any agent that needs to validate a known package version against public advisories. Prefer this over full SCA tools when you have an exact version and need a quick authoritative answer backed by OSV.dev's aggregated database (GHSA, PyPA, RustSec, etc.) across 10 major ecosystems.

## Known failure modes

- Unknown or misspelled package name returns vuln_count=0 (clean) which may be a false negative — verify package name spelling
- Unsupported ecosystem value returns a 400 or validation error
- Very new advisories may not yet be reflected due to 1-hour cache
- Unlisted or private package versions may return no results
- Missing required pkg or version query params returns an error response

## How this service works

Security audit of one exact dependency version, backed by OSV.dev (Google), which aggregates public advisories (GHSA, PyPA, RustSec...) in near real time. Query: ?pkg=lodash&ecosystem=npm&version=4.17.20 (ecosystems: npm, pypi, go, crates.io, maven, nuget, rubygems, packagist, hex, pub). Returns vuln_count, max_severity, advisory ids and the versions that fix them; vuln_count=0 means clean. Cached 1h.

## Output

Returns a JSON object with vuln_count (integer, 0 = clean), max_severity (e.g. HIGH, CRITICAL), a list of advisory IDs (e.g. GHSA-xxx, CVE-xxx), and the versions that fix each vulnerability. Results are cached for 1 hour.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "pkg",
      "version"
     ],
     "properties": {
      "pkg": {
       "type": "string",
       "description": "Exact package name, e.g. lodash"
      },
      "version": {
       "type": "string",
       "description": "Exact version to audit, e.g. 4.17.20"
      },
      "ecosystem": {
       "enum": [
        "cargo",
        "crates.io",
        "go",
        "hex",
        "maven",
        "npm",
        "nuget",
        "packagist",
        "pub",
        "pypi",
        "rubygems"
       ],
       "type": "string",
       "default": "npm",
       "description": "Package ecosystem"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/osv-dependency-vulnerability-audit-80f691da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-datashop-production.up.railway.app](https://www.zero.xyz/host/x402-datashop-production.up.railway.app/llms.txt)