POST /api/v1/stack
Check a stack
Send the products and versions you run. Each comes back with the CVEs whose published ranges include your version, whether each is on the KEV catalogue, its EPSS, and the threat actors a published report ties to it, with the quote and the report. Exposure by product and version only: no configuration, reachability or backport check.
Duplicates are folded. CVEs whose ranges exclude your version are counted in not_affected, never listed.
A cold check of many products can take up to a minute; what did not fit in time is reported as not-checked, with the reason.
- bodyapplication/json
- At most 500 components and 1 MB. A purl or a CPE identifies a component best; a bare name is matched as a guess.
curl -sS -X POST "https://skopnix.com/api/v1/stack" \ -H "Content-Type: application/json" \ -d '{"components":[{"name":"log4j-core","version":"2.14.1","purl":"pkg:maven/org.apache.logging.log4j/[email protected]"},{"vendor":"fortinet","name":"fortios","version":"7.0.1"}]}'Response · application/json
{ "note": "Exposure by product and version claim only: no configuration, reachability or backport check.", "generated_at": "2026-11-03T20:00:00.000Z", "summary": { "components": 2, "with_findings": 2, "kev_cves": 6, "kev_cves_unchecked": 0, "cves_with_cited_actors": 2 }, "sources": { "kev_catalog": { "status": "ok", "released": "2026-10-30" }, "epss": "ok", "actors": "ok", "coverage": "ok", "facts": { "cves": 41, "looked_up": 41, "epss_looked_up": 41, "truncated": false } }, "components": [ { "input": { "name": "log4j-core", "version": "2.14.1", "purl": "pkg:maven/org.apache.logging.log4j/[email protected]", "cpe": null, "vendor": null, "namespace": null, "origin": null }, "resolved": { "vendor": "apache", "product": "log4j", "part": "a", "via": "purl" }, "status": "checked", "findings": [ { "cve": "CVE-2021-44228", "kev": true, "kev_date_added": "2021-12-10", "ransomware": true, "epss": 0.944, "version": "in-range", "version_detail": "2.14.1 ∈ [2.0.1, 2.15.0)", "fixed_in": "2.15.0", "confidence": "high", "actors": [ { "actor_id": "apt35", "actor": "APT35", "evidence": "The group exploited the Log4Shell vulnerability (CVE-2021-44228) to gain initial access.", "source": "example.com", "url": "https://example.com/report/log4shell-exploitation", "date": null } ], "coverage_priority": null, "not_looked_up": [] } ], "total_affected": 4, "not_affected": 1, "note": null } ]}An example, trimmed: real responses carry more rows and may carry more fields.
Fields · 25
- summary.kev_cvesinteger
- Distinct KEV CVEs across your components.
- summary.kev_cves_uncheckedinteger
- Of those, how many matched without a version comparison.
- sourcesobject
- The state of each lookup this check relied on (ok or unavailable), how many product ranges were read or skipped, and whether facts were capped. A lookup that failed is reported here, never hidden as an empty result.
- componentsobject[]
- In the order you sent them, duplicates folded.
- components[].inputobject
- The component as you sent it, normalised.
- components[].resolved.parta | o | h
- a = application, o = operating system or firmware, h = hardware.
- components[].resolved.viacpe | purl | alias | kev | name
- How the product was identified, strongest first: cpe (you sent one), purl (mapped through our table), alias (a well-known product name), kev (the name matched a KEV entry), name (a guess from the name).
- components[].resolved.altsobject[]
- Other names the same product is filed under.
- components[].statuschecked | partial | kev-only | no-records | unresolved | upstream-error
- checked: version ranges evaluated. partial: evaluated for some of the product's names. kev-only: matched the KEV catalogue by name, ranges not evaluated. no-records: identified, nothing on record. unresolved: we could not tell which product this is. upstream-error: the range lookup failed; KEV name matches are still shown.
- components[].findingsobject[]
- Exploited first (KEV, cited actors), then version certainty, then EPSS.
- components[].findings[].cvestring
- A CVE id, upper case.
- components[].findings[].kevboolean
- On the KEV catalogue: exploitation in the wild has been observed, not predicted.
- components[].findings[].kev_date_addedstring | null
- When it was added to the catalogue.
- components[].findings[].ransomwareboolean
- The catalogue records known use in ransomware campaigns.
- components[].findings[].epssnumber | null
- EPSS: the forecast probability, 0 to 1, that the CVE is exploited in the next 30 days. A forecast, never an observation. null when there is no score.
- components[].findings[].versionin-range | ambiguous | not-checked | no-version
- How your version compares with the published vulnerable ranges. See the meanings on /docs.
- components[].findings[].version_detailstring | null
- The comparison in words, e.g. 2.14.1 ∈ [2.0, 2.15.0).
- components[].findings[].fixed_instring | null
- The first fixed version, when the ranges state one.
- components[].findings[].confidencehigh | medium | low
- How sure the match is: how the product was identified, and whether the version was compared.
- components[].findings[].actors[].evidencestring
- The quoted sentence that ties the actor to the CVE.
- components[].findings[].actors[].sourcestring
- Who published the report.
- components[].findings[].actors[].urlstring | null
- The report.
- components[].findings[].not_looked_upactors | epss[]
- Facts this check skipped for this CVE because it was over the per-check cap. Empty means looked up.
- components[].total_affectedinteger
- Affected CVEs before the per-component cap.
- components[].not_affectedinteger
- CVEs on record for the product whose ranges exclude your version. Counted, not listed.