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:
| Param | Meaning |
|---|---|
since | Lower bound. RFC3339 or YYYY-MM-DD |
until | Upper bound. A date-only value includes that whole UTC day |
date_field | Which timestamp to compare. Each endpoint has its own default |
| Endpoint | Default | Allowed values |
|---|---|---|
POST /v1/match | published | published, modified |
GET /v1/dictionary/search | last_modified | last_modified, created |
GET /v1/kev/search | date_added | date_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.
| Field | Notes |
|---|---|
cpes | Required. One or more CPE strings |
enrich | When true, each hit includes CWE and KEV rows when those catalogs list the CVE. Also accepted as ?enrich=true |
since, until, date_field | Optional 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
| Method | Path | Returns |
|---|---|---|
GET | /v1/cves/{cve_id} | CVE summary, vulnerable CPEs, and CWE/KEV when present |
GET | /v1/cves/{cve_id}/configurations | Applicability tree: configurations, nodes, and CPE criteria |
CPE dictionary
| Method | Path | Returns |
|---|---|---|
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
| Method | Path | Returns |
|---|---|---|
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
| Method | Path | Returns |
|---|---|---|
GET | /v1/vendors/{vendor}/products | Products for that vendor, with CVE and CPE counts |
GET | /v1/vendors/{vendor}/products?detail=true | Same 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.