{
 "openapi": "3.1.0",
 "info": {
  "title": "NVD's record of every CVE on CISA's KEV list: data.promptugal.news",
  "version": "v0.1.151",
  "description": "NIST's National Vulnerability Database, CVE API 2.0 with the hasKev filter: every CVE on CISA's Known Exploited Vulnerabilities list as NVD records it (CNA domain, status, CVSS, weakness types, vendors and products, published and lastModified, NVD's copy of the KEV dates), once a day. Descriptions and references are not kept.\n\nPublisher: NIST, National Vulnerability Database (United States). Reuse terms: NVD API Terms of Use: the API is for building a service to \"search, display, analyze, retrieve, view and otherwise get\" NVD data; asked to display \"This product uses the NVD API but is not endorsed or certified by the NVD.\"; the NVD name may identify the source but not imply endorsement; if you modify the content you may not attribute it to the NVD (our totals are ours, our per-CVE values are kept as served); public rate limit 5 requests in a rolling 30 seconds without a key (we use none, seven seconds apart); no more than once every two hours (we read every 6 hours). Not reviewed by a person. Not a warning service: follow IPMA and ANEPC.\n\nCode: Apache-2.0. Text: CC BY 4.0. The data keeps the terms of its own source (see each source card); nothing here relaxes them.",
  "license": {
   "name": "Apache-2.0 for code; each source keeps its own data terms",
   "identifier": "Apache-2.0"
  },
  "contact": {
   "name": "PrompTugal.news data",
   "url": "https://github.com/PrompTugal/PrompTugal__News__Data"
  }
 },
 "servers": [
  {
   "url": "https://data.promptugal.news",
   "description": "Production"
  }
 ],
 "externalDocs": {
  "description": "How to use the API",
  "url": "https://data.promptugal.news/api/"
 },
 "paths": {
  "/api/v1/nvd-kev/latest.json": {
   "get": {
    "operationId": "get_nvd_kev_latest",
    "tags": [
     "nvd-kev"
    ],
    "summary": "NVD's record of every CVE on CISA's KEV list: the latest read",
    "description": "NVD's record of every CVE on CISA's Known Exploited Vulnerabilities list, read once a day with the API's hasKev filter, in the same per-CVE shape as /api/v1/nvd-cve/latest.json (cves[]): CNA (domain only), status, CVSS, weakness types, vendors and products, published and lastModified, plus kev.added and kev.action_due as NVD serves them. Descriptions and references are not kept. Values are NVD's, as served.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "source": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "read_at": {
           "type": "string"
          },
          "notice": {
           "type": "string"
          },
          "provenance": {
           "type": "object",
           "properties": {
            "source": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "by": {
             "type": "string"
            },
            "terms": {
             "type": "string"
            },
            "api": {
             "type": "string"
            },
            "api_key": {
             "type": "string"
            }
           },
           "required": [
            "source",
            "page",
            "read_at",
            "by",
            "terms",
            "api",
            "api_key"
           ]
          },
          "about": {
           "type": "string"
          },
          "counts": {
           "type": "object",
           "properties": {
            "cves": {
             "type": "integer"
            },
            "nvd_total": {
             "type": "integer"
            },
            "pages_complete": {
             "type": "boolean"
            },
            "with_products": {
             "type": "integer"
            }
           },
           "required": [
            "cves",
            "nvd_total",
            "pages_complete",
            "with_products"
           ]
          },
          "cves": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "published": {
              "type": "string"
             },
             "lastModified": {
              "type": "string"
             },
             "vulnStatus": {
              "type": "string"
             },
             "cna": {
              "type": "string"
             },
             "cvss": {
              "type": "object",
              "properties": {
               "version": {
                "type": "string"
               },
               "score": {
                "type": "number"
               },
               "severity": {
                "type": "string"
               },
               "scored_by": {
                "type": "string"
               }
              },
              "required": [
               "version",
               "score",
               "severity",
               "scored_by"
              ]
             },
             "cwes": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "products": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "vendor": {
                 "type": "string"
                },
                "product": {
                 "type": "string"
                }
               },
               "required": [
                "vendor",
                "product"
               ]
              }
             },
             "products_more": {
              "type": "integer"
             },
             "products_from": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "kev": {
              "type": "object",
              "properties": {
               "added": {
                "type": "string",
                "format": "date"
               },
               "action_due": {
                "type": "string",
                "format": "date"
               }
              },
              "required": [
               "added",
               "action_due"
              ]
             }
            },
            "required": [
             "id",
             "published",
             "lastModified",
             "vulnStatus",
             "cna",
             "cvss",
             "cwes",
             "products",
             "products_more",
             "products_from",
             "url",
             "kev"
            ]
           }
          }
         },
         "required": [
          "source",
          "title",
          "read_at",
          "notice",
          "provenance",
          "about",
          "counts",
          "cves"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "source": "nvd-kev",
           "title": "NVD's record of every CVE on CISA's KEV list",
           "read_at": "2026-11-21T07:12:44Z",
           "notice": "This product uses the NVD API but is not endorsed or certified by the NVD.",
           "provenance": {
            "source": "https://nvd.nist.gov/",
            "page": "https://nvd.nist.gov/developers/vulnerabilities",
            "read_at": "2026-11-21T07:12:44Z",
            "by": "sources/nvd-kev/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
            "terms": "NVD API Terms of Use: the API is for building a service to \"search, display, analyze, retrieve, view and otherwise get\" NVD data; asked to display \"This product uses the NVD API but is not endorsed or certified by the NVD.\"; the NVD name may identify the source but not imply endorsement; if you modi...",
            "api": "https://services.nvd.nist.gov/rest/json/cves/2.0?hasKev",
            "api_key": "none (public rate limit)"
           },
           "about": "NVD's record of every CVE on CISA's Known Exploited Vulnerabilities list, read once a day with the API's hasKev filter, in the same per-CVE shape as /api/v1/nvd-cve/latest.json (cves[]): CNA (domain only), status, CVSS, weakness types, vendors and products, published and lastModified, plus kev.added...",
           "counts": {
            "cves": 1790,
            "nvd_total": 1790,
            "pages_complete": true,
            "with_products": 1790
           },
           "cves": [
            {
             "id": "CVE-2002-0367",
             "published": "2002-06-25T04:00:00.000",
             "lastModified": "2026-06-16T21:57:17.883",
             "vulnStatus": "Analyzed",
             "cna": "mitre.org",
             "cvss": {
              "version": "3.1",
              "score": 7.8,
              "severity": "HIGH",
              "scored_by": "nvd"
             },
             "cwes": [
              "CWE-269"
             ],
             "products": [
              {
               "vendor": "microsoft",
               "product": "windows_2000"
              },
              {
               "vendor": "microsoft",
               "product": "windows_nt"
              }
             ],
             "products_more": 0,
             "products_from": "cpe",
             "url": "https://nvd.nist.gov/vuln/detail/CVE-2002-0367",
             "kev": {
              "added": "2022-03-03",
              "action_due": "2022-03-24"
             }
            },
            {
             "id": "CVE-2004-0210",
             "published": "2004-08-06T04:00:00.000",
             "lastModified": "2026-06-16T22:05:10.397",
             "vulnStatus": "Analyzed",
             "cna": "mitre.org",
             "cvss": {
              "version": "3.1",
              "score": 7.8,
              "severity": "HIGH",
              "scored_by": "nvd"
             },
             "cwes": [
              "CWE-120"
             ],
             "products": [
              {
               "vendor": "microsoft",
               "product": "interix"
              },
              {
               "vendor": "microsoft",
               "product": "windows_2000"
              },
              {
               "vendor": "microsoft",
               "product": "windows_nt"
              }
             ],
             "products_more": 0,
             "products_from": "cpe",
             "url": "https://nvd.nist.gov/vuln/detail/CVE-2004-0210",
             "kev": {
              "added": "2022-03-03",
              "action_due": "2022-03-24"
             }
            },
            {
             "id": "CVE-2004-1464",
             "published": "2004-12-31T05:00:00.000",
             "lastModified": "2026-06-16T22:07:45.380",
             "vulnStatus": "Analyzed",
             "cna": "mitre.org",
             "cvss": {
              "version": "3.1",
              "score": 5.9,
              "severity": "MEDIUM",
              "scored_by": "nvd"
             },
             "cwes": [
              "CWE-400"
             ],
             "products": [
              {
               "vendor": "cisco",
               "product": "ios"
              }
             ],
             "products_more": 0,
             "products_from": "cpe",
             "url": "https://nvd.nist.gov/vuln/detail/CVE-2004-1464",
             "kev": {
              "added": "2023-05-19",
              "action_due": "2023-06-09"
             }
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/nvd-kev/reads.json": {
   "get": {
    "operationId": "get_nvd_kev_reads",
    "tags": [
     "nvd-kev"
    ],
    "summary": "NVD's record of every CVE on CISA's KEV list: every read, newest first",
    "description": "Every run of sources/nvd-kev/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "runs": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "at": {
              "type": "string"
             },
             "finished": {
              "type": "string"
             },
             "ok": {
              "type": "integer"
             },
             "failed": {
              "type": "integer"
             },
             "reads": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "at": {
                 "type": "string"
                },
                "status": {
                 "type": "integer"
                },
                "bytes": {
                 "type": "integer"
                },
                "sha256_prefix": {
                 "type": "string"
                },
                "changed": {
                 "type": [
                  "boolean",
                  "string"
                 ]
                }
               },
               "required": [
                "name",
                "url",
                "at",
                "status",
                "bytes",
                "sha256_prefix",
                "changed"
               ]
              }
             }
            },
            "required": [
             "at",
             "finished",
             "ok",
             "failed",
             "reads"
            ]
           }
          }
         },
         "required": [
          "about",
          "source",
          "runs"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "about": "Every run of sources/nvd-kev/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
           "source": "nvd-kev",
           "runs": [
            {
             "at": "2026-11-21T07:12:44Z",
             "finished": "2026-11-21T07:12:51Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "kev-0",
               "url": "https://services.nvd.nist.gov/rest/json/cves/2.0?hasKev&resultsPerPage=2000&startIndex=0",
               "at": "2026-11-21T07:12:50Z",
               "status": 200,
               "bytes": 19574207,
               "sha256_prefix": "114e36dbb03f8b45",
               "changed": true
              }
             ]
            },
            {
             "at": "2026-11-20T07:17:20Z",
             "finished": "2026-11-20T07:17:28Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "kev-0",
               "url": "https://services.nvd.nist.gov/rest/json/cves/2.0?hasKev&resultsPerPage=2000&startIndex=0",
               "at": "2026-11-20T07:17:26Z",
               "status": 200,
               "bytes": 19511372,
               "sha256_prefix": "14e0d92cd41fea21",
               "changed": true
              }
             ]
            },
            {
             "at": "2026-11-19T02:17:02Z",
             "finished": "2026-11-19T02:17:05Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "kev-0",
               "url": "https://services.nvd.nist.gov/rest/json/cves/2.0?hasKev&resultsPerPage=2000&startIndex=0",
               "at": "2026-11-19T02:17:02Z",
               "status": 200,
               "bytes": 19509072,
               "sha256_prefix": "e907292651acdd16",
               "changed": "first read"
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/nvd-kev/card.json": {
   "get": {
    "operationId": "get_nvd_kev_card",
    "tags": [
     "nvd-kev"
    ],
    "summary": "NVD's record of every CVE on CISA's KEV list: the card",
    "description": "Who publishes the source, its reuse terms, the schedule, who owns it, what runs by code, by agents and by people, and the vault.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "what": {
           "type": "string"
          },
          "publisher": {
           "type": "string"
          },
          "owner": {
           "type": "string"
          },
          "region": {
           "type": "string"
          },
          "collector": {
           "type": "string"
          },
          "source_home": {
           "type": "string"
          },
          "reader_page": {
           "type": "string"
          },
          "schedule": {
           "type": "object",
           "properties": {
            "cadence": {
             "type": "string"
            },
            "how": {
             "type": "string"
            }
           },
           "required": [
            "cadence",
            "how"
           ]
          },
          "terms": {
           "type": "object",
           "properties": {
            "summary": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "quote": {
             "type": "string"
            },
            "quote_lang": {
             "type": "string"
            },
            "quotes": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "page": {
                "type": "string",
                "format": "uri"
               },
               "read_at": {
                "type": "string",
                "format": "date"
               },
               "topic": {
                "type": "string"
               },
               "quote": {
                "type": "string"
               }
              },
              "required": [
               "page",
               "read_at",
               "topic",
               "quote"
              ]
             }
            },
            "reading_note": {
             "type": "string"
            },
            "notice": {
             "type": "string"
            },
            "republish": {
             "type": "string"
            },
            "open_question": {
             "type": "string"
            }
           },
           "required": [
            "summary",
            "page",
            "read_at",
            "quote",
            "quote_lang",
            "quotes",
            "reading_note",
            "notice",
            "republish",
            "open_question"
           ]
          },
          "api": {
           "type": "object",
           "properties": {
            "latest": {
             "type": "string"
            },
            "reads": {
             "type": "string"
            },
            "card": {
             "type": "string"
            },
            "openapi": {
             "type": "string"
            },
            "page": {
             "type": "string"
            }
           },
           "required": [
            "latest",
            "reads",
            "card",
            "openapi",
            "page"
           ]
          },
          "vault": {
           "type": "null"
          },
          "split": {
           "type": "object",
           "properties": {
            "code": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "agents": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "people": {
             "type": "array",
             "items": {
              "type": "string"
             }
            }
           },
           "required": [
            "code",
            "agents",
            "people"
           ]
          },
          "cost": {
           "type": "object",
           "properties": {
            "per_run_tokens": {
             "type": "integer"
            },
            "per_run_model_cost_usd": {
             "type": "integer"
            },
            "runner": {
             "type": "string"
            },
            "build_tokens": {
             "type": "string"
            },
            "note": {
             "type": "string"
            }
           },
           "required": [
            "per_run_tokens",
            "per_run_model_cost_usd",
            "runner",
            "build_tokens",
            "note"
           ]
          },
          "since": {
           "type": "string"
          }
         },
         "required": [
          "id",
          "title",
          "what",
          "publisher",
          "owner",
          "region",
          "collector",
          "source_home",
          "reader_page",
          "schedule",
          "terms",
          "api",
          "vault",
          "split",
          "cost",
          "since"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "id": "nvd-kev",
           "title": "NVD's record of every CVE on CISA's KEV list",
           "what": "NIST's National Vulnerability Database, CVE API 2.0 with the hasKev filter: every CVE on CISA's Known Exploited Vulnerabilities list as NVD records it (CNA domain, status, CVSS, weakness types, vendors and products, published and lastModified, NVD's copy of the KEV dates), once a day. Descriptions a...",
           "publisher": "NIST, National Vulnerability Database (United States)",
           "owner": "data.b@PrompTugal.dinis",
           "region": "portugal",
           "collector": "sources/nvd-kev/collect.mjs",
           "source_home": "https://nvd.nist.gov/",
           "reader_page": "https://nvd.nist.gov/developers/vulnerabilities",
           "schedule": {
            "cadence": "daily",
            "how": "data.b@'s hourly wake runs it when its last read is more than 23.5 hours old: one GET of the CVE API with hasKev (pages of 2000, seven seconds apart, no key), committed with the rest of the data"
           },
           "terms": {
            "summary": "NVD API Terms of Use: the API is for building a service to \"search, display, analyze, retrieve, view and otherwise get\" NVD data; asked to display \"This product uses the NVD API but is not endorsed or certified by the NVD.\"; the NVD name may identify the source but not imply endorsement; if you modi...",
            "page": "https://nvd.nist.gov/developers/terms-of-use",
            "read_at": "2026-11-18",
            "quote": "The NVD API is intended to be used to develop a service or services to search, display, analyze, retrieve, view and otherwise \"get\" information from NVD data.",
            "quote_lang": "en",
            "quotes": [
             {
              "page": "https://nvd.nist.gov/developers/terms-of-use",
              "read_at": "2026-11-18",
              "topic": "attribution notice",
              "quote": "Services which utilize or access the NVD API are asked to display the following notice prominently within the application: \"This product uses the NVD API but is not endorsed or certified by the NVD.\""
             },
             {
              "page": "https://nvd.nist.gov/developers/terms-of-use",
              "read_at": "2026-11-18",
              "topic": "name and endorsement",
              "quote": "You may use the NVD name in order to identify the source of API content subject to these rules. You may not use the NVD name, to imply endorsement of any product, service, or entity, not-for-profit, commercial or otherwise."
             },
             {
              "page": "https://nvd.nist.gov/developers/terms-of-use",
              "read_at": "2026-11-18",
              "topic": "modified content",
              "quote": "If you modify the content accessed through the API, you may not attribute the source as the NVD."
             }
            ],
            "reading_note": "Both pages are script-rendered (only a shell is served); the text was read from the strings in the page bundle NVD serves for them (https://nvd.nist.gov/main-qn4plkkz.js), which the pages display.",
            "notice": "This product uses the NVD API but is not endorsed or certified by the NVD.",
            "republish": "yes, with the notice shown; per-CVE values as served, attributed to the NVD API; totals are our own count and are not attributed to the NVD; no endorsement implied",
            "open_question": "security@PrompTugal.dinis to review the cyber limits (aggregates only on cyber.promptugal.news; no IPs, hosts or victims). Whether a person wants to register an API key is open; none is used."
           },
           "api": {
            "latest": "https://data.promptugal.news/api/v1/nvd-kev/latest.json",
            "reads": "https://data.promptugal.news/api/v1/nvd-kev/reads.json",
            "card": "https://data.promptugal.news/api/v1/nvd-kev/card.json",
            "openapi": "https://data.promptugal.news/api/v1/nvd-kev/openapi.json",
            "page": "https://data.promptugal.news/sources/nvd-kev/"
           },
           "vault": null,
           "split": {
            "code": [
             "the collector reads NVD's CVE API once a day with hasKev and keeps the per-CVE identifiers and classifications",
             "data.b@'s hourly wake runs it when due and commits the data; a push builds and deploys"
            ],
            "agents": [
             "data.b@PrompTugal.dinis wrote the collector at cyber.b@'s request (19 Nov 2026)"
            ],
            "people": [
             "Dinis decides"
            ]
           },
           "cost": {
            "per_run_tokens": 0,
            "per_run_model_cost_usd": 0,
            "runner": "one request a day (about 6 MB)",
            "build_tokens": "not measured",
            "note": "Code only: no model is called when the data is collected."
           },
           "since": "2026-11-19"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/nvd-kev/openapi.json": {
   "get": {
    "operationId": "get_nvd_kev_openapi",
    "tags": [
     "nvd-kev"
    ],
    "summary": "NVD's record of every CVE on CISA's KEV list: this document",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "tags": [
  {
   "name": "nvd-kev",
   "description": "NIST's National Vulnerability Database, CVE API 2.0 with the hasKev filter: every CVE on CISA's Known Exploited Vulnerabilities list as NVD records it (CNA domain, status, CVSS, weakness types, vendors and products, published and lastModified, NVD's copy of the KEV dates), once a day. Descriptions and references are not kept."
  }
 ],
 "x-source": {
  "id": "nvd-kev",
  "card": "https://data.promptugal.news/api/v1/nvd-kev/card.json",
  "page": "https://data.promptugal.news/sources/nvd-kev/"
 }
}
