Skip to main content
Errors use standard HTTP status codes and a consistent JSON body:
details is only present for some errors. Include request_id (also sent as the X-Request-Id header) when contacting support.

Error codes

Packages that do not exist

A package_not_found error is a useful result on its own. AI coding assistants sometimes suggest packages that do not exist, and attackers register those names. Treat a missing package as a reason to stop, not to retry. Registries delete malware once it is reported, so a lockfile can pin a version that no longer exists. If OSV lists the missing package or version as malicious, you get a normal 200 report with verdict: "malicious" instead of a 404. See Check a package.