Open Vulnerability Catalog

Match inventory CPEs to CVEs, look up KEV and CWE records, and browse the CPE dictionary.

API reference

What OVC is

The Open Vulnerability Catalog is a read API for CVE records, the CPE dictionary, CISA Known Exploited Vulnerabilities (KEV), and CWE weakness records.

The base URL is https://ovc.efflux.io. Send the same API key you use for the rest of Efflux in the Authorization header. A Bearer prefix is optional. Create the key from your profile. See API Keys.

Successful calls use the same DocumentResponse and PagedResponse envelopes as the rest of the API. A single record is in data with links.self. A list is a data array plus pagination.

Errors are { "error": "..." }. 400 means the input was rejected, 401 or 403 means the key was missing or not allowed, and 404 means that id is not in the catalog.

curl -sS "https://ovc.efflux.io/v1/cves/CVE-2021-44228" \
  -H "Authorization: Bearer $EFFLUX_TOKEN"

Date filters

Match, dictionary search, and KEV search take an inclusive window:

ParamMeaning
sinceLower bound. RFC3339 or YYYY-MM-DD
untilUpper bound. A date-only value includes that whole UTC day
date_fieldWhich timestamp to compare. Each endpoint has its own default
EndpointDefaultAllowed values
POST /v1/matchpublishedpublished, modified
GET /v1/dictionary/searchlast_modifiedlast_modified, created
GET /v1/kev/searchdate_addeddate_added, due_date

On match, the same three fields can go in the JSON body. Body values win over the query string.

Vendor and product lists do not take a date window. Use match when you need CVEs from a date range.

Match CPEs to CVEs

POST /v1/match takes CPE 2.2 or 2.3 strings and returns the CVEs that apply.

FieldNotes
cpesRequired. One or more CPE strings
enrichWhen true, each hit includes CWE and KEV rows when those catalogs list the CVE. Also accepted as ?enrich=true
since, until, date_fieldOptional date window. Default field is published
curl -sS -X POST "https://ovc.efflux.io/v1/match" \
  -H "Authorization: Bearer $EFFLUX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cpes": ["cpe:2.3:a:apache:http_server:2.4.49:*:*:*:*:*:*:*"],
    "enrich": true,
    "since": "2024-01-01",
    "until": "2024-12-31"
  }'

Each hit includes CVSS fields, whether the full configuration matched, and the CPE criteria that matched. Results are in data. pagination.total is the number of hits after the date window.

CVE lookup

MethodPathReturns
GET/v1/cves/{cve_id}CVE summary, vulnerable CPEs, and CWE/KEV when present
GET/v1/cves/{cve_id}/configurationsApplicability tree: configurations, nodes, and CPE criteria

CPE dictionary

MethodPathReturns
GET/v1/dictionary?cpe=One dictionary row. cpe is a full CPE 2.3 name
GET/v1/dictionary/search?q=Substring search over name, vendor, product, and titles

Search accepts limit (default 100, max 1000) and the date filter above.

KEV and CWE

MethodPathReturns
GET/v1/kev/{cve_id}One KEV record
GET/v1/kev/search?q=KEV rows matching vendor, product, name, or description
GET/v1/cwes/{cwe_id}One CWE record. Ids look like CWE-79

KEV search accepts the date filter above (date_added or due_date).

curl -sS "https://ovc.efflux.io/v1/kev/search?q=apache&since=2023-01-01" \
  -H "Authorization: Bearer $EFFLUX_TOKEN"

Vendors and products

MethodPathReturns
GET/v1/vendors/{vendor}/productsProducts for that vendor, with CVE and CPE counts
GET/v1/vendors/{vendor}/products?detail=trueSame list, plus the vulnerable CVE ids and CPE criteria
GET/v1/products/{product}Products with that name, including CVE ids and CPE criteria

Catalog counts

GET /v1/stats returns how many CVEs, matches, dictionary rows, KEV records, and CWE records the catalog currently holds.