Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Cve Security Com Package API
version: 1.9.1
contact:
url: https://cve-security.com/api
license:
name: 'Scoreboard data: CC BY 4.0. Underlying sources retain their own licenses (see /sources).'
identifier: CC-BY-4.0
description: 'Operations tagged Package across 2 of this provider''s published API definitions: cve-security-com-openapi.json, cve-security-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://cve-security.com
tags:
- name: Package
paths:
/api/package/{ecosystem}/{name}:
get:
operationId: queryPackage
summary: CVEs affecting one open-source package (ranges verbatim)
description: 'CVE list for a package, KEV-first, with each OSV version range verbatim: `events` plus one render-safe projection per range, `fixed` (the upgrade targets) or `affected_through` (the last vulnerable version, so upgrade past it). No version-membership evaluation is performed server-side; compare versions with your ecosystem''s own semantics. {ecosystem} is the purl type (npm, pypi, maven, golang, cargo, composer, gem, nuget, …) or the OSV display name; {name} is the package name and may itself contain slashes (@scope/name, Go module paths, composer vendor/name, percent-encoding optional) or a Maven group:artifact. Alternatively pass ?purl=pkg:npm/lodash and any path is ignored. Covers CVE-linked, GitHub-reviewed OSS advisories via OSV.dev; absence is not evidence of safety. Keyless twin: MCP tool `query_package`.'
security:
- bearer: []
- apiKey: []
parameters:
- name: ecosystem
in: path
required: true
schema:
type: string
example: npm
- name: name
in: path
required: true
schema:
type: string
example: lodash
- name: purl
in: query
required: false
schema:
type: string
example: pkg:maven/org.apache.logging.log4j/log4j-core
responses:
'200':
description: package{ecosystem,name,purl,key}, cve_count, cves[]{cve_id, url, title, severity, cvss, epss, cisa_kev, known_ransomware_use, published, advisory, advisory_url, ranges[]{type, events, fixed?|affected_through?}}, _meta{source, attribution, absence_semantics}.
'400':
description: invalid_package, neither a parseable purl nor a known ecosystem+name.
'404':
description: No CVE-linked OSV advisory in our data maps to this package. Absence in our data is not evidence of safety.
tags:
- Package
servers:
- url: https://cve-security.com
components:
securitySchemes:
bearer:
type: http
scheme: bearer
description: 'Authorization: Bearer cvs_live_…'
apiKey:
type: apiKey
in: header
name: X-API-Key
description: Alternative to the Authorization header. Keys are never accepted in query strings.
x-refined-from:
- cve-security-com-openapi.json
- cve-security-com-openapi.yml