From bdb5779e8e7cafdf1ee6d2f7da3ee0c47fd95e39 Mon Sep 17 00:00:00 2001
From: Nicolas Crocfer <ncrocfer@gmail.com>
Date: Fri, 17 Apr 2026 10:48:41 +0200
Subject: [PATCH] feat: allow 'include' parameter in CVE details

Signed-off-by: Nicolas Crocfer <ncrocfer@gmail.com>
---
 docs/api/cve.md | 61 ++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 60 insertions(+), 1 deletion(-)

diff --git a/docs/api/cve.md b/docs/api/cve.md
index 4425acf..0228724 100644
--- a/docs/api/cve.md
+++ b/docs/api/cve.md
@@ -49,10 +49,14 @@ HTTP/1.1 200 OK
 
 Get the details of a specific CVE.
 
+**Parameters:**
+
+- `include` (optional): include additional fields in the response (use `nvd_cpe_configurations` to retrieve NVD CPE configurations).
+
 **Example request:**
 
 ```
-GET /api/cve/CVE-2024-31880 HTTP/1.1
+GET /api/cve/CVE-2024-31880?include=nvd_cpe_configurations HTTP/1.1
 Host: app.opencve.io
 Accept: application/json
 ```
@@ -122,6 +126,61 @@ HTTP/1.1 200 OK
     "microsoft$PRODUCT$windows",
     "opengroup",
     "opengroup$PRODUCT$unix"
+  ],
+  "nvd_cpe_configurations": [
+    {
+      "nodes": [
+        {
+          "cpeMatch": [
+            {
+              "criteria": "cpe:2.3:a:ibm:db2:*:*:*:*:*:*:*:*",
+              "matchCriteriaId": "72264C00-9FD5-44EF-AE33-36819E253233",
+              "versionEndIncluding": "10.5.11",
+              "versionStartIncluding": "10.5.0.0",
+              "vulnerable": true
+            },
+            {
+              "criteria": "cpe:2.3:a:ibm:db2:*:*:*:*:*:*:*:*",
+              "matchCriteriaId": "2E7ABF45-1720-49F0-AA78-E4C06815F3C5",
+              "versionEndIncluding": "11.1.4.7",
+              "versionStartIncluding": "11.1.4",
+              "vulnerable": true
+            },
+            {
+              "criteria": "cpe:2.3:a:ibm:db2:*:*:*:*:*:-:*:*",
+              "matchCriteriaId": "46EEFD88-1F1D-417F-815A-98A456DE8515",
+              "versionEndIncluding": "11.5.9",
+              "versionStartIncluding": "11.5",
+              "vulnerable": true
+            }
+          ],
+          "negate": false,
+          "operator": "OR"
+        },
+        {
+          "cpeMatch": [
+            {
+              "criteria": "cpe:2.3:o:linux:linux_kernel:-:*:*:*:*:*:*:*",
+              "matchCriteriaId": "703AF700-7A70-47E2-BC3A-7FD03B3CA9C1",
+              "vulnerable": false
+            },
+            {
+              "criteria": "cpe:2.3:o:microsoft:windows:-:*:*:*:*:*:*:*",
+              "matchCriteriaId": "A2572D17-1DE6-457B-99CC-64AFD54487EA",
+              "vulnerable": false
+            },
+            {
+              "criteria": "cpe:2.3:o:opengroup:unix:-:*:*:*:*:*:*:*",
+              "matchCriteriaId": "6A90CB3A-9BE7-475C-9E75-6ECAD2106302",
+              "vulnerable": false
+            }
+          ],
+          "negate": false,
+          "operator": "OR"
+        }
+      ],
+      "operator": "AND"
+    }
   ]
 }
 ```