{
 "openapi": "3.1.0",
 "info": {
  "title": "Known exploited vulnerabilities (CISA KEV): data.promptugal.news",
  "version": "v0.1.151",
  "description": "The US Cybersecurity and Infrastructure Security Agency's catalogue of vulnerabilities known to be exploited: each CVE with vendor, product, the day added and ransomware use; and totals per week and vendor, for cyber.promptugal.news's pulse. Products only, never a victim, host or address.\n\nPublisher: CISA (Cybersecurity and Infrastructure Security Agency, United States). Reuse terms: CC0 1.0: \"You may use this data in any legal manner\"; third-party links keep their own terms; no use of the CISA logo or DHS seal, no endorsement implied. 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/cisa-kev/latest.json": {
   "get": {
    "operationId": "get_cisa_kev_latest",
    "tags": [
     "cisa-kev"
    ],
    "summary": "Known exploited vulnerabilities (CISA KEV): the latest read",
    "description": "CISA's catalogue of vulnerabilities known to be exploited, as read: each CVE with its vendor, product, the day CISA added it and whether it is known to be used in ransomware campaigns; and totals per week and per vendor. Vulnerabilities in products, never a victim, host or address. A weak signal, not an audit.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "source": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "read_at": {
           "type": "string"
          },
          "provenance": {
           "type": "object",
           "properties": {
            "source": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "by": {
             "type": "string"
            },
            "terms": {
             "type": "string"
            },
            "feed": {
             "type": "string"
            },
            "catalog_version": {
             "type": "string"
            },
            "date_released": {
             "type": "string"
            }
           },
           "required": [
            "source",
            "page",
            "read_at",
            "by",
            "terms",
            "feed",
            "catalog_version",
            "date_released"
           ]
          },
          "about": {
           "type": "string"
          },
          "counts": {
           "type": "object",
           "properties": {
            "vulnerabilities": {
             "type": "integer"
            },
            "published_count": {
             "type": "integer"
            },
            "vendors": {
             "type": "integer"
            },
            "fields_dropped_em_dash": {
             "type": "integer"
            },
            "added_last_7_days": {
             "type": "integer"
            }
           },
           "required": [
            "vulnerabilities",
            "published_count",
            "vendors",
            "fields_dropped_em_dash",
            "added_last_7_days"
           ]
          },
          "weekly": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "week_starting": {
              "type": "string",
              "format": "date"
             },
             "added": {
              "type": "integer"
             }
            },
            "required": [
             "week_starting",
             "added"
            ]
           }
          },
          "top_vendors": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "vendor": {
              "type": "string"
             },
             "vulnerabilities": {
              "type": "integer"
             }
            },
            "required": [
             "vendor",
             "vulnerabilities"
            ]
           }
          },
          "vulnerabilities": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "cveID": {
              "type": "string"
             },
             "vendorProject": {
              "type": "string"
             },
             "product": {
              "type": "string"
             },
             "vulnerabilityName": {
              "type": "string"
             },
             "dateAdded": {
              "type": "string",
              "format": "date"
             },
             "dueDate": {
              "type": "string",
              "format": "date"
             },
             "knownRansomwareCampaignUse": {
              "type": "string"
             },
             "cwes": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "url": {
              "type": "string",
              "format": "uri"
             }
            },
            "required": [
             "cveID",
             "vendorProject",
             "product",
             "vulnerabilityName",
             "dateAdded",
             "dueDate",
             "knownRansomwareCampaignUse",
             "cwes",
             "url"
            ]
           }
          }
         },
         "required": [
          "source",
          "title",
          "read_at",
          "provenance",
          "about",
          "counts",
          "weekly",
          "top_vendors",
          "vulnerabilities"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "source": "cisa-kev",
           "title": "Known exploited vulnerabilities (CISA KEV)",
           "read_at": "2026-11-21T07:04:27Z",
           "provenance": {
            "source": "https://www.cisa.gov/known-exploited-vulnerabilities-catalog",
            "page": "https://www.cisa.gov/known-exploited-vulnerabilities-catalog",
            "read_at": "2026-11-21T07:04:27Z",
            "by": "sources/cisa-kev/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
            "terms": "CC0 1.0: \"You may use this data in any legal manner\"; third-party links keep their own terms; no use of the CISA logo or DHS seal, no endorsement implied. Not reviewed by a person.",
            "feed": "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json",
            "catalog_version": "2026.11.20",
            "date_released": "2026-11-20T17:48:39.1516Z"
           },
           "about": "CISA's catalogue of vulnerabilities known to be exploited, as read: each CVE with its vendor, product, the day CISA added it and whether it is known to be used in ransomware campaigns; and totals per week and per vendor. Vulnerabilities in products, never a victim, host or address. A weak signal, no...",
           "counts": {
            "vulnerabilities": 1790,
            "published_count": 1790,
            "vendors": 298,
            "fields_dropped_em_dash": 0,
            "added_last_7_days": 9
           },
           "weekly": [
            {
             "week_starting": "2021-11-01",
             "added": 287
            },
            {
             "week_starting": "2021-11-15",
             "added": 4
            },
            {
             "week_starting": "2021-11-29",
             "added": 5
            }
           ],
           "top_vendors": [
            {
             "vendor": "Microsoft",
             "vulnerabilities": 391
            },
            {
             "vendor": "Cisco",
             "vulnerabilities": 104
            },
            {
             "vendor": "Apple",
             "vulnerabilities": 96
            }
           ],
           "vulnerabilities": [
            {
             "cveID": "CVE-2025-42884",
             "vendorProject": "SAP",
             "product": "NetWeaver",
             "vulnerabilityName": "SAP NetWeaver Improper Neutralization of Special Elements in Data Query Logic Vulnerability",
             "dateAdded": "2026-11-20",
             "dueDate": "2026-11-23",
             "knownRansomwareCampaignUse": "Unknown",
             "cwes": [
              "CWE-943"
             ],
             "url": "https://nvd.nist.gov/vuln/detail/CVE-2025-42884"
            },
            {
             "cveID": "CVE-2026-123890",
             "vendorProject": "Broadcom",
             "product": "VMware vCenter",
             "vulnerabilityName": "VMWare vCenter Authentication Bypass Using an Alternate Path or Channel Vulnerability",
             "dateAdded": "2026-11-20",
             "dueDate": "2026-11-23",
             "knownRansomwareCampaignUse": "Unknown",
             "cwes": [
              "CWE-288"
             ],
             "url": "https://nvd.nist.gov/vuln/detail/CVE-2026-123890"
            },
            {
             "cveID": "CVE-2026-129448",
             "vendorProject": "Apache",
             "product": "Roller",
             "vulnerabilityName": "Apache Roller Deserialization of Untrusted Data Vulnerability",
             "dateAdded": "2026-11-20",
             "dueDate": "2026-11-23",
             "knownRansomwareCampaignUse": "Unknown",
             "cwes": [
              "CWE-502"
             ],
             "url": "https://nvd.nist.gov/vuln/detail/CVE-2026-129448"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/cisa-kev/reads.json": {
   "get": {
    "operationId": "get_cisa_kev_reads",
    "tags": [
     "cisa-kev"
    ],
    "summary": "Known exploited vulnerabilities (CISA KEV): every read, newest first",
    "description": "Every run of sources/cisa-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/cisa-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": "cisa-kev",
           "runs": [
            {
             "at": "2026-11-21T07:04:27Z",
             "finished": "2026-11-21T07:04:29Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "kev",
               "url": "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json",
               "at": "2026-11-21T07:04:29Z",
               "status": 200,
               "bytes": 1871127,
               "sha256_prefix": "12c9ca4c5350ecac",
               "changed": true
              }
             ]
            },
            {
             "at": "2026-11-20T18:04:37Z",
             "finished": "2026-11-20T18:04:39Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "kev",
               "url": "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json",
               "at": "2026-11-20T18:04:39Z",
               "status": 200,
               "bytes": 1863915,
               "sha256_prefix": "ad618e404a43d72a",
               "changed": false
              }
             ]
            },
            {
             "at": "2026-11-20T07:04:15Z",
             "finished": "2026-11-20T07:04:17Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "kev",
               "url": "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json",
               "at": "2026-11-20T07:04:17Z",
               "status": 200,
               "bytes": 1863915,
               "sha256_prefix": "ad618e404a43d72a",
               "changed": false
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/cisa-kev/card.json": {
   "get": {
    "operationId": "get_cisa_kev_card",
    "tags": [
     "cisa-kev"
    ],
    "summary": "Known exploited vulnerabilities (CISA KEV): 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"
            },
            "republish": {
             "type": "string"
            },
            "open_question": {
             "type": "string"
            }
           },
           "required": [
            "summary",
            "page",
            "read_at",
            "quote",
            "quote_lang",
            "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": "cisa-kev",
           "title": "Known exploited vulnerabilities (CISA KEV)",
           "what": "The US Cybersecurity and Infrastructure Security Agency's catalogue of vulnerabilities known to be exploited: each CVE with vendor, product, the day added and ransomware use; and totals per week and vendor, for cyber.promptugal.news's pulse. Products only, never a victim, host or address.",
           "publisher": "CISA (Cybersecurity and Infrastructure Security Agency, United States)",
           "owner": "data.b@PrompTugal.dinis",
           "region": "portugal",
           "collector": "sources/cisa-kev/collect.mjs",
           "source_home": "https://www.cisa.gov/known-exploited-vulnerabilities-catalog",
           "reader_page": "https://www.cisa.gov/known-exploited-vulnerabilities-catalog",
           "schedule": {
            "cadence": "every 6 hours",
            "how": "the Pages workflow (.github/workflows/pages.yml) at 17 minutes past 00, 06, 12 and 18 UTC; one GET of the published JSON feed; every other run keeps the last read, copied from the live site"
           },
           "terms": {
            "summary": "CC0 1.0: \"You may use this data in any legal manner\"; third-party links keep their own terms; no use of the CISA logo or DHS seal, no endorsement implied. Not reviewed by a person.",
            "page": "https://github.com/cisagov/kev-data/blob/develop/LICENSE",
            "read_at": "2026-11-18",
            "quote": "The KEV database is distributed under the Creative Commons 0 1.0 License. You may use this data in any legal manner but note that information provided at any 3rd party links included in the KEV database are bound by the policies and licenses of those 3rd party websites.",
            "quote_lang": "en",
            "republish": "yes, CC0; credited to CISA as a courtesy, no endorsement implied",
            "open_question": "security@PrompTugal.dinis to review the cyber limits (aggregates only on cyber.promptugal.news; no IPs, hosts or victims)."
           },
           "api": {
            "latest": "https://data.promptugal.news/api/v1/cisa-kev/latest.json",
            "reads": "https://data.promptugal.news/api/v1/cisa-kev/reads.json",
            "card": "https://data.promptugal.news/api/v1/cisa-kev/card.json",
            "openapi": "https://data.promptugal.news/api/v1/cisa-kev/openapi.json",
            "page": "https://data.promptugal.news/sources/cisa-kev/"
           },
           "vault": null,
           "split": {
            "code": [
             "the collector reads CISA's feed, keeps each entry's identifying fields, and counts per week and vendor",
             "GitHub Actions runs it and deploys the site"
            ],
            "agents": [
             "data.b@PrompTugal.dinis wrote the collector and card on 18 November 2026, at cyber.b@PrompTugal.dinis's request; terms read for the register by data.b.collector@ (Sonnet)"
            ],
            "people": [
             "Dinis Cruz decided the cyber signals on 18 November 2026 (board/guidance/2026-11-18-people-blogs-cyber-and-simulated-payments.md); no person has checked the values (not reviewed)"
            ]
           },
           "cost": {
            "per_run_tokens": 0,
            "per_run_model_cost_usd": 0,
            "runner": "GitHub Actions on a public repository: no charge; one request a run (about 1.9 MB)",
            "build_tokens": "not measured",
            "note": "Code only: no model is called when the data is collected."
           },
           "since": "2026-11-18"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/cisa-kev/openapi.json": {
   "get": {
    "operationId": "get_cisa_kev_openapi",
    "tags": [
     "cisa-kev"
    ],
    "summary": "Known exploited vulnerabilities (CISA KEV): this document",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "tags": [
  {
   "name": "cisa-kev",
   "description": "The US Cybersecurity and Infrastructure Security Agency's catalogue of vulnerabilities known to be exploited: each CVE with vendor, product, the day added and ransomware use; and totals per week and vendor, for cyber.promptugal.news's pulse. Products only, never a victim, host or address."
  }
 ],
 "x-source": {
  "id": "cisa-kev",
  "card": "https://data.promptugal.news/api/v1/cisa-kev/card.json",
  "page": "https://data.promptugal.news/sources/cisa-kev/"
 }
}
