{"openapi":"3.1.0","info":{"title":"cve.now API","version":"1.0.0","description":"The REST twin of every cve.now MCP tool: the same inputs and the same JSON. No key needed; a cve.now API key (Authorization: Bearer cvn_...) gives a per-key rate limit instead of the shared per-IP one.","contact":{"url":"https://cve.now/developers"}},"servers":[{"url":"https://cve.now"}],"paths":{"/api/v1/entries/{id}":{"get":{"operationId":"get_vulnerability","summary":"Get vulnerability","description":"Get one vulnerability entry by CVE, GHSA or OSV id, as JSON. Includes CISA SSVC decision points (exploitation, automatable, technicalImpact) when CISA published them, and, when cve.now has read the vendor advisory, context (a plain sentence, sourced conditions, vendor severity, fix, FAQ) with exposure: Actively exploited, Default setups, Specific setups only or Unclear. fixedIn lists the fixed versions cve.now leads with: the vendor's own, without distro package builds or another product's versions. fixedInByProduct lists each affected product's fixed versions (product, versions), the entry's own product first, then products that ship the bug, such as Node.js on a Brotli CVE.","responses":{"200":{"description":"OK: the same JSON as the MCP tool's result","content":{"application/json":{"schema":{"type":"object","description":"One vulnerability entry","properties":{"id":{"description":"The entry id (CVE, GHSA or OSV)"},"title":{"description":"Short title"},"severity":{"description":"Severity rating"},"exposure":{"description":"Actively exploited, Default setups, Specific setups only or Unclear"},"fixedIn":{"description":"Fixed versions cve.now leads with"},"fixedInByProduct":{"description":"Fixed versions per affected product"}},"additionalProperties":true}}}},"400":{"description":"Bad input: { error }"},"404":{"description":"Not found: { error }"},"429":{"description":"Rate limited: { error }, with Retry-After"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v1/entries":{"get":{"operationId":"list_feed","summary":"List feed","description":"List the newest items in a cve.now feed. Pass name for one stored feed (critical, all, kev, tech/<slug>, ecosystem/<eco>; critical when nothing is passed), or any of filter, tech and ecosystem to narrow it. Each of those takes one value or a list: an item must match any listed value of a field, and every field passed. Up to 16 combinations of values.\n\nSend at least one of name, tech, ecosystem or limit (limit=20 is enough): without them, or with filter alone, GET /api/v1/entries lists the whole catalog instead, as { entries, nextCursor }.","responses":{"200":{"description":"OK: list_feed's JSON when a selector is sent, else the catalog page","content":{"application/json":{"schema":{"anyOf":[{"type":"object","description":"The newest items of a feed","properties":{"name":{"description":"The feed's name"},"title":{"description":"The feed's title"},"updatedAt":{"description":"When the feed last changed (ISO 8601)"},"items":{"description":"Feed items, newest first"}},"additionalProperties":true},{"type":"object","description":"One page of every published entry, newest first (no name, tech, ecosystem or limit sent)","properties":{"entries":{"description":"Entries, newest first"},"nextCursor":{"description":"Pass back as cursor for the next page"}},"additionalProperties":true}]}}}},"400":{"description":"Bad input: { error }"},"404":{"description":"Not found: { error }"},"429":{"description":"Rate limited: { error }, with Retry-After"}},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"filter","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["critical","kev"]},"description":"critical and/or kev"}},{"name":"tech","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Technology slugs, e.g. nextjs, react"}},{"name":"ecosystem","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Package ecosystems, e.g. npm, pypi"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":20}}]}},"/api/v1/check":{"post":{"operationId":"check_stack","summary":"Check dependencies","description":"Check exact package versions against cve.now's synced vulnerability catalog. Pass a lockfile, a package list, or the stack_id of a lockfile uploaded to cve.now. For a large lockfile, upload it instead of passing its contents: curl --data-binary @<file> -H 'X-Lockfile-Name: <file name>' https://cve.now/api/stack returns its id. A flake.lock is checked by the git commit each input pins, through OSV, and its nixpkgs package CVEs are not checked. No matches means none found, not a guarantee of safety.","responses":{"200":{"description":"OK: the same JSON as the MCP tool's result","content":{"application/json":{"schema":{"type":"object","description":"Known vulnerabilities in the packages checked","properties":{"coverage":{"description":"What the check covers"},"checked":{"description":"Number of packages checked"},"notes":{"description":"Gaps in the check, when there are any"},"affected":{"description":"Every affected package version, with the entry and its fixes"}},"additionalProperties":true}}}},"400":{"description":"Bad input: { error }"},"404":{"description":"Not found: { error }"},"429":{"description":"Rate limited: { error }, with Retry-After"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lockfile_name":{"type":"string","description":"Optional. The file type is detected from the content; the name only breaks ties (e.g. poetry.lock vs Cargo.lock). Supported: package-lock.json, npm-shrinkwrap.json, bun.lock, pnpm-lock.yaml, yarn.lock, poetry.lock, uv.lock, requirements.txt, Cargo.lock, go.sum, Gemfile.lock, mix.lock, flake.lock, composer.lock, Pipfile.lock, packages.lock.json (NuGet), gradle.lockfile."},"lockfile_content":{"type":"string"},"stack_id":{"type":"string","description":"The id returned by POST https://cve.now/api/stack for an uploaded lockfile."},"packages":{"type":"array","items":{"type":"object","properties":{"ecosystem":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"}},"required":["ecosystem","name","version"],"additionalProperties":false}}},"additionalProperties":false}}}}}},"/api/v1/feedback":{"post":{"operationId":"send_feedback","summary":"Send feedback","description":"Send a private note to the cve.now team: a wrong summary, severity or affected version, a missing vulnerability or technology, a broken feed, or a feature request. Stored for a person to read, never shown publicly, and rate limited per caller. Include the entry id or page in page when the note is about one. contact is optional and only used to reply.","responses":{"200":{"description":"OK: the same JSON as the MCP tool's result","content":{"application/json":{"schema":{"type":"object","description":"Whether the note was stored","properties":{"ok":{"description":"true when it was stored"},"message":{"description":"A line to show the user"}},"additionalProperties":true}}}},"400":{"description":"Bad input: { error }"},"404":{"description":"Not found: { error }"},"429":{"description":"Rate limited: { error }, with Retry-After"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":4000,"description":"What is wrong or missing, in plain words"},"page":{"type":"string","description":"The entry id or cve.now URL the note is about, e.g. CVE-2026-12345"},"contact":{"type":"string","description":"An email address for a reply (optional)"}},"required":["message"],"additionalProperties":false}}}}}},"/api/v1/leaderboard":{"get":{"operationId":"get_leaderboard","summary":"Get leaderboard","description":"Get the cve.now Index: the worst CVEs published or escalated this week, month or year, or of all time (window all: every CVE ever in KEV or with a Metasploit module, plus the past year), ranked by a 0-100 score (exploitation 40, exposure 25, reach 20, severity 10, no patch 5; methodology at https://cve.now/leaderboard/methodology). Narrow with tech, ecosystem and filter (critical, kev); a row matches any listed value of a field and every field passed. Pass week (YYYY-Www) instead, without tech, ecosystem or filter, for an archived week's top 25. Week rows carry movement since the previous week. view picks the board: exploited (default, the Index), worst-case (ranked by a 0-100 worst case score from severity, reach, exposure and exploit maturity, with no CISA confirmation needed; rows add worstCase) or trending (window week or month only; ranked by new PoC repos, new references and EPSS rise, with the Index unchanged; rows add trend).","responses":{"200":{"description":"OK: the same JSON as the MCP tool's result","content":{"application/json":{"schema":{"type":"object","description":"The cve.now Index","properties":{"methodology":{"description":"How the score is built"},"window":{"description":"week, month, year or all"},"week":{"description":"The archived ISO week, when one was asked for"},"url":{"description":"The board's page on cve.now"},"rows":{"description":"Ranked entries"}},"additionalProperties":true}}}},"400":{"description":"Bad input: { error }"},"404":{"description":"Not found: { error }"},"429":{"description":"Rate limited: { error }, with Retry-After"}},"parameters":[{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["exploited","worst-case","trending"],"default":"exploited"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","enum":["week","month","year","all"],"default":"week"}},{"name":"week","in":"query","required":false,"schema":{"type":"string","description":"An archived ISO week, e.g. 2026-W44"}},{"name":"tech","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"ecosystem","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"filter","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["critical","kev"]}}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}]}},"/api/v1/search":{"get":{"operationId":"search","summary":"Search vulnerabilities","description":"Search cve.now's whole catalog of vulnerabilities and early warnings: the one tool for finding entries, by words or by fields. Pass q (free text, \"quoted phrases\" and ids, plus advisory.dev's query keys such as vendor:, package:, affects:lodash@4.17.20, severity:, cvss:>=9, kev:true, exploit:, epss:, published:<30d, type:cve|early_warning, tech:, confidence:, category: and sort:relevance|published|modified|cvss; terms are ANDed, commas OR values, a leading - excludes), the structured parameters, or both: each parameter is ANDed with q as its key term. With no words, results are newest first, so severity: [\"critical\"] lists the newest entries rated critical and kev: true the newest KEV entries. cve.now's stored feeds (critical, kev, tech/<slug>, ecosystem/<eco>) pick entries by their own rules, so read those with list_feed. Each entry's match says why it matched: the fields each word hit (title, description, identifiers) and the key terms it meets. query echoes what ran. With no matches, suggestions lists broader queries that do match; an empty answer is not evidence that no vulnerability exists. Unverified early warnings appear only with confidence:unverified. Pass next_cursor back as cursor for the next page.","responses":{"200":{"description":"OK: the same JSON as the MCP tool's result","content":{"application/json":{"schema":{"type":"object","description":"One page of search results","properties":{"entries":{"description":"Matching entries, each with why it matched"},"query":{"description":"The query that ran"},"total":{"description":"Number of matches"},"facets":{"description":"Counts of every match by kind, severity, ecosystem and KEV"},"suggestions":{"description":"Broader queries that match, when nothing did"},"next_cursor":{"description":"Pass back as cursor for the next page"}},"additionalProperties":true}}}},"400":{"description":"Bad input: { error }"},"404":{"description":"Not found: { error }"},"429":{"description":"Rate limited: { error }, with Retry-After"}},"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Free text and query keys. Optional when a structured parameter is passed."}},{"name":"severity","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["critical","high","medium","low"]},"description":"Any of these severities (CVSS band, else the stated one)"}},{"name":"kev","in":"query","required":false,"schema":{"type":"boolean","description":"true: on CISA's Known Exploited Vulnerabilities list (exploited in the wild); false: not on it"}},{"name":"exploited","in":"query","required":false,"schema":{"type":"boolean","description":"true: public exploit code exists (Exploit-DB, Metasploit or a GitHub proof of concept), the same as exploit:true; false: none known"}},{"name":"tech","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Technology slugs, e.g. nextjs, postgres (any of them)"}},{"name":"ecosystem","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Package ecosystems, e.g. npm, pypi (any of them)"}},{"name":"vendor","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Vendors, e.g. microsoft, fortinet (any of them)"}},{"name":"package","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Package names, e.g. lodash (any of them); narrowed to the ecosystems passed"}},{"name":"published","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"description":"Publication bounds, all applied: an age (<30d) or a date (>=2026-10-01); two bounds make a window, e.g. [\">=2026-10-01\", \"<2026-10-08\"]"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["cve","early_warning","all"],"description":"Entry type; both when omitted"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","description":"next_cursor of the last page"}}]}}}}