{
  "openapi": "3.1.0",
  "info": {
    "title": "Vulnesis VDB API",
    "summary": "Vulnerability intelligence: advisories, exploits, detection content, remediation and package safety across every ecosystem.",
    "version": "2.1.0",
    "description": "The Vulnesis Vulnerability Database (VDB) API answers questions about vulnerabilities and the software they affect: advisory records from every major source, affected versions, fixes, exploits and sightings, known-exploited status, detection content, remediation plans and package safety.\n\nAlmost every operation reads. The `POST` operations take inputs too large or too many for a query string (bulk lookups, SBOM documents), and `POST /v2/packages/refresh` asks Vulnesis to re-read packages from their registries.\n\n## Authentication\n\nEvery operation needs a credential except those marked as open (`security: []`). Send one of:\n\n| Credential | Header | Lifetime |\n|---|---|---|\n| API key | `Authorization: ApiKey <principalUuid>:<hex>` | Until the secret is rotated |\n| Session token | `Authorization: Bearer <jwt>` | 15 minutes |\n\nThe API key is `hex(HMAC-SHA256(key = secret, message = principalUuid))`. The secret never leaves your machine:\n\n```bash\nAPI_KEY=$(printf '%s' \"$VULNESIS_ORG_ID\" | openssl dgst -sha256 -hmac \"$VULNESIS_SECRET\" -hex | awk '{print $2}')\ncurl -H \"Authorization: ApiKey ${VULNESIS_ORG_ID}:${API_KEY}\" \\\n  https://api.vdb.vulnes.is/v2/info/CVE-2021-44228\n```\n\n`GET /v2/auth/token` exchanges an AWS Signature Version 4 request, signed with the same secret, for a session token. `GET /v2/auth/api-key` returns the API key the same way. Use an AWS SDK signer rather than writing the signature by hand.\n\n## Plans and gated fields\n\nEvery authenticated response carries `X-VDB-Plan`: `community`, `pro`, `teams` or `enterprise`. Most data is open to every plan. Where a plan gates part of an answer, the operation says so in its `x-vulnetix-plan` extension and in its description, and the answer keeps its shape:\n\n- **Gated fields** come back as `null`. The response lists them in `_pro_data` (JSONPath strings) and `_entitlements` (`{plan, gated: [{feature, requiredPlan}]}`), so a client can tell \"withheld\" from \"none\".\n- **Gated answers** come back as HTTP 200 with a `planLocked` body naming the `feature` and the `requiredPlan`, never as an error.\n- **Withheld rows** are counted: the end-of-life lists report `withheld` for the records your plan does not include.\n\n## Daily request quota\n\nEach organisation has a daily request quota, counted over a rolling 24 hours. Every authenticated response carries `RateLimit-DayLimit`, `RateLimit-Remaining` and `RateLimit-Reset` (Unix seconds of the next 00:00 UTC); the limit reads `unlimited` when there is none. Community plans are refused with `429` once the quota is spent. Pro, Teams and Enterprise plans are soft-limited: usage is counted, `X-Softlimits: true` is set, and requests are never refused.\n\n## Inputs\n\nOperations that take a vulnerability or a piece of software accept one shared set of inputs: `vulnId`, `package`, `ecosystem`, `version`, `vendor`, `product`, `cpe`, `purl`, `swid`, `tei` and `cel`. Inputs of different kinds narrow each other (AND). On `/vuln/{identifier}/*` operations the identifier slot also takes a URL-encoded purl, CPE, TEI or SWID tag; the operation then answers once per resolved vulnerability under `results`. `GET /v2/inputs/resolve` shows what a set of inputs resolves to.\n\n## Pagination\n\nList operations take `limit` and `offset` (or `page` and `perPage` on the package catalogue) and answer `total` and `hasMore` where the total is known. Each operation states its own default and maximum; a larger `limit` is clamped, not refused.\n\n## Errors\n\nErrors are JSON with an `error` string. Input errors add `field`, naming the input. `401` means no valid credential; `403` an inactive organisation; `429` a spent Community quota; `503` a dependency that did not answer, with `Retry-After`.\n\n## Versioning\n\nThis is v2. v1 (`/v1/spec`) is deprecated and will be removed; every v1 operation has a v2 equivalent. The Vulnesis CLI's own operations (`/v2/cli.*`) are described separately at `/v2/spec/cli`.\n",
    "termsOfService": "https://www.vulnes.is/terms",
    "contact": {
      "name": "Vulnesis",
      "url": "https://www.vulnes.is"
    },
    "license": {
      "name": "Vulnesis VDB data licence",
      "url": "https://vdb.vulnes.is/licensing/"
    }
  },
  "servers": [
    {
      "url": "https://api.vdb.vulnes.is/v2",
      "description": "Production"
    }
  ],
  "paths": {
    "/ai-assisted-exploits": {
      "get": {
        "operationId": "listAiAssistedExploits",
        "tags": [
          "AI Threat Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List AI-assisted exploit demonstrations",
        "description": "Lists researcher demonstrations of an AI producing a working exploit for a vulnerability that humans found, newest first, with success counts and a per-organisation leaderboard. This is a different table from `GET /ai-discoveries`, where the AI found the bug, and from `GET /ai-assisted-exploits-outcomes`, the curated article payload.\n\nTakes no parameters and returns every row. `leaderboard` has one entry per researcher organisation, in no fixed order.\n\nAvailable to every plan; authentication is required. Cached in-process for an hour and sent with `Cache-Control: public, max-age=300, s-maxage=3600, stale-while-revalidate=3600`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/ai-assisted-exploits'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ai-assisted-exploits"
          }
        ],
        "responses": {
          "200": {
            "description": "Every AI-assisted exploit demonstration with the success roll-up.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/AiFeedCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListAiAssistedExploitsResponse"
                },
                "example": {
                  "generatedAt": 1762300800,
                  "total": 1,
                  "succeeded": 1,
                  "failed": 0,
                  "leaderboard": [
                    {
                      "researcherOrg": "UIUC",
                      "total": 1,
                      "succeeded": 1,
                      "successRate": 1
                    }
                  ],
                  "items": [
                    {
                      "cveId": "CVE-2024-21626",
                      "source": "nist-nvd",
                      "aiSystem": "GPT-4 + Assistants API",
                      "aiPublisher": "OpenAI",
                      "researcherName": "Fang, Bindu, Gupta, Kang",
                      "researcherOrg": "UIUC",
                      "exploitDate": "2024-04-12",
                      "exploitDateMs": 1712880000000,
                      "success": true,
                      "failureReason": null,
                      "pocsInVdb": 4,
                      "cveOriginNote": null,
                      "classification": "container-escape",
                      "sourceUrl": "https://arxiv.org/html/2404.08144v2",
                      "notes": null,
                      "affectedVendor": "opencontainers",
                      "affectedProduct": "runc"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "The query failed (`AI-assisted exploits not yet available`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "AI-assisted exploits not yet available"
                }
              }
            }
          }
        }
      }
    },
    "/ai-assisted-exploits-outcomes": {
      "get": {
        "operationId": "getAiAssistedExploitsOutcomes",
        "tags": [
          "AI Threat Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get curated AI-assisted exploit outcomes",
        "description": "Returns the curated list of published AI-assisted exploit demonstrations (a human found the bug, an AI agent wrote the working exploit) with success and failure counts and a leaderboard per researcher organisation. The list is the article's canonical set; `GET /ai-assisted-exploits` is the database table.\n\nThe payload is computed once a day and served from the latest snapshot. `exploits` defaults to `[]` and `aggregate` to `{}` when the snapshot lacks them; `generatedAt`, `version` and `sourceTimestamp` are present only when the snapshot carries them. Takes no parameters.\n\nAvailable to every plan; authentication is required. Cached in-process for 24 hours and sent with `Cache-Control: public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/ai-assisted-exploits-outcomes'"
          }
        ],
        "responses": {
          "200": {
            "description": "The latest curated outcomes snapshot.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/SummaryFeedCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetAiAssistedExploitsOutcomesResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "generatedAt": 1762214400,
                  "version": 1,
                  "sourceTimestamp": 1762214400000,
                  "exploits": [
                    {
                      "cveId": "CVE-2025-54887",
                      "affectedSoftware": "JWT encryption library",
                      "affectedVendor": "jose / jwt-related",
                      "vulnType": "Cryptographic bypass",
                      "exploitDate": "2025-08-15",
                      "aiSystem": "Claude Sonnet 4.0",
                      "aiPublisher": "Anthropic",
                      "researcherName": "Weiss + Khayet",
                      "researcherOrg": "Independent",
                      "success": true,
                      "sourceUrl": "https://cybersecuritynews.com/ai-generate-cve-exploits/"
                    },
                    {
                      "cveId": "CVE-2024-25640",
                      "affectedSoftware": "Iris",
                      "affectedVendor": "Iris",
                      "vulnType": "Cross-site scripting",
                      "exploitDate": "2024-04-12",
                      "aiSystem": "GPT-4 + Assistants API",
                      "aiPublisher": "OpenAI",
                      "researcherName": "Fang, Bindu, Gupta, Kang",
                      "researcherOrg": "UIUC",
                      "success": false,
                      "failureReason": "Navigation done through JavaScript; the agent could not reach the trigger surface.",
                      "sourceUrl": "https://arxiv.org/html/2404.08144v2"
                    }
                  ],
                  "aggregate": {
                    "total": 2,
                    "succeeded": 1,
                    "failed": 1,
                    "successRate": 0.5,
                    "leaderboard": [
                      {
                        "org": "Independent",
                        "authors": "Weiss + Khayet",
                        "aiSystem": "Claude Sonnet 4.0",
                        "total": 1,
                        "succeeded": 1,
                        "failed": 0,
                        "successRate": 1
                      },
                      {
                        "org": "UIUC",
                        "authors": "Fang, Bindu, Gupta, Kang",
                        "aiSystem": "GPT-4 + Assistants API",
                        "total": 1,
                        "succeeded": 0,
                        "failed": 1,
                        "successRate": 0
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "No snapshot exists yet or it does not parse (`AI-assisted exploit creation outcomes not yet available, please retry shortly`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "AI-assisted exploit creation outcomes not yet available, please retry shortly"
                }
              }
            }
          }
        }
      }
    },
    "/ai-discovered-vulns-outcomes": {
      "get": {
        "operationId": "getAiDiscoveredVulnsOutcomes",
        "tags": [
          "AI Threat Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get exploitation outcomes for AI-discovered vulns",
        "description": "Returns what happened after discovery to each vulnerability on the curated AI-discovered list: KEV membership, public and weaponised exploits, and EPSS, with roll-ups by AI system, organisation, vendor and severity.\n\nThe payload is computed once a day and served from the latest snapshot. `outcomes` defaults to `[]` and `aggregate` to `{}` when the snapshot lacks them; `generatedAt`, `version` and `sourceTimestamp` are present only when the snapshot carries them. Takes no parameters.\n\nAvailable to every plan; authentication is required. Cached in-process for 24 hours and sent with `Cache-Control: public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/ai-discovered-vulns-outcomes'"
          }
        ],
        "responses": {
          "200": {
            "description": "The latest outcomes snapshot.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/SummaryFeedCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetAiDiscoveredVulnsOutcomesResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "generatedAt": 1762214400,
                  "version": 1,
                  "sourceTimestamp": 1762214400000,
                  "outcomes": [
                    {
                      "id": "CVE-2025-6965",
                      "idType": "cve",
                      "affectedSoftware": "SQLite",
                      "affectedVendor": "SQLite",
                      "vulnType": "Memory corruption",
                      "cvssAtDiscovery": 9.8,
                      "severity": "critical",
                      "aiSystem": "Big Sleep",
                      "aiOrg": "Google",
                      "discoveryDate": "2025-07-15",
                      "humanAssisted": false,
                      "isKev": false,
                      "hasExploit": true,
                      "hasWeaponized": false,
                      "exploitCount": 2,
                      "exploitFirstSeenMs": 1753056000000,
                      "epssScore": 0.0042,
                      "epssPercentile": 0.61
                    }
                  ],
                  "aggregate": {
                    "total": 1,
                    "autonomous": 1,
                    "humanAssisted": 0,
                    "withKev": 0,
                    "withExploit": 1,
                    "withWeaponized": 0,
                    "withEpss": 1,
                    "avgEpss": 0.0042,
                    "bySystem": [
                      {
                        "name": "Big Sleep",
                        "count": 1
                      }
                    ],
                    "byOrg": [
                      {
                        "name": "Google",
                        "count": 1
                      }
                    ],
                    "byVendor": [
                      {
                        "name": "SQLite",
                        "count": 1
                      }
                    ],
                    "bySeverity": [
                      {
                        "name": "critical",
                        "count": 1
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "No snapshot exists yet or it does not parse (`AI-discovered vulns outcomes not yet available, please retry shortly`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "AI-discovered vulns outcomes not yet available, please retry shortly"
                }
              }
            }
          }
        }
      }
    },
    "/ai-discoveries": {
      "get": {
        "operationId": "listAiDiscoveries",
        "tags": [
          "AI Threat Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List AI-discovered vulnerabilities",
        "description": "Lists the vulnerabilities credited to an AI system as discoverer, with every aggregation the AI-Discovered Vulnerabilities article draws (tables and charts) and the timeline markers, in one answer.\n\n- **Filters** narrow both `items` and `aggregate`. `aiOrg`, `aiSystem`, `harness`, `severity` and `milestoneType` are repeatable (values OR-combined, at most 20 each); different filters are AND-combined. `severity` and `milestoneType` are case-insensitive. `severity` also accepts one comma-separated value (`severity=critical,high`).\n- **Pagination** (`limit`, `offset`) applies to `items` only. `aggregate` and `total` always describe the whole filtered set. `limit` defaults to 1000; values above 5000 are clamped to 5000, and `limit=0` returns every filtered item.\n- **No match**: filters that match no discovery answer 503 (`AI discoveries not yet available, please retry shortly`), not an empty 200.\n- **`markers`** is not filtered: it always lists every notable or milestone-tagged discovery. It is `[]` when the marker query fails; the answer is still 200.\n\nAvailable to every plan; authentication is required. The answer is cached in-process for an hour per filter set and sent with `Cache-Control: public, max-age=300, s-maxage=3600, stale-while-revalidate=3600`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/ai-discoveries?aiOrg=Google&severity=critical&limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ai-discoveries"
          }
        ],
        "parameters": [
          {
            "name": "aiOrg",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Organisation behind the AI system, matched exactly (case-sensitive). Repeatable, at most 20 values; values are OR-combined. More than 20 values, or a value longer than 256 characters, is a 400. The in-process cache key lower-cases these values, so for up to an hour a request may be answered with the result cached for a value that differs only in case.",
            "schema": {
              "type": "array",
              "maxItems": 20,
              "items": {
                "$ref": "#/components/schemas/AiDiscoveryTagValue"
              }
            },
            "example": [
              "Google"
            ]
          },
          {
            "name": "aiSystem",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "AI system credited with the discovery, matched exactly (case-sensitive). Repeatable, at most 20 values; values are OR-combined. The in-process cache key lower-cases these values, so for up to an hour a request may be answered with the result cached for a value that differs only in case.",
            "schema": {
              "type": "array",
              "maxItems": 20,
              "items": {
                "$ref": "#/components/schemas/AiDiscoveryTagValue"
              }
            },
            "example": [
              "Big Sleep"
            ]
          },
          {
            "name": "harness",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Discovery harness, matched exactly (case-sensitive). Repeatable, at most 20 values; values are OR-combined. The in-process cache key lower-cases these values, so for up to an hour a request may be answered with the result cached for a value that differs only in case.",
            "schema": {
              "type": "array",
              "maxItems": 20,
              "items": {
                "$ref": "#/components/schemas/AiDiscoveryTagValue"
              }
            },
            "example": [
              "Pwno deductive engine"
            ]
          },
          {
            "name": "severity",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Severity at discovery: `critical`, `high`, `medium`, `low` or `unknown`, case-insensitive. Repeatable, at most 20 values; values are OR-combined. When the parameter is given once, a comma-separated list (`critical,high`) is split server-side. Any other value is a 400. Spaces around each value are ignored (`critical, high`).",
            "schema": {
              "type": "array",
              "maxItems": 20,
              "items": {
                "type": "string",
                "minLength": 3,
                "maxLength": 240,
                "pattern": "^ ?([Cc][Rr][Ii][Tt][Ii][Cc][Aa][Ll]|[Hh][Ii][Gg][Hh]|[Mm][Ee][Dd][Ii][Uu][Mm]|[Ll][Oo][Ww]|[Uu][Nn][Kk][Nn][Oo][Ww][Nn]) ?(, ?([Cc][Rr][Ii][Tt][Ii][Cc][Aa][Ll]|[Hh][Ii][Gg][Hh]|[Mm][Ee][Dd][Ii][Uu][Mm]|[Ll][Oo][Ww]|[Uu][Nn][Kk][Nn][Oo][Ww][Nn]) ?){0,19}$"
              }
            },
            "example": [
              "critical"
            ]
          },
          {
            "name": "milestoneType",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Milestone tag: `firefox-dump`, `ai-malware`, `autonomous-bounty` or `notable`, case-insensitive. Repeatable, at most 20 values; values are OR-combined. A comma-separated list is not split. Any other value is a 400.",
            "schema": {
              "type": "array",
              "maxItems": 20,
              "items": {
                "type": "string",
                "minLength": 7,
                "maxLength": 17,
                "pattern": "^([Ff][Ii][Rr][Ee][Ff][Oo][Xx]-[Dd][Uu][Mm][Pp]|[Aa][Ii]-[Mm][Aa][Ll][Ww][Aa][Rr][Ee]|[Aa][Uu][Tt][Oo][Nn][Oo][Mm][Oo][Uu][Ss]-[Bb][Oo][Uu][Nn][Tt][Yy]|[Nn][Oo][Tt][Aa][Bb][Ll][Ee])$"
              }
            },
            "example": [
              "autonomous-bounty"
            ]
          },
          {
            "name": "humanAssisted",
            "in": "query",
            "required": false,
            "description": "Keep only human-assisted (`true`) or only fully autonomous (`false`) discoveries. Case-insensitive; `true`, `1` and `yes` mean true, `false`, `0` and `no` mean false. Any other value is a 400.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 5,
              "pattern": "^([Tt][Rr][Uu][Ee]|[Ff][Aa][Ll][Ss][Ee]|[Yy][Ee][Ss]|[Nn][Oo]|1|0)$"
            },
            "example": "false"
          },
          {
            "name": "notable",
            "in": "query",
            "required": false,
            "description": "Keep only (`true`) or exclude (`false`) editorially notable disclosures. Same spellings as `humanAssisted`.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 5,
              "pattern": "^([Tt][Rr][Uu][Ee]|[Ff][Aa][Ll][Ss][Ee]|[Yy][Ee][Ss]|[Nn][Oo]|1|0)$"
            },
            "example": "true"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page. Default 1000; values above 5000 are clamped to 5000. `0` turns the cap off and returns every filtered item. A negative or non-integer value is a 400.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 5000,
              "default": 1000
            },
            "example": 50
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip in the filtered list (ordered by discovery date, newest first, then displayId). An offset past the end returns an empty page. The handler sets no upper bound; this document caps it at 100000. A negative or non-integer value is a 400.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "One page of discoveries, aggregations over the whole filtered set, and the timeline markers.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/AiFeedCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListAiDiscoveriesResponse"
                },
                "example": {
                  "generatedAt": 1762300800,
                  "total": 2,
                  "count": 1,
                  "limit": 1,
                  "offset": 0,
                  "items": [
                    {
                      "displayId": "CVE-2025-6965",
                      "cveId": "CVE-2025-6965",
                      "source": "nist-nvd",
                      "idType": "cve",
                      "aiSystem": "Big Sleep",
                      "aiOrg": "Google",
                      "harness": null,
                      "humanAssisted": false,
                      "discoveryDate": "2025-07-15",
                      "discoveryDateMs": 1752537600000,
                      "vulnType": "Memory corruption",
                      "severity": "critical",
                      "cvss": 9.8,
                      "sourceUrl": "https://blog.google/technology/safety-security/cybersecurity-updates-summer-2025/",
                      "notes": null,
                      "researchers": [],
                      "isNotable": true,
                      "milestoneType": null,
                      "affectedVendor": "sqlite",
                      "affectedProduct": "sqlite"
                    }
                  ],
                  "aggregate": {
                    "total": 2,
                    "autonomous": 2,
                    "humanAssisted": 0,
                    "withCvss": 1,
                    "avgCvss": 9.8,
                    "earliestDateMs": 1730419200000,
                    "latestDateMs": 1752537600000,
                    "byOrg": [
                      {
                        "key": "Google",
                        "count": 2
                      }
                    ],
                    "byOrgHumanAssisted": [
                      {
                        "aiOrg": "Google",
                        "autonomous": 2,
                        "humanAssisted": 0
                      }
                    ],
                    "byOrgSeverity": [
                      {
                        "aiOrg": "Google",
                        "severity": "critical",
                        "count": 1
                      },
                      {
                        "aiOrg": "Google",
                        "severity": "unknown",
                        "count": 1
                      }
                    ],
                    "bySeverity": [
                      {
                        "key": "(unknown)",
                        "count": 1
                      },
                      {
                        "key": "critical",
                        "count": 1
                      }
                    ],
                    "byHarness": [
                      {
                        "key": "(unknown)",
                        "count": 2
                      }
                    ],
                    "byAiSystem": [
                      {
                        "key": "Big Sleep",
                        "count": 2
                      }
                    ],
                    "timeline": [
                      {
                        "dateMs": 1730419200000,
                        "count": 1
                      },
                      {
                        "dateMs": 1752537600000,
                        "count": 1
                      }
                    ]
                  },
                  "markers": [
                    {
                      "displayId": "CVE-2025-6965",
                      "cveId": "CVE-2025-6965",
                      "source": "nist-nvd",
                      "idType": "cve",
                      "aiOrg": "Google",
                      "aiSystem": "Big Sleep",
                      "vulnType": "Memory corruption",
                      "date": "2025-07-15",
                      "dateMs": 1752537600000,
                      "markerType": "notable",
                      "isNotable": true,
                      "affectedVendor": "sqlite",
                      "affectedProduct": "sqlite"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A filter, `limit` or `offset` is malformed: an unknown severity or milestone type, a boolean outside the accepted spellings, more than 20 values for one filter, a tag value longer than 256 characters, or a negative or non-integer number.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "severity must be one of: critical, high, medium, low, unknown"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "The items or aggregate query failed (`AI discoveries not yet available, please retry shortly`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set). Filters that match no discovery also land here today: the headline sums are NULL over zero rows and the aggregate query fails, so an empty result is a 503, not a 200 with `total: 0`.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "AI discoveries not yet available, please retry shortly"
                }
              }
            }
          }
        }
      }
    },
    "/ai-generated-malware": {
      "get": {
        "operationId": "listAiGeneratedMalware",
        "tags": [
          "AI Threat Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List AI-generated malware families",
        "description": "Lists malware families that were written with AI or call an AI model at run time, newest publication first, with a count per AI use mode. Entries are not necessarily tied to a CVE.\n\nTakes no parameters and returns every row. `byUseMode` is in no fixed order.\n\nAvailable to every plan; authentication is required. Cached in-process for an hour and sent with `Cache-Control: public, max-age=300, s-maxage=3600, stale-while-revalidate=3600`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/ai-generated-malware'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ai-malware"
          }
        ],
        "responses": {
          "200": {
            "description": "Every AI-generated malware family with the per-mode counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/AiFeedCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListAiGeneratedMalwareResponse"
                },
                "example": {
                  "generatedAt": 1762300800,
                  "total": 1,
                  "byUseMode": [
                    {
                      "aiUseMode": "runtime",
                      "count": 1
                    }
                  ],
                  "items": [
                    {
                      "name": "PromptLock",
                      "actor": "Unknown",
                      "aiSystem": "gpt-oss-20b",
                      "aiUseMode": "runtime",
                      "publishedBy": "ESET",
                      "publishedDate": "2025-08-26",
                      "publishedDateMs": 1756166400000,
                      "description": "Ransomware proof of concept that generates its Lua payload with a locally hosted model at run time.",
                      "sourceUrl": "https://www.welivesecurity.com/",
                      "sourceLabel": "ESET Research",
                      "associatedIds": null
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The answer could not be encoded (the handler writes `{\"success\": false}` with no `error`), or another unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/AiFeedBareFailure"
                    }
                  ]
                },
                "example": {
                  "success": false
                }
              }
            }
          },
          "503": {
            "description": "The query failed (`AI generated malware not yet available`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "AI generated malware not yet available"
                }
              }
            }
          }
        }
      }
    },
    "/ai-in-wild-exploitations": {
      "get": {
        "operationId": "listAiInWildExploitations",
        "tags": [
          "AI Threat Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List AI-authored exploitation seen in the wild",
        "description": "Lists observed in-the-wild exploitation where the exploit shows signs of AI authorship, newest advisory first. Distinct from `GET /ai-assisted-exploits` (researcher demonstrations) and `GET /ai-discoveries` (the AI found the bug).\n\nTakes no parameters and returns every row.\n\nAvailable to every plan; authentication is required. Cached in-process for an hour and sent with `Cache-Control: public, max-age=300, s-maxage=3600, stale-while-revalidate=3600`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/ai-in-wild-exploitations'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ai-in-wild"
          }
        ],
        "responses": {
          "200": {
            "description": "Every observed AI-authored in-the-wild exploitation.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/AiFeedCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListAiInWildExploitationsResponse"
                },
                "example": {
                  "generatedAt": 1762300800,
                  "total": 1,
                  "items": [
                    {
                      "cveId": "CVE-2025-55182",
                      "source": "nist-nvd",
                      "observedBy": "GreyNoise",
                      "advisoryDate": "2025-12-05",
                      "advisoryDateMs": 1764892800000,
                      "timeToExploit": "under 24 hours",
                      "aiFingerprint": "LLM-style comments and scaffolding in the dropped payload",
                      "aiSystemSuspected": null,
                      "sourceUrl": "https://www.greynoise.io/blog",
                      "sourceLabel": "GreyNoise",
                      "notes": null,
                      "affectedVendor": "meta",
                      "affectedProduct": "react"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The answer could not be encoded (the handler writes `{\"success\": false}` with no `error`), or another unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/AiFeedBareFailure"
                    }
                  ]
                },
                "example": {
                  "success": false
                }
              }
            }
          },
          "503": {
            "description": "The query failed (`AI in-wild exploitations not yet available`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "AI in-wild exploitations not yet available"
                }
              }
            }
          }
        }
      }
    },
    "/alibaba/archive/{month}": {
      "get": {
        "operationId": "getAlibabaArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Alibaba advisories",
        "description": "Returns every Alibaba advisory published in one calendar month (UTC): Alibaba Cloud Linux 2 security advisories (`ALINUX2-SA-*`). The month's advisories are found by publication date when the request is served. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `alibaba-cloud`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`. `sourceBreakdown.alibaba-product` is always 0 in this answer.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/alibaba/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Alibaba advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetAlibabaArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Alibaba Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 0,
                  "severityCounts": {
                    "High": 1
                  },
                  "sourceBreakdown": {
                    "alinux2": 1,
                    "alibaba-product": 0
                  },
                  "advisories": [
                    {
                      "advisoryId": "ALINUX2-SA-2024:0012",
                      "kind": "alinux2",
                      "title": "Important: kernel security update",
                      "severity": "Important",
                      "datePublished": 1709856000000,
                      "cveAliases": [
                        "CVE-2023-6932"
                      ],
                      "isExploited": false,
                      "advisoryUrl": "https://mirrors.aliyun.com/alinux/cve/alinux2-sa-20240012.xml",
                      "products": [
                        {
                          "productName": "kernel",
                          "status": "affected",
                          "packageName": "kernel"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2023-6932"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/alibaba/archives": {
      "get": {
        "operationId": "listAlibabaArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Alibaba advisory archive",
        "description": "Lists every month that has Alibaba advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `alinux2`, `alibaba-product` (`alibaba-product` counts CVEs from other sources that name Alibaba as vendor; the month endpoint does not return them), and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/alibaba/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Alibaba advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "alinux2": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "alinux2": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/alpine/archive/{month}": {
      "get": {
        "operationId": "getAlpineArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Alpine advisories",
        "description": "Returns every Alpine advisory published in one calendar month (UTC): Alpine secdb (aports), Chainguard and Wolfi advisories, attributed to the container registry images they affect. The month's advisories are found by publication date when the request is served. Each entry is one CVE from one source, so a CVE recorded by Alpine, Chainguard and Wolfi appears once per source with the same `advisoryId`. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `alpine`, `chainguard` and `wolfi`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/alpine/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Alpine advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetAlpineArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Alpine Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 0,
                  "severityCounts": {
                    "Critical": 1
                  },
                  "sourceBreakdown": {
                    "docker-hub-alpine": 0,
                    "chainguard-images": 0,
                    "wolfi-images": 0,
                    "redhat-hardened": 0,
                    "aports": 1
                  },
                  "advisories": [
                    {
                      "advisoryId": "CVE-2024-3094",
                      "kind": "aports",
                      "title": "xz: malicious code in distributed source",
                      "severity": "CRITICAL",
                      "datePublished": 1711670400000,
                      "cveAliases": [
                        "CVE-2024-3094"
                      ],
                      "isExploited": false,
                      "advisoryUrl": "https://security.alpinelinux.org/vuln/CVE-2024-3094",
                      "products": [
                        {
                          "productName": "xz",
                          "status": "affected",
                          "packageName": "xz"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-3094"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/alpine/archives": {
      "get": {
        "operationId": "listAlpineArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Alpine advisory archive",
        "description": "Lists every month that has Alpine advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `docker-hub-alpine`, `chainguard-images`, `wolfi-images`, `redhat-hardened`, `aports`, and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/alpine/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Alpine advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "docker-hub-alpine": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "docker-hub-alpine": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/alpine/registries": {
      "get": {
        "operationId": "listAlpineRegistries",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List container registries with advisory counts",
        "description": "Lists the container image registries tracked for Alpine-family advisories (Docker Hub Alpine, Chainguard Images, Wolfi, Red Hat hardened images, then any others), each with how many advisories are attributed to its images in total and in the last 30, 90 and 365 days (by when the attribution was last seen). Takes no parameters. The API caches a non-empty answer in process for 30 minutes.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/alpine/registries'"
          }
        ],
        "responses": {
          "200": {
            "description": "Registries with advisory counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListAlpineRegistriesResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "registries": [
                    {
                      "slug": "docker-hub-alpine",
                      "displayName": "Docker Hub — Alpine",
                      "homepageURL": "https://hub.docker.com/_/alpine",
                      "hardeningProfile": "minimal",
                      "pullReference": "docker.io/library/alpine",
                      "advisoryCount": 1843,
                      "last30Days": 21,
                      "last90Days": 77,
                      "last365Days": 402
                    },
                    {
                      "slug": "chainguard-images",
                      "displayName": "Chainguard Images",
                      "homepageURL": "https://images.chainguard.dev/",
                      "advisoryCount": 5120,
                      "last30Days": 133,
                      "last90Days": 390,
                      "last365Days": 1688
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/apple/archive/{month}": {
      "get": {
        "operationId": "getAppleArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Apple advisories",
        "description": "Returns every Apple advisory published in one calendar month (UTC): CVEs whose affected vendor is Apple (macOS, iOS, iPadOS, tvOS, watchOS, visionOS, Safari, Xcode), taken from NVD, GitHub and OSV records. The month's advisories are found by publication date when the request is served. Entries are one per CVE; `kind` is derived from the title. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `apple`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`. `sourceBreakdown` lists only the kinds present in the month.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/apple/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Apple advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetAppleArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Apple Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 1,
                  "severityCounts": {
                    "High": 1
                  },
                  "sourceBreakdown": {
                    "ios": 1
                  },
                  "advisories": [
                    {
                      "advisoryId": "CVE-2024-23222",
                      "kind": "ios",
                      "title": "A type confusion issue was addressed with improved checks in WebKit",
                      "severity": "HIGH",
                      "datePublished": 1706054400000,
                      "cveAliases": [
                        "CVE-2024-23222"
                      ],
                      "isExploited": true,
                      "advisoryUrl": "https://support.apple.com/en-us/HT214055",
                      "products": [
                        {
                          "productName": "iOS",
                          "status": "affected",
                          "vendor": "Apple"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-23222"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "kevCisa": true,
                        "kevVulncheck": true,
                        "exploitMaturity": "active",
                        "exploitCount": 4
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/apple/archives": {
      "get": {
        "operationId": "listAppleArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Apple advisory archive",
        "description": "Lists every month that has Apple advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `apple` only (the list counts one CVE once per source record, so its counts can exceed the month endpoint's), and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/apple/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Apple advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "macos": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "macos": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/attack-techniques": {
      "get": {
        "operationId": "searchAttackTechniques",
        "tags": [
          "Detection Rules"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search ATT&CK technique mappings",
        "description": "Searches the stored ATT&CK technique mappings across vulnerabilities. Each row is one mapping (one vulnerability, one source, not merged) with its mitigations, detections and D3FEND counter-techniques inline. Filters combine with AND. Repeated `techniqueId`, `cveId` or `source` match any of the values; repeated `tactic` must all be present. Newest mapping first. Paged by `limit` (default 100, at most 200) and `offset`.\n\nTakes every input kind (`vulnId`, `package`, `ecosystem`, `version`, `vendor`, `product`, `cpe`, `purl`, `swid`, `tei`, `cel`): they resolve to vulnerability ids (aliases included) and replace the `cveId` filter, and the answer gains `resolved`. Inputs that resolve to nothing answer an empty page, never an unfiltered one. `cveId` given alone keeps its own meaning (an exact match, no aliases).",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/attack-techniques?techniqueId=T1190&domain=Enterprise&limit=20'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb attack-techniques list --technique T1190"
          }
        ],
        "parameters": [
          {
            "name": "techniqueId",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Technique id, exact and case-sensitive (`T1190`, or `T1059.001` for a sub-technique); repeat for OR.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 9,
                "pattern": "^T[0-9]{4}(?:\\.[0-9]{3})?$"
              }
            },
            "example": [
              "T1190"
            ]
          },
          {
            "name": "tactic",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Tactic in kebab-case that the mapping's `tactics` must contain (for example `initial-access`, `execution`); repeat for AND.",
            "schema": {
              "type": "array",
              "maxItems": 20,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z][a-z-]{0,63}$"
              }
            },
            "example": [
              "initial-access"
            ]
          },
          {
            "$ref": "#/components/parameters/DetectionVexCveId"
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "The record source a mapping is keyed under, exact match (for example `nist-nvd`, `cve.org`); repeat for OR.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
              }
            },
            "example": [
              "nist-nvd"
            ]
          },
          {
            "name": "capecId",
            "in": "query",
            "required": false,
            "description": "CAPEC id, exact match. A bare number gets the `CAPEC-` prefix.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 12,
              "pattern": "^(?:CAPEC-)?[0-9]{1,6}$"
            },
            "example": "CAPEC-242"
          },
          {
            "name": "domain",
            "in": "query",
            "required": false,
            "description": "ATT&CK domain, exact match ignoring case (for example `Enterprise`, `Mobile`, `ICS`).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 32,
              "pattern": "^[A-Za-z][A-Za-z-]{0,31}$"
            },
            "example": "Enterprise"
          },
          {
            "name": "subtechnique",
            "in": "query",
            "required": false,
            "description": "Only sub-techniques (`true` or `1`) or only techniques (`false` or `0`); the words are case-insensitive. Any other value is ignored.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 5,
              "pattern": "^(?:[Tt][Rr][Uu][Ee]|[Ff][Aa][Ll][Ss][Ee]|[01])$"
            },
            "example": "false"
          },
          {
            "name": "derivedBy",
            "in": "query",
            "required": false,
            "description": "Provenance, exact match; `vulnetix` returns the AI-derived mappings only.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
            },
            "example": "vulnetix"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Free text on the technique name; whitespace-separated words must all appear (ILIKE).",
            "schema": {
              "$ref": "#/components/schemas/SafeText"
            },
            "example": "remote code"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only mappings created at or after this time.",
            "schema": {
              "$ref": "#/components/schemas/DetectionVexLooseTime"
            },
            "example": "2026-01-01T00:00:00Z"
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Only mappings created at or before this time.",
            "schema": {
              "$ref": "#/components/schemas/DetectionVexLooseTime"
            },
            "example": "2026-01-01T00:00:00Z"
          },
          {
            "$ref": "#/components/parameters/DetectionVexLimit200"
          },
          {
            "$ref": "#/components/parameters/DetectionVexOffset"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of matching mappings, with `resolved` when an input kind was given.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/DetectionVexCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/DetectionVexVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchAttackTechniquesResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 5120,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "attackTechniques": [
                    {
                      "uuid": "3d2a7c1e-9b4f-4e8a-a1c6-52f0d8e7b913",
                      "cveId": "CVE-2021-44228",
                      "source": "nist-nvd",
                      "id": "T1190",
                      "name": "Exploit Public-Facing Application",
                      "url": "https://attack.mitre.org/techniques/T1190/",
                      "domain": "Enterprise",
                      "subtechnique": false,
                      "tactics": [
                        "initial-access"
                      ],
                      "capecId": "CAPEC-136",
                      "mitigations": [
                        {
                          "id": "M1048",
                          "url": "https://attack.mitre.org/mitigations/M1048/",
                          "description": ""
                        }
                      ],
                      "detections": [
                        {
                          "id": "DS0015",
                          "datasource": "Application Log",
                          "detects": "Application Log Content"
                        }
                      ],
                      "d3fend": [
                        {
                          "mitigationId": "M1048",
                          "id": "D3-EAL",
                          "url": ""
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/DetectionVexSearchBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/DetectionVexUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/DetectionVexInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DetectionVexInputUnresolvable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/DetectionVexInternalError"
          },
          "503": {
            "$ref": "#/components/responses/DetectionVexUnavailable"
          }
        }
      }
    },
    "/auth/api-key": {
      "get": {
        "operationId": "issueApiKey",
        "tags": [
          "Authentication"
        ],
        "security": [
          {
            "SigV4": []
          }
        ],
        "summary": "Exchange a SigV4 signature for a static API key",
        "description": "Verifies a SigV4 `Authorization` header exactly as `GET /v2/auth/token` does (sign the path `/v2/auth/api-key`) and returns the static API key derived from your organisation secret: the lowercase hex `HMAC-SHA256(key = secret, message = orgId)`. Use it as `Authorization: ApiKey <orgId>:<apiKey>`, or as the password in a Package Firewall `.netrc`. The key stays valid until the secret is rotated.\n\nThe route is outside the API-key and rate-limit layer: it is not counted against the daily quota and answers no `403`, `409` or `429`. Every answer is `Cache-Control: no-store, private`.",
        "parameters": [
          {
            "name": "X-Amz-Date",
            "in": "header",
            "required": false,
            "description": "Request timestamp, `YYYYMMDDTHHMMSSZ` (UTC). It is the second line of the string to sign. When it is absent the `Date` header is used instead. Sign it and list it in `SignedHeaders` (the Vulnesis CLI signs only `x-amz-date`). The server checks neither its format nor its age; it only has to match what you signed.",
            "schema": {
              "type": "string",
              "pattern": "^[0-9]{8}T[0-9]{6}Z$",
              "minLength": 16,
              "maxLength": 16
            },
            "example": "20261105T093000Z"
          }
        ],
        "responses": {
          "200": {
            "description": "The signature verified; the derived API key is returned.",
            "headers": {
              "Cache-Control": {
                "description": "Always `no-store, private`: the answer is a per-caller credential.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "no-store, private"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssueApiKeyResponse"
                },
                "example": {
                  "success": true,
                  "orgId": "123e4567-e89b-12d3-a456-426614174000",
                  "apiKey": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
                }
              }
            }
          },
          "401": {
            "description": "The SigV4 credential was refused. `error` is one of: `Missing or invalid Authorization header. Expected AWS4-HMAC-SHA256 or AWS4-HMAC-SHA512 signature.` (no header, or another scheme), `Invalid AWS SigV4 Authorization header format` (the header does not parse, or the credential scope is not five `/`-separated parts ending in `aws4_request`), `Invalid credentials` (the access key is not an active organisation with a resolvable secret, including when the lookup itself fails), or `Invalid signature`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Invalid signature"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "Always `no-store, private`: the answer is a per-caller credential.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "no-store, private"
                  ]
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"X-Amz-Date: $AMZ_DATE\" -H \"Authorization: AWS4-HMAC-SHA512 Credential=$VULNESIS_ORG_ID/${AMZ_DATE:0:8}/us-east-1/vdb/aws4_request, SignedHeaders=x-amz-date, Signature=$SIGNATURE\" 'https://api.vdb.vulnes.is/v2/auth/api-key'"
          }
        ]
      }
    },
    "/auth/token": {
      "get": {
        "operationId": "issueToken",
        "tags": [
          "Authentication"
        ],
        "security": [
          {
            "SigV4": []
          }
        ],
        "summary": "Exchange a SigV4 signature for a session token",
        "description": "Verifies an AWS Signature Version 4 `Authorization` header signed with your organisation secret and returns a session token (JWT) valid for 15 minutes. Send it as `Authorization: Bearer <token>` on every other operation.\n\n**Signing.** The access key in the credential scope is your organisation UUID; the signing key is your organisation secret. Both `AWS4-HMAC-SHA512` and `AWS4-HMAC-SHA256` are accepted (a header labelled SHA512 is also tried as SHA-256). The canonical request is `GET`, the path `/v2/auth/token`, the raw query string (empty), the headers you list in `SignedHeaders`, and the hash of an empty body. The string to sign uses `X-Amz-Date` (or `Date` when it is absent). The region and service are taken from your credential scope; the Vulnesis CLI uses `us-east-1` and `vdb` and signs only `x-amz-date`, which works from a browser because `Host` is not signed.\n\nThe route is outside the API-key and rate-limit layer: it is not counted against the daily quota and answers no `403`, `409` or `429`. Every answer is `Cache-Control: no-store, private`.",
        "parameters": [
          {
            "name": "X-Amz-Date",
            "in": "header",
            "required": false,
            "description": "Request timestamp, `YYYYMMDDTHHMMSSZ` (UTC). It is the second line of the string to sign. When it is absent the `Date` header is used instead. Sign it and list it in `SignedHeaders` (the Vulnesis CLI signs only `x-amz-date`). The server checks neither its format nor its age; it only has to match what you signed.",
            "schema": {
              "type": "string",
              "pattern": "^[0-9]{8}T[0-9]{6}Z$",
              "minLength": 16,
              "maxLength": 16
            },
            "example": "20261105T093000Z"
          }
        ],
        "responses": {
          "200": {
            "description": "The signature verified; a session token was issued.",
            "headers": {
              "Cache-Control": {
                "description": "Always `no-store, private`: the answer is a per-caller credential.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "no-store, private"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssueTokenResponse"
                },
                "example": {
                  "token": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ1cm46dnVsbmV0aXg6dmRiIn0.c2lnbmF0dXJl",
                  "iss": "urn:vulnetix:vdb",
                  "sub": "urn:uuid:123e4567-e89b-12d3-a456-426614174000",
                  "exp": 1793872800
                }
              }
            }
          },
          "401": {
            "description": "The SigV4 credential was refused. `error` is one of: `Missing or invalid Authorization header. Expected AWS4-HMAC-SHA256 or AWS4-HMAC-SHA512 signature.` (no header, or another scheme), `Invalid AWS SigV4 Authorization header format` (the header does not parse, or the credential scope is not five `/`-separated parts ending in `aws4_request`), `Invalid credentials` (the access key is not an active organisation with a resolvable secret, including when the lookup itself fails), or `Invalid signature`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Invalid signature"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "Always `no-store, private`: the answer is a per-caller credential.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "no-store, private"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "The token could not be signed: `Server configuration error` when no signing secret is configured, or `Authentication failed` with `details` when signing fails.",
            "headers": {
              "Cache-Control": {
                "description": "Always `no-store, private`: the answer is a per-caller credential.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "no-store, private"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Server configuration error"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"X-Amz-Date: $AMZ_DATE\" -H \"Authorization: AWS4-HMAC-SHA512 Credential=$VULNESIS_ORG_ID/${AMZ_DATE:0:8}/us-east-1/vdb/aws4_request, SignedHeaders=x-amz-date, Signature=$SIGNATURE\" 'https://api.vdb.vulnes.is/v2/auth/token'"
          }
        ]
      },
      "post": {
        "operationId": "postAuthToken",
        "tags": [
          "Authentication"
        ],
        "security": [],
        "summary": "Reject a POST to the token endpoint",
        "description": "The token is issued only to a SigV4-signed `GET /v2/auth/token`. A `POST` to this path always answers `405 Method Not Allowed` with `Allow: GET`; the request body is not read.",
        "responses": {
          "405": {
            "description": "Wrong method. Use `GET` with a SigV4 `Authorization` header.",
            "headers": {
              "Allow": {
                "description": "Always `GET`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Authentication requires GET with AWS SigV4 Authorization header. POST is not supported."
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -X POST 'https://api.vdb.vulnes.is/v2/auth/token'"
          }
        ]
      }
    },
    "/aws/archive/{month}": {
      "get": {
        "operationId": "getAwsArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of AWS advisories",
        "description": "Returns every AWS advisory published in one calendar month (UTC): Amazon Linux Security Advisories (ALAS for Amazon Linux 1, 2 and 2023), AWS Security Bulletins and AWS SDK advisories. The month's advisories are found by publication date when the request is served. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `amazon` and `aws-security-bulletins`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/aws/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's AWS advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetAwsArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — AWS Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 0,
                  "severityCounts": {
                    "High": 1
                  },
                  "sourceBreakdown": {
                    "alas-al1": 0,
                    "alas-al2": 1,
                    "alas-al2023": 0,
                    "aws-bulletin": 0,
                    "aws-sdk": 0
                  },
                  "advisories": [
                    {
                      "advisoryId": "ALAS2-2024-2512",
                      "kind": "alas-al2",
                      "title": "Important: xz",
                      "severity": "Important",
                      "datePublished": 1711929600000,
                      "cveAliases": [
                        "CVE-2024-3094"
                      ],
                      "isExploited": false,
                      "advisoryUrl": "https://alas.aws.amazon.com/AL2/ALAS2-2024-2512.html",
                      "products": [
                        {
                          "productName": "xz",
                          "status": "affected",
                          "packageName": "xz"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-3094"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/aws/archives": {
      "get": {
        "operationId": "listAwsArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the AWS advisory archive",
        "description": "Lists every month that has AWS advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `alas-al1`, `alas-al2`, `alas-al2023`, `aws-bulletin`, `aws-sdk`, and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/aws/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with AWS advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "alas-al1": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "alas-al1": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/broadcom/archive/{month}": {
      "get": {
        "operationId": "getBroadcomArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Broadcom advisories",
        "description": "Returns every Broadcom advisory published in one calendar month (UTC): VMware Security Advisories (VMSA), Bitnami advisories and Cloud Foundry / Tanzu advisories. The month's VMSA and Bitnami advisories are found by publication date; Cloud Foundry / Tanzu advisories come from the precomputed archive snapshot, so a month the snapshot has not reached answers 503. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `broadcom-vmware` and `bitnami`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`. Only VMSA advisories carry `csafUrl`; VMSA advisories carry no `severity`; Cloud Foundry / Tanzu advisories always have an empty `products` list.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/broadcom/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Broadcom advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetBroadcomArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Broadcom Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 2,
                  "exploitedCount": 0,
                  "severityCounts": {
                    "High": 2
                  },
                  "sourceBreakdown": {
                    "vmsa": 1,
                    "bitnami": 0,
                    "cloudfoundry-tanzu": 0
                  },
                  "advisories": [
                    {
                      "advisoryId": "VMSA-2024-0006",
                      "kind": "vmsa",
                      "title": "VMware ESXi, Workstation, and Fusion updates address multiple security vulnerabilities",
                      "datePublished": 1709596800000,
                      "cveAliases": [
                        "CVE-2024-22252",
                        "CVE-2024-22253"
                      ],
                      "isExploited": false,
                      "advisoryUrl": "https://support.broadcom.com/web/ecx/support-content-notification/-/external/content/SecurityAdvisories/0/24266",
                      "csafUrl": "https://vulnes.is/broadcom-vmware/files/5f2c1a/VMSA-2024-0006.json",
                      "products": [
                        {
                          "productName": "ESXi",
                          "status": "affected",
                          "vendor": "VMware"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-22252",
                          "CVE-2024-22253"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/broadcom/archives": {
      "get": {
        "operationId": "listBroadcomArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Broadcom advisory archive",
        "description": "Lists every month that has Broadcom advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `vmsa`, `bitnami`, `cloudfoundry-tanzu`, and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/broadcom/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Broadcom advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "vmsa": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "vmsa": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/canonical/archive/{month}": {
      "get": {
        "operationId": "getCanonicalArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Canonical advisories",
        "description": "Returns every Canonical advisory published in one calendar month (UTC): Ubuntu Security Notices (`USN-*`). The month's advisories are found by publication date when the request is served. Each entry is one CVE row; `advisoryId` is the USN id (or the CVE id when no USN is recorded), so several entries can share one `advisoryId` (and then share one `risk` block). Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `canonical`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/canonical/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Canonical advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetCanonicalArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Canonical Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 0,
                  "severityCounts": {
                    "Medium": 1
                  },
                  "sourceBreakdown": {
                    "usn": 1
                  },
                  "advisories": [
                    {
                      "advisoryId": "USN-6718-1",
                      "kind": "usn",
                      "title": "curl vulnerabilities",
                      "severity": "medium",
                      "datePublished": 1711497600000,
                      "cveAliases": [
                        "CVE-2024-2398"
                      ],
                      "isExploited": false,
                      "advisoryUrl": "https://ubuntu.com/security/notices/USN-6718-1",
                      "products": [
                        {
                          "productName": "curl",
                          "status": "affected",
                          "packageName": "curl"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-2398"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/canonical/archives": {
      "get": {
        "operationId": "listCanonicalArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Canonical advisory archive",
        "description": "Lists every month that has Canonical advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `usn`, and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/canonical/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Canonical advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "usn": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "usn": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/cisco/archive/{month}": {
      "get": {
        "operationId": "getCiscoArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Cisco advisories",
        "description": "Returns every Cisco advisory published in one calendar month (UTC): Cisco PSIRT advisories (`cisco-sa-*`). The month's advisories are found by publication date when the request is served. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `cisco`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`. `sourceBreakdown.cisco-product` is always 0 in this answer.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/cisco/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Cisco advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetCiscoArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Cisco Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 1,
                  "severityCounts": {
                    "High": 1
                  },
                  "sourceBreakdown": {
                    "psirt": 1,
                    "cisco-product": 0
                  },
                  "advisories": [
                    {
                      "advisoryId": "cisco-sa-asaftd-websrvs-dos-X8gNucD2",
                      "kind": "psirt",
                      "title": "Cisco Adaptive Security Appliance and Firepower Threat Defense Software Web Services Denial of Service Vulnerability",
                      "severity": "HIGH",
                      "datePublished": 1713916800000,
                      "cveAliases": [
                        "CVE-2024-20353"
                      ],
                      "isExploited": true,
                      "advisoryUrl": "https://sec.cloudapps.cisco.com/security/center/content/CiscoSecurityAdvisory/cisco-sa-asaftd-websrvs-dos-X8gNucD2",
                      "products": [
                        {
                          "productName": "Cisco Adaptive Security Appliance (ASA) Software",
                          "status": "affected",
                          "vendor": "Cisco"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-20353"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "kevCisa": true,
                        "kevVulncheck": true,
                        "exploitMaturity": "active",
                        "exploitCount": 4
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/cisco/archives": {
      "get": {
        "operationId": "listCiscoArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Cisco advisory archive",
        "description": "Lists every month that has Cisco advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `psirt`, `cisco-product` (`cisco-product` counts CVEs from other sources that name Cisco as vendor; the month endpoint does not return them), and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/cisco/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Cisco advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "psirt": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "psirt": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/cloud-locators": {
      "get": {
        "operationId": "getCloudLocators",
        "tags": [
          "Cloud"
        ],
        "summary": "Get cloud resource locator templates",
        "description": "Cloud-native resource identifier templates (AWS ARN, Azure resource id, GCP resource name, Cloudflare locator, Oracle OCID, and Salesforce, SAP and ServiceNow URLs) for a vendor and product, with `{placeholders}` for the account-specific parts. Give `vendor`, `product` or both; with both the answer also carries `generatedCpe`. `cloudLocators` is null when no cloud service maps to the pair. The vendor picks the provider, so without a recognised `vendor` (such as `product` alone) `cloudLocators` is always null; with `vendor` alone the service is not pinned and the answer is the provider's longest-named registry entry, which is not a meaningful lookup.\n\n`vendor` and `product` here are lookup keys, trimmed and matched against the cloud service registry; they are not resolved as input kinds and the answer has no `resolved` block.\n\n**Plans.** Below Pro, `cloudLocators` and `generatedCpe` are null and listed in `_pro_data` and `_entitlements`.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.cloudLocators",
            "$.generatedCpe"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/cloud-locators?vendor=amazon&product=s3'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb cloud-locators --vendor amazon --product s3"
          }
        ],
        "parameters": [
          {
            "name": "vendor",
            "in": "query",
            "required": false,
            "description": "Vendor, such as `amazon`, `microsoft`, `google`, `cloudflare` or `oracle`. At least one of `vendor` and `product` is required.",
            "schema": {
              "$ref": "#/components/schemas/VendorName"
            },
            "example": "amazon"
          },
          {
            "name": "product",
            "in": "query",
            "required": false,
            "description": "Product or service, such as `s3`, `ec2` or `cloudfront`. At least one of `vendor` and `product` is required.",
            "schema": {
              "$ref": "#/components/schemas/ProductName"
            },
            "example": "s3"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "description": "Neither `vendor` nor `product` was given. When request validation is enforced, a request that does not fit this document is refused with `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "At least one of 'vendor' or 'product' query parameters is required"
                }
              }
            }
          },
          "200": {
            "description": "The locator templates.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/ThreatActivityCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetCloudLocatorsResponse"
                },
                "example": {
                  "vendor": "amazon",
                  "product": "s3",
                  "timestamp": 1762300800,
                  "cloudLocators": {
                    "matched": true,
                    "provider": "aws",
                    "service": "s3",
                    "templates": [
                      {
                        "provider": "aws",
                        "format": "arn",
                        "template": "arn:aws:s3:{region}:{account}:bucket/{resource-id}",
                        "region": "*",
                        "servicePrefix": "s3",
                        "resourceType": "bucket"
                      },
                      {
                        "provider": "aws",
                        "format": "arn",
                        "template": "arn:aws:s3:{region}:{account}:object/{resource-id}",
                        "region": "*",
                        "servicePrefix": "s3",
                        "resourceType": "object"
                      }
                    ]
                  },
                  "generatedCpe": "cpe:2.3:a:amazon:s3:*:*:*:*:*:*:*:*",
                  "_links": [
                    {
                      "rel": "search",
                      "href": "/v2/packages/search?q=s3"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/cloudflare/archive/{month}": {
      "get": {
        "operationId": "getCloudflareArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Cloudflare advisories",
        "description": "Returns every Cloudflare advisory published in one calendar month (UTC): Cloudflare GitHub security advisories, blog advisories (`CFADVISORY-*`) and changelog advisories (`CFADVISORY-CL-*`). The month's advisories are found by publication date when the request is served. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `cloudflare`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/cloudflare/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Cloudflare advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetCloudflareArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Cloudflare Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 0,
                  "severityCounts": {
                    "High": 1
                  },
                  "sourceBreakdown": {
                    "ghsa": 1,
                    "blog": 0,
                    "changelog": 0
                  },
                  "advisories": [
                    {
                      "advisoryId": "GHSA-9pp6-wq8c-3w2c",
                      "kind": "ghsa",
                      "title": "quiche vulnerable to unbounded storage of information related to connection ID retirement",
                      "severity": "HIGH",
                      "datePublished": 1710374400000,
                      "cveAliases": [
                        "CVE-2024-1410"
                      ],
                      "isExploited": false,
                      "advisoryUrl": "https://github.com/cloudflare/quiche/security/advisories/GHSA-9pp6-wq8c-3w2c",
                      "products": [
                        {
                          "productName": "quiche",
                          "status": "affected",
                          "packageName": "quiche"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-1410"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/cloudflare/archives": {
      "get": {
        "operationId": "listCloudflareArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Cloudflare advisory archive",
        "description": "Lists every month that has Cloudflare advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `ghsa`, `blog`, `changelog`, and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/cloudflare/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Cloudflare advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "ghsa": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "ghsa": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/countermeasures": {
      "get": {
        "operationId": "searchCountermeasures",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search countermeasures",
        "description": "Detection content derived from the proof-of-concept exploits Vulnesis has ingested: Sigma rules, YARA rules, STIX 2.1 bundles and OpenIOC documents. These are what a SIEM, an EDR or a threat platform observes.\n\nNarrow the catalogue by any input kind (a vulnerability id, a package with ecosystem and version, a purl, a vendor and product, a CPE, a SWID tag, a TEI or a CEL expression) and by the catalogue's own filters. Inputs resolve to vulnerabilities, and a defence matches when it is linked to one of them; with software inputs only, a defence whose exploit names the software matches too. Inputs that name nothing match nothing. With no input the whole catalogue is searched.\n\nFilters combine with AND; `kind` values combine with OR. An unknown `kind`, `confidence` or `deployMode` matches nothing rather than failing. `limit` defaults to 100 and is clamped to 200. For a CEL expression or a SWID tag too long for a query string, use the POST form.\n\n**Plans.** `count`, `total`, `byKind` and `resolved` are answered for every plan. The `countermeasures` list is Pro and above: below Pro it is `null`, and `_pro_data` and `_entitlements` (feature `countermeasures`) say so.",
        "parameters": [
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Kinds to keep (OR). Repeat the parameter or separate kinds with commas; matched case-insensitively. An unknown kind matches nothing.",
            "schema": {
              "type": "array",
              "maxItems": 16,
              "items": {
                "$ref": "#/components/schemas/CountermeasureKindList"
              }
            },
            "example": [
              "SIGMA"
            ]
          },
          {
            "$ref": "#/components/parameters/DefenceConfidence"
          },
          {
            "$ref": "#/components/parameters/DefenceDeployMode"
          },
          {
            "$ref": "#/components/parameters/DefenceExploitSource"
          },
          {
            "$ref": "#/components/parameters/DefenceQuery"
          },
          {
            "$ref": "#/components/parameters/DefenceLimit"
          },
          {
            "$ref": "#/components/parameters/DefenceOffset"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "Matching countermeasures.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchCountermeasuresResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 3,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "byKind": {
                    "SIGMA": 2,
                    "YARA": 1
                  },
                  "resolved": {
                    "kinds": [
                      "purl"
                    ],
                    "vulnIds": [
                      "CVE-2021-44228",
                      "GHSA-jfh8-c2jp-5v3q"
                    ],
                    "packages": [
                      {
                        "ecosystem": "maven",
                        "name": "org.apache.logging.log4j/log4j-core",
                        "version": "2.14.1"
                      }
                    ]
                  },
                  "countermeasures": [
                    {
                      "uuid": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f",
                      "artifactId": "vulnetix-cm-5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73-sigma",
                      "kind": "SIGMA",
                      "title": "Log4Shell JNDI lookup in process command line",
                      "confidence": "HIGH",
                      "deployMode": "log",
                      "falsePositiveRisk": "LOW",
                      "mitreTechIds": [
                        "T1190"
                      ],
                      "rawText": "title: Log4Shell JNDI lookup in process command line\nlogsource:\n  category: process_creation\ndetection:\n  selection:\n    CommandLine|contains: '${jndi:'\n  condition: selection\n",
                      "fileSize": 176,
                      "exploitUuid": "5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73",
                      "exploitId": "50592",
                      "exploitSource": "exploit-db",
                      "matchedCve": "CVE-2021-44228",
                      "archiveUrl": "/v2/countermeasures/9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f/archive",
                      "consoleUrl": "https://www.vulnes.is/resolve/countermeasures?dc=9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f#catalogue",
                      "createdAt": "2025-02-11T08:14:03Z",
                      "updatedAt": "2025-03-02T17:40:55Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "An input is malformed; `field` names it.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DefenceInputUnauthorized"
          },
          "413": {
            "$ref": "#/components/responses/DefenceInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DefenceInputUnresolvable"
          },
          "503": {
            "$ref": "#/components/responses/DefenceInputUnavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "countermeasures",
          "gatedFields": [
            "$.countermeasures"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/countermeasures?purl=pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1&kind=SIGMA&limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb countermeasures list --purl pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1 --kind SIGMA"
          }
        ]
      },
      "post": {
        "operationId": "searchCountermeasuresByBody",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search countermeasures with a JSON body",
        "description": "The same search as `GET /countermeasures`, with the inputs and filters in a JSON body: use it for a CEL expression or a SWID tag too long for a query string. The body is at most 256 KiB; a larger body is 413 and a malformed one 400. Send `{}` for the whole catalogue.\n\n`?limit=` and `?offset=` in the query string are honoured too; body `limit` and `offset` replace them when above 0. `limit` defaults to 100 and is clamped to 200.\n\n**Plans.** `count`, `total`, `byKind` and `resolved` are answered for every plan. The `countermeasures` list is Pro and above: below Pro it is `null`, and `_pro_data` and `_entitlements` (feature `countermeasures`) say so.",
        "parameters": [
          {
            "$ref": "#/components/parameters/DefenceLimit"
          },
          {
            "$ref": "#/components/parameters/DefenceOffset"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "At most 256 KiB.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DefenceSearchBody"
              },
              "example": {
                "cel": "component.name == \"log4j-core\"",
                "kind": [
                  "SIGMA"
                ],
                "confidence": "HIGH",
                "limit": 50
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Matching countermeasures.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchCountermeasuresResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 3,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "byKind": {
                    "SIGMA": 2,
                    "YARA": 1
                  },
                  "resolved": {
                    "kinds": [
                      "purl"
                    ],
                    "vulnIds": [
                      "CVE-2021-44228",
                      "GHSA-jfh8-c2jp-5v3q"
                    ],
                    "packages": [
                      {
                        "ecosystem": "maven",
                        "name": "org.apache.logging.log4j/log4j-core",
                        "version": "2.14.1"
                      }
                    ]
                  },
                  "countermeasures": [
                    {
                      "uuid": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f",
                      "artifactId": "vulnetix-cm-5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73-sigma",
                      "kind": "SIGMA",
                      "title": "Log4Shell JNDI lookup in process command line",
                      "confidence": "HIGH",
                      "deployMode": "log",
                      "falsePositiveRisk": "LOW",
                      "mitreTechIds": [
                        "T1190"
                      ],
                      "rawText": "title: Log4Shell JNDI lookup in process command line\nlogsource:\n  category: process_creation\ndetection:\n  selection:\n    CommandLine|contains: '${jndi:'\n  condition: selection\n",
                      "fileSize": 176,
                      "exploitUuid": "5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73",
                      "exploitId": "50592",
                      "exploitSource": "exploit-db",
                      "matchedCve": "CVE-2021-44228",
                      "archiveUrl": "/v2/countermeasures/9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f/archive",
                      "consoleUrl": "https://www.vulnes.is/resolve/countermeasures?dc=9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f#catalogue",
                      "createdAt": "2025-02-11T08:14:03Z",
                      "updatedAt": "2025-03-02T17:40:55Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The body is not valid JSON, an input has the wrong JSON type, or `kind` is neither a string nor a list of strings (`{error}`); or an input is malformed (`InputError`, `field` names it).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Invalid JSON body: http: request body too large"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DefenceInputUnauthorized"
          },
          "413": {
            "description": "The body is over 256 KiB (`{error: \"Invalid JSON body: http: request body too large\"}`), or an input is over its limit: more than 100 vulnerability ids, a field over 512 characters, a SWID tag over 64 KiB or a CEL expression over 4 KiB (`field` names the input).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "error": "Invalid JSON body: http: request body too large"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/DefenceInputUnresolvable"
          },
          "503": {
            "$ref": "#/components/responses/DefenceInputUnavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "countermeasures",
          "gatedFields": [
            "$.countermeasures"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -X POST -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -H 'Content-Type: application/json' 'https://api.vdb.vulnes.is/v2/countermeasures' -d '{\"cel\":\"component.name == \\\"log4j-core\\\"\",\"kind\":[\"SIGMA\"]}'"
          }
        ]
      }
    },
    "/countermeasures/{uuid}/archive": {
      "get": {
        "operationId": "downloadCountermeasure",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Download one countermeasure rule body",
        "description": "Serves one countermeasure's rule body as the file its tool expects, with the conventional filename (`<artifactId>-<name>`) and content type for its kind: SIGMA `sigma.yml` (application/yaml), YARA `rule.yar` (text/plain), STIX `bundle.json` (application/vnd.oasis.stix+json; version=2.1), OPENIOC `ioc.xml` (application/xml). A kind without a conventional file is served as `<artifactId>.txt`, text/plain.\n\n**Plans.** Pro and above. Below Pro the answer is HTTP 200 `application/json` with the `planLocked` marker (feature `countermeasures`), whatever the uuid. The gate reads the caller's Pro flag, not the plan rank.\n\nAn unknown uuid is 404; the uuid is not checked for shape.",
        "parameters": [
          {
            "name": "uuid",
            "in": "path",
            "required": true,
            "description": "The countermeasure's `uuid`, from a list or search answer (its `archiveUrl`).",
            "schema": {
              "$ref": "#/components/schemas/Uuid"
            },
            "example": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f"
          }
        ],
        "responses": {
          "200": {
            "description": "The rule body as its own file, or below Pro the `planLocked` marker (application/json).",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Content-Disposition": {
                "description": "`attachment; filename=\"<artifactId>-<conventional name>\"`. Not sent with the planLocked marker.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              },
              "X-Vulnetix-Sha256": {
                "description": "sha256 of the body, hex, when the record carries one.",
                "schema": {
                  "type": "string",
                  "maxLength": 128
                }
              },
              "X-Vulnetix-Defence-Kind": {
                "description": "The defence's kind. Not sent with the planLocked marker.",
                "schema": {
                  "$ref": "#/components/schemas/CountermeasureKind"
                }
              },
              "Cache-Control": {
                "description": "`private, max-age=300` with a rule body; `private, no-store` with the planLocked marker.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, max-age=300",
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "text/plain; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "maxLength": 1048576,
                  "description": "YARA bodies (`rule.yar`), and any kind without a conventional file (`<artifactId>.txt`), verbatim."
                },
                "example": "rule Log4Shell_JNDI { strings: $a = \"${jndi:\" nocase condition: $a }\n"
              },
              "application/yaml": {
                "schema": {
                  "type": "string",
                  "maxLength": 1048576,
                  "description": "A SIGMA body (`sigma.yml`), verbatim."
                },
                "example": "title: Log4Shell JNDI lookup in process command line\nlogsource:\n  category: process_creation\ndetection:\n  selection:\n    CommandLine|contains: '${jndi:'\n  condition: selection\n"
              },
              "application/vnd.oasis.stix+json; version=2.1": {
                "schema": {
                  "type": "object",
                  "maxProperties": 64,
                  "description": "A STIX body (`bundle.json`): the STIX 2.1 bundle, verbatim."
                }
              },
              "application/xml": {
                "schema": {
                  "type": "string",
                  "maxLength": 1048576,
                  "description": "An OPENIOC body (`ioc.xml`), verbatim."
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlanLocked"
                },
                "example": {
                  "planLocked": true,
                  "feature": "countermeasures",
                  "requiredPlan": "pro",
                  "upgrade": true,
                  "error": "Pro subscription required to download a defence rule",
                  "_pro_data": [
                    "countermeasures rule body"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "countermeasures",
                        "requiredPlan": "pro"
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "description": "No countermeasure has this uuid (`{\"error\": \"Not found\"}`), or the caller's organisation was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Not found"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "pro",
          "feature": "countermeasures"
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/countermeasures/9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f/archive'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb countermeasures fetch 9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f -o sigma.yml"
          }
        ]
      }
    },
    "/crit/lookup": {
      "post": {
        "operationId": "lookupCrit",
        "tags": [
          "Cloud"
        ],
        "summary": "Look up CRIT records for a cloud resource type",
        "description": "Which vulnerabilities affect a cloud resource type, as CRIT (Cloud Resource Identifier Template) records: send `provider`, `service` and `resource_type` (trimmed and lower-cased; the resource type is then matched in the dictionary's own spelling). Each match carries its CRIT record, the evidence for the match, and enrichment: record metadata, KEV, EPSS, CVSS, description, CWEs, exploit references and summary, Snort rule ids and messages, affected products and a CrowdSec summary under `malware`.\n\nMatches come from CRIT records and their aliases only; malicious-package advisories are left out. At most 500 matches: past that the 500 riskiest are kept (known-exploited, then EPSS, then CVSS) and `truncated` is true.\n\n`view=slim` drops `exploit_references`, `exploit_summary`, `snort_rules`, `affected_products` and `malware`, and is much cheaper.\n\nNo credential is needed and the route is outside the rate limiter. The body is capped at 16 KiB. Prefer the cacheable `GET /v2/crit/lookup/{provider}/{service}/{resource_type}`.",
        "security": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -X POST -H 'Content-Type: application/json' -d '{\"provider\":\"aws\",\"service\":\"rds\",\"resource_type\":\"db\"}' 'https://api.vdb.vulnes.is/v2/crit/lookup?view=slim'"
          }
        ],
        "parameters": [
          {
            "name": "view",
            "in": "query",
            "required": false,
            "description": "`slim` (any case) drops the costly enrichment; any other value, or none, answers in full.",
            "schema": {
              "type": "string",
              "enum": [
                "slim",
                "full"
              ]
            },
            "example": "slim"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "The resource type to look up. Unknown keys are ignored.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CritLookupRequest"
              },
              "example": {
                "provider": "aws",
                "service": "rds",
                "resource_type": "db"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The matches.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CritLookupResponse"
                },
                "example": {
                  "provider": "aws",
                  "service": "rds",
                  "resource_type": "db",
                  "timestamp": 1762300800,
                  "count": 1,
                  "dictionary_entry": {
                    "valid": true,
                    "template": "arn:aws:rds:{region}:{account}:db/{resource-id}",
                    "template_format": "aws_arn",
                    "region_behavior": "regional"
                  },
                  "match_strategies_applied": [
                    "crit_record"
                  ],
                  "matches": [
                    {
                      "vuln_id": "CVE-2023-12345",
                      "match_evidence": {
                        "strategies": [
                          "crit_record"
                        ],
                        "crit_pre_exists": true,
                        "confidence": "high"
                      },
                      "crit": {
                        "vectorString": "CRITv0.3.0/CP:AW/VS:AF/FP:VU/SR:SH/RL:SM/EV:T/PP:1685577600/SA:1257206400#CVE-2023-12345:rds:db",
                        "vuln_id": "CVE-2023-12345",
                        "provider": "aws",
                        "service": "rds",
                        "resource_type": "db",
                        "template": "arn:aws:rds:{region}:{account}:db/{resource-id}",
                        "template_format": "aws_arn",
                        "resource_lifecycle": "stateful_managed",
                        "shared_responsibility": "shared",
                        "vex_status": "affected",
                        "fix_propagation": "version_update",
                        "existing_deployments_remain_vulnerable": true,
                        "remediation_actions": [
                          {
                            "sequence": 1,
                            "type": "upgrade",
                            "title": "Upgrade the engine",
                            "description": "Apply the patched minor version.",
                            "auto_remediable": false,
                            "requires_downtime": true,
                            "compensating_control": false
                          }
                        ]
                      },
                      "crit_generated": false,
                      "cve_metadata": {
                        "state": "PUBLISHED",
                        "date_published": "2023-06-01"
                      },
                      "epss": {
                        "score": 0.0123,
                        "percentile": 0.81,
                        "date": "2025-11-04"
                      },
                      "cvss_metrics": [
                        {
                          "metric_type": "cvssV3_1",
                          "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H",
                          "base_score": 9.8,
                          "base_severity": "CRITICAL"
                        }
                      ],
                      "problem_types": [
                        {
                          "cwe_id": "CWE-89",
                          "description": "SQL Injection"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The body is not JSON, or `provider`, `service` or `resource_type` is missing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "provider, service, and resource_type are required"
                }
              }
            }
          },
          "413": {
            "description": "The body is over 16 KiB.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "request body exceeds 16384 bytes"
                }
              }
            }
          }
        }
      }
    },
    "/crit/lookup/{provider}/{service}/{resource_type}": {
      "get": {
        "operationId": "getCritLookup",
        "tags": [
          "Cloud"
        ],
        "summary": "Get CRIT records for a cloud resource type",
        "description": "The cacheable form of `POST /v2/crit/lookup`: the same answer, with the three keys in the path (a resource type containing `/` is sent as `%2F`). When there is at least one match the answer carries a strong `ETag` and `Cache-Control: public, max-age=3600, stale-while-revalidate=86400`, its `timestamp` is rounded down to the hour so the bytes stay the same for the hour, and a matching `If-None-Match` (weak comparison; `*` matches) answers 304 with no body. An answer with no matches carries neither header.\n\n`view=slim` drops `exploit_references`, `exploit_summary`, `snort_rules`, `affected_products` and `malware`.\n\nNo credential is needed and the route is outside the rate limiter.",
        "security": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl 'https://api.vdb.vulnes.is/v2/crit/lookup/aws/rds/db?view=slim'"
          }
        ],
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "description": "Cloud provider slug, any case.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "example": "aws"
          },
          {
            "name": "service",
            "in": "path",
            "required": true,
            "description": "Service slug as the CRIT dictionary names it, any case.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[A-Za-z0-9_-]{1,64}$"
            },
            "example": "rds"
          },
          {
            "name": "resource_type",
            "in": "path",
            "required": true,
            "description": "Resource type as the CRIT dictionary names it, any case.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 129,
              "pattern": "^[A-Za-z0-9_-]{1,64}(/[A-Za-z0-9_-]{1,64})?$"
            },
            "example": "db"
          },
          {
            "name": "view",
            "in": "query",
            "required": false,
            "description": "`slim` (any case) drops the costly enrichment; any other value, or none, answers in full.",
            "schema": {
              "type": "string",
              "enum": [
                "slim",
                "full"
              ]
            },
            "example": "slim"
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "An `ETag` from an earlier answer, a comma-separated list of them, or `*`.",
            "schema": {
              "type": "string",
              "maxLength": 1024,
              "pattern": "^(\\*|(W/)?\"[0-9a-f]{1,128}\"( *, *(W/)?\"[0-9a-f]{1,128}\"){0,7})$"
            },
            "example": "\"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\""
          }
        ],
        "responses": {
          "200": {
            "description": "The matches.",
            "headers": {
              "ETag": {
                "description": "Strong entity tag: the quoted SHA-256 of the body. Present when there is at least one match.",
                "schema": {
                  "type": "string",
                  "pattern": "^\"[0-9a-f]{64}\"$",
                  "maxLength": 66
                }
              },
              "Cache-Control": {
                "description": "Present when there is at least one match.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=3600, stale-while-revalidate=86400"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CritLookupResponse"
                },
                "example": {
                  "provider": "aws",
                  "service": "rds",
                  "resource_type": "db",
                  "timestamp": 1762297200,
                  "count": 0,
                  "dictionary_entry": {
                    "valid": true,
                    "template": "arn:aws:rds:{region}:{account}:db/{resource-id}",
                    "template_format": "aws_arn",
                    "region_behavior": "regional"
                  },
                  "match_strategies_applied": [],
                  "matches": []
                }
              }
            }
          },
          "304": {
            "description": "`If-None-Match` matched the current `ETag`; no body.",
            "headers": {
              "ETag": {
                "description": "The current entity tag.",
                "schema": {
                  "type": "string",
                  "pattern": "^\"[0-9a-f]{64}\"$",
                  "maxLength": 66
                }
              },
              "Cache-Control": {
                "description": "The cache policy.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=3600, stale-while-revalidate=86400"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`provider`, `service` or `resource_type` is empty.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "provider, service, and resource_type are required"
                }
              }
            }
          },
          "500": {
            "description": "The answer could not be encoded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "response encoding failed"
                }
              }
            }
          }
        }
      }
    },
    "/defences/counts": {
      "post": {
        "operationId": "countDefences",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Count virtual patches and countermeasures in bulk",
        "description": "For each item, the virtual patches and countermeasures its inputs resolve to: what the CLI asks for every unfixed finding of a scan in one call. Each item takes any input kinds and an optional `key` echoed on its result. Items are answered on their own: an invalid item carries an `error` (with the status a single-input route would answer) and the others are still counted.\n\nAt most 100 items and 256 KiB per request; the whole request has 45 seconds, after which unfinished items carry an error. Each lane lists 50 defences at most per item; `total` and `byKind` always cover them all. The request counts once against the daily quota.\n\n**Plans.** Counts are answered for every plan. The `defences` listed per lane, with their console links, are Pro and above: below Pro they are `null`, and `_pro_data` and `_entitlements` (features `virtual-patches` and `countermeasures`) say so.",
        "requestBody": {
          "required": true,
          "description": "At most 256 KiB.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DefenceCountsRequest"
              },
              "example": {
                "items": [
                  {
                    "key": "log4j",
                    "purl": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
                  },
                  {
                    "key": "bad",
                    "purl": "pkg:foo/bar@1.0"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "One result per item, in request order.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CountDefencesResponse"
                },
                "example": {
                  "schemaVersion": "defence-counts/v1",
                  "tier": "pro",
                  "timestamp": 1762300800,
                  "total": 2,
                  "items": [
                    {
                      "key": "log4j",
                      "resolved": {
                        "kinds": [
                          "purl"
                        ],
                        "vulnIds": [
                          "CVE-2021-44228",
                          "CVE-2021-45046"
                        ],
                        "packages": [
                          {
                            "ecosystem": "maven",
                            "name": "org.apache.logging.log4j/log4j-core",
                            "version": "2.14.1"
                          }
                        ]
                      },
                      "virtualPatches": {
                        "total": 2,
                        "byKind": {
                          "SNORT": 1,
                          "AWS_WAF": 1
                        },
                        "hasMore": false,
                        "defences": [
                          {
                            "uuid": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f",
                            "kind": "SNORT",
                            "title": "Log4Shell JNDI lookup in request",
                            "deployMode": "block",
                            "confidence": "HIGH",
                            "falsePositiveRisk": "LOW",
                            "matchedCve": "CVE-2021-44228",
                            "consoleUrl": "https://www.vulnes.is/resolve/virtual-patching?dc=9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f#catalogue"
                          },
                          {
                            "uuid": "0b7d8e2f-4c1a-4f3b-9e65-7a8b9c0d1e2f",
                            "kind": "AWS_WAF",
                            "title": "Log4Shell JNDI lookup in headers",
                            "deployMode": "log",
                            "confidence": "MEDIUM",
                            "matchedCve": "CVE-2021-44228",
                            "consoleUrl": "https://www.vulnes.is/resolve/virtual-patching?dc=0b7d8e2f-4c1a-4f3b-9e65-7a8b9c0d1e2f#catalogue"
                          }
                        ]
                      },
                      "countermeasures": {
                        "total": 0,
                        "byKind": {},
                        "hasMore": false,
                        "defences": []
                      }
                    },
                    {
                      "key": "bad",
                      "error": {
                        "field": "purl",
                        "message": "purl type \"foo\" is not an ecosystem this API knows",
                        "status": 400
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The body is not valid JSON, an item's input has the wrong JSON type (for example a number for `purl`), or `items` is missing or empty.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "items must hold at least one item"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "413": {
            "description": "More than 100 items, or a body over 256 KiB.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "at most 100 items per request"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": [
            "virtual-patches",
            "countermeasures"
          ],
          "gatedFields": [
            "$.items[*].virtualPatches.defences",
            "$.items[*].countermeasures.defences"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -X POST -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -H 'Content-Type: application/json' 'https://api.vdb.vulnes.is/v2/defences/counts' -d '{\"items\":[{\"key\":\"log4j\",\"purl\":\"pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1\"}]}'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb virtual-patches counts CVE-2021-44228 pkg:npm/lodash@4.17.20"
          }
        ]
      }
    },
    "/ecosystems": {
      "get": {
        "operationId": "listEcosystems",
        "tags": [
          "Enumerations"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List package ecosystems with package counts",
        "description": "Lists the package ecosystems observed in the database, each with the number of distinct package names seen in it, most packages first (ties by name).\n\nNames are lower-cased as stored (for example `npm`, `pypi`, `maven`, `go`); a package with no recorded ecosystem is counted under `unknown`. This is an observed vocabulary, not the canonical ecosystem list the input parameters accept. The list is computed at most once an hour. `ecosystems` is `null` when nothing is recorded.",
        "responses": {
          "200": {
            "description": "Ecosystems with package counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`, set by the authentication layer: the answer must not be stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListEcosystemsResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "ecosystems": [
                    {
                      "name": "npm",
                      "count": 3120456
                    },
                    {
                      "name": "pypi",
                      "count": 612340
                    },
                    {
                      "name": "maven",
                      "count": 498211
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/ecosystems'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ecosystems"
          }
        ]
      }
    },
    "/eol/calendar/{month}": {
      "get": {
        "operationId": "getEolCalendar",
        "tags": [
          "End-of-Life"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List end-of-life events in a month",
        "description": "Lists every lifecycle event dated in one calendar month: end of active support (`eoas`), end of security support (`eol`), end of extended support (`eoes`) and discontinuation (`discontinued`). A release with several events in the month appears once per event. Events are split into `microsoft` (products tagged `microsoft`, or one of the Windows, Windows Server, Office, SQL Server, Exchange, SharePoint, .NET, Visual Studio, Surface and GitHub Actions runner image products) and `other`, each sorted by date, then product label, then release label.\n\n`month` is `YYYY-MM`; anything else is 400. `windowStart` and `windowEnd` are the first and last millisecond of the month in UTC.\n\nBelow Pro only events of endoflife.date products are listed; `withheld` counts the vendor-lifecycle events left out (0 when none), and when it is above 0 an `_entitlements` marker names `eol-vendor-lifecycle`. Pro and above get neither key.",
        "x-vulnetix-plan": {
          "mode": "rows-withheld",
          "requiredPlan": "pro",
          "feature": "eol-vendor-lifecycle",
          "gatedFields": [
            "$.microsoft[*]",
            "$.other[*]"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/eol/calendar/2026-11'"
          }
        ],
        "parameters": [
          {
            "name": "month",
            "in": "path",
            "required": true,
            "description": "Calendar month, `YYYY-MM`.",
            "schema": {
              "$ref": "#/components/schemas/YearMonth"
            },
            "example": "2026-11"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's lifecycle events.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetEolCalendarResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "month": "2026-11",
                  "windowStart": 1793491200000,
                  "windowEnd": 1796083199999,
                  "microsoft": [
                    {
                      "product": "windows",
                      "productLabel": "Microsoft Windows",
                      "category": "os",
                      "linkIcon": "windows",
                      "linkHtml": "https://endoflife.date/windows",
                      "releaseName": "11-23h2-e",
                      "releaseLabel": "11 23H2 (E)",
                      "releaseDate": "2023-10-31",
                      "isLts": false,
                      "latestVersion": "10.0.22631",
                      "eolType": "eol",
                      "eolDate": "2026-11-10",
                      "isMicrosoft": true
                    }
                  ],
                  "other": [
                    {
                      "product": "kubernetes",
                      "productLabel": "Kubernetes",
                      "category": "server-app",
                      "linkIcon": "kubernetes",
                      "linkHtml": "https://endoflife.date/kubernetes",
                      "releaseName": "1.32",
                      "releaseLabel": "1.32",
                      "releaseDate": "2024-12-11",
                      "isLts": false,
                      "latestVersion": "1.32.9",
                      "eolType": "eoas",
                      "eolDate": "2026-11-28",
                      "isMicrosoft": false
                    }
                  ],
                  "withheld": 2,
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "eol-vendor-lifecycle",
                        "requiredPlan": "pro"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "`month` is not `YYYY-MM` (`Invalid month. Use YYYY-MM`, from the handler; or, when request validation runs in enforce mode, the validator's message with `field: month`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Invalid month. Use YYYY-MM"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/eol/categories": {
      "get": {
        "operationId": "listEolCategories",
        "tags": [
          "End-of-Life"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List end-of-life product categories",
        "description": "Lists every product category with the number of products in it, largest first. Use a category name as the `category` filter of the product list.\n\nCounts cover the products the caller's plan can see: below Pro only endoflife.date products are counted, Pro and above also count vendor-lifecycle products. Unlike the product list, this answer carries no `withheld` count or `_entitlements` marker.",
        "x-vulnetix-plan": {
          "mode": "rows-withheld",
          "requiredPlan": "pro",
          "feature": "eol-vendor-lifecycle",
          "gatedFields": []
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/eol/categories'"
          }
        ],
        "responses": {
          "200": {
            "description": "Categories with product counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListEolCategoriesResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "categories": [
                    {
                      "name": "server-app",
                      "count": 98
                    },
                    {
                      "name": "framework",
                      "count": 74
                    },
                    {
                      "name": "os",
                      "count": 61
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/eol/identifiers": {
      "get": {
        "operationId": "searchEolIdentifiers",
        "tags": [
          "End-of-Life"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search end-of-life products by identifier",
        "description": "Finds products by a substring of one of their identifiers (purl, CPE or Repology name), matched case-insensitively, ordered by identifier. Use it to go from a package or CPE to the product whose lifecycle applies. `q` is required; `type` narrows to one identifier type (exact match; a type with no identifiers answers no rows).\n\nPaging: `limit` defaults to 100 and is capped at 500 (a larger value is lowered to 500; zero, negative or non-numeric values fall back to 100); `offset` defaults to 0.\n\nBelow Pro only identifiers of endoflife.date products are searched; `withheld` counts the matching identifiers of vendor-lifecycle products left out (0 when none), and when it is above 0 an `_entitlements` marker names `eol-vendor-lifecycle`. Pro and above get neither key.\n\n`_links` holds one `product` link per match, plus a `vuln` link for an identifier that starts with `CVE-`; it is absent when there are no matches.",
        "x-vulnetix-plan": {
          "mode": "rows-withheld",
          "requiredPlan": "pro",
          "feature": "eol-vendor-lifecycle",
          "gatedFields": [
            "$.identifiers[*]"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/eol/identifiers?q=pkg:generic/python&type=purl'"
          }
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Identifier substring, matched case-insensitively. Surrounding whitespace is trimmed; an empty value is 400.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256,
              "pattern": "^(?:[A-Za-z0-9_:/@\\x2B~#-]|\\.[A-Za-z0-9_:/@\\x2B~#-])+\\.?$"
            },
            "example": "pkg:generic/python"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Identifier type, matched exactly. The types in the data are `purl`, `cpe` and `repology`; any other value answers no rows.",
            "schema": {
              "type": "string",
              "enum": [
                "purl",
                "cpe",
                "repology"
              ]
            },
            "example": "purl"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500 (larger values are lowered to 500).",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; this document bounds it at 100000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "A page of matching identifiers.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchEolIdentifiersResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "total": 1,
                  "limit": 100,
                  "offset": 0,
                  "hasMore": false,
                  "identifiers": [
                    {
                      "type": "purl",
                      "identifier": "pkg:generic/python",
                      "productName": "python",
                      "productLabel": "Python",
                      "category": "lang"
                    }
                  ],
                  "withheld": 0,
                  "_links": [
                    {
                      "rel": "product",
                      "href": "/v2/eol/products/python"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`q` is missing or blank (`Query parameter 'q' is required`, from the handler). When request validation runs in enforce mode (the `oas_validation_mode` flag), also any parameter that does not fit this document, for example a `type` outside the enum or a `limit` above 500, with the parameter named in `field`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Query parameter 'q' is required"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/eol/products": {
      "get": {
        "operationId": "listEolProducts",
        "tags": [
          "End-of-Life"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List end-of-life tracked products",
        "description": "Lists the products tracked for end-of-life status, ordered by label, with how many release cycles each has and how many are still maintained. Filter by exact `category`, by a `tag` substring, or by a `search` substring of the product name or label (case-insensitive); filters combine with AND.\n\nPaging: `limit` defaults to 100 and is capped at 500 (a larger value is lowered to 500; zero, negative or non-numeric values fall back to 100); `offset` defaults to 0 (negative or non-numeric values fall back to 0). `total` counts every match the caller may see and `hasMore` says whether another page follows.\n\nData comes from endoflife.date (open on every plan) and from vendor lifecycle pages Vulnesis collects (Pro). Below Pro only endoflife.date products are listed; `withheld` counts the vendor-lifecycle products the filters matched but the plan left out (0 when none), and when it is above 0 an `_entitlements` marker names `eol-vendor-lifecycle`. Pro and above get neither key.\n\n`_links` holds one `product` link per listed product and is absent when the page is empty.",
        "x-vulnetix-plan": {
          "mode": "rows-withheld",
          "requiredPlan": "pro",
          "feature": "eol-vendor-lifecycle",
          "gatedFields": [
            "$.products[*]"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/eol/products?category=framework&limit=50'"
          }
        ],
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Exact product category (for example `framework`, `os`, `database`, `lang`, `server-app`). Case-sensitive.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[A-Za-z0-9._-]+$"
            },
            "example": "framework"
          },
          {
            "name": "tag",
            "in": "query",
            "required": false,
            "description": "Tag substring, matched case-insensitively against the product's tags.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[A-Za-z0-9._+-]+$"
            },
            "example": "javascript"
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Substring of the product name or label, matched case-insensitively.",
            "schema": {
              "$ref": "#/components/schemas/SafeText"
            },
            "example": "node"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500 (larger values are lowered to 500).",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; this document bounds it at 100000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "A page of products.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListEolProductsResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "total": 312,
                  "limit": 2,
                  "offset": 0,
                  "hasMore": true,
                  "products": [
                    {
                      "name": "angular",
                      "label": "Angular",
                      "category": "framework",
                      "tags": [
                        "google",
                        "javascript"
                      ],
                      "icon": "angular",
                      "releaseCount": 19,
                      "maintainedCount": 3
                    },
                    {
                      "name": "nodejs",
                      "label": "Node.js",
                      "category": "framework",
                      "tags": [
                        "javascript-runtime"
                      ],
                      "icon": "nodedotjs",
                      "releaseCount": 24,
                      "maintainedCount": 4
                    }
                  ],
                  "withheld": 3,
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "eol-vendor-lifecycle",
                        "requiredPlan": "pro"
                      }
                    ]
                  },
                  "_links": [
                    {
                      "rel": "product",
                      "href": "/v2/eol/products/angular"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/eol/products/nodejs"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "description": "A parameter does not fit this document. Only when request validation runs in enforce mode (the `oas_validation_mode` flag; the default, log mode, lets the request through to the handler, which clamps or ignores the value as described above). The body names the parameter in `field`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "query parameter limit: must be <= 500",
                  "field": "limit"
                }
              }
            }
          }
        }
      }
    },
    "/eol/products/{product}": {
      "get": {
        "operationId": "getEolProduct",
        "tags": [
          "End-of-Life"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get end-of-life details for a product",
        "description": "Returns one product's lifecycle record: labels for its support phases, reference links, the purl/CPE/Repology identifiers that map to it, and every release cycle (newest release date first, undated last) with its LTS, active-support, security-support, extended-support and discontinued dates. The handler reads no query parameters.\n\nThe `product` slug is percent-decoded and matched exactly (case-sensitive). An unknown product is 404 `Product not found`.\n\nProducts from endoflife.date are open on every plan. A product from vendor lifecycle data Vulnesis collects is Pro: below Pro the answer is HTTP 200 with the `planLocked` marker for `eol-vendor-lifecycle`, plus `timestamp` and `productName`.\n\n`_links` holds a `search` link (package search for the product name) and one `release` link per release cycle.",
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "pro",
          "feature": "eol-vendor-lifecycle",
          "gatedFields": [
            "$.product"
          ],
          "exception": "Products sourced from endoflife.date are answered on every plan; only vendor-lifecycle products are gated."
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/eol/products/nodejs'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb eol product nodejs"
          }
        ],
        "parameters": [
          {
            "name": "product",
            "in": "path",
            "required": true,
            "description": "Product slug, as `name` in the product list. Percent-decoded, matched exactly.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._+-]+$"
            },
            "example": "nodejs"
          }
        ],
        "responses": {
          "200": {
            "description": "The product, or the `planLocked` marker when the product is vendor lifecycle data and the caller is below Pro.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/EolProductDetail"
                    },
                    {
                      "$ref": "#/components/schemas/EolPlanLocked"
                    }
                  ]
                },
                "example": {
                  "timestamp": 1762300800,
                  "product": {
                    "name": "nodejs",
                    "label": "Node.js",
                    "category": "framework",
                    "tags": [
                      "javascript-runtime"
                    ],
                    "aliases": [
                      "node"
                    ],
                    "versionCommand": "node --version",
                    "labels": {
                      "eoas": "Active Support",
                      "eol": "Security Support",
                      "eoes": null,
                      "discontinued": null
                    },
                    "links": {
                      "icon": "nodedotjs",
                      "html": "https://endoflife.date/nodejs",
                      "releasePolicy": "https://github.com/nodejs/Release"
                    },
                    "identifiers": [
                      {
                        "type": "cpe",
                        "id": "cpe:2.3:a:nodejs:node.js"
                      },
                      {
                        "type": "purl",
                        "id": "pkg:generic/node"
                      }
                    ],
                    "releases": [
                      {
                        "name": "22",
                        "codename": "Jod",
                        "label": "22 (LTS)",
                        "releaseDate": "2024-04-24",
                        "isLts": true,
                        "ltsFrom": "2024-10-29",
                        "isEoas": false,
                        "eoasFrom": "2025-10-21",
                        "isEol": false,
                        "eolFrom": "2027-04-30",
                        "isEoes": null,
                        "eoesFrom": null,
                        "isDiscontinued": null,
                        "discontinuedFrom": null,
                        "isMaintained": true,
                        "latest": {
                          "name": "22.11.0",
                          "date": "2025-10-28",
                          "link": "https://nodejs.org/en/blog/release/v22.11.0"
                        }
                      }
                    ]
                  },
                  "_links": [
                    {
                      "rel": "search",
                      "href": "/v2/packages/search?q=nodejs"
                    },
                    {
                      "rel": "release",
                      "href": "/v2/eol/products/nodejs/releases/22"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "`Product not found`: no product has this slug (the handler also answers 404 when the product lookup itself fails), or the caller's organisation was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Product not found"
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "description": "A parameter does not fit this document. Only when request validation runs in enforce mode (the `oas_validation_mode` flag; the default, log mode, lets the request through to the handler, which clamps or ignores the value as described above). The body names the parameter in `field`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "path parameter product: does not match pattern",
                  "field": "product"
                }
              }
            }
          }
        }
      }
    },
    "/eol/products/{product}/releases/{release}": {
      "get": {
        "operationId": "getEolRelease",
        "tags": [
          "End-of-Life"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get end-of-life details for a product release",
        "description": "Returns one release cycle of a product: its LTS, active-support, security-support, extended-support and discontinued flags and dates, and the latest patch version. This is the record the CLI's `--block-eol` gate grades a detected runtime against.\n\nBoth path segments are percent-decoded and matched exactly (case-sensitive). An unknown product or release is 404 `Release not found`.\n\nReleases of endoflife.date products are open on every plan. A release of a vendor-lifecycle product is Pro: below Pro the answer is HTTP 200 with the `planLocked` marker for `eol-vendor-lifecycle`, plus `timestamp` and `productName`.\n\n`_links` holds one `product` link.",
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "pro",
          "feature": "eol-vendor-lifecycle",
          "gatedFields": [
            "$.release"
          ],
          "exception": "Releases of products sourced from endoflife.date are answered on every plan; only vendor-lifecycle products are gated."
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/eol/products/python/releases/3.12'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb eol release python 3.12"
          }
        ],
        "parameters": [
          {
            "name": "product",
            "in": "path",
            "required": true,
            "description": "Product slug, as `name` in the product list. Percent-decoded, matched exactly.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._+-]+$"
            },
            "example": "python"
          },
          {
            "name": "release",
            "in": "path",
            "required": true,
            "description": "Release cycle name, as `releases[].name` on the product (for example `3.12`, `22.04`, `22`). Percent-decoded, matched exactly.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._+~-]+$"
            },
            "example": "3.12"
          }
        ],
        "responses": {
          "200": {
            "description": "The release, or the `planLocked` marker when the product is vendor lifecycle data and the caller is below Pro.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetEolReleaseResponse"
                    },
                    {
                      "$ref": "#/components/schemas/EolPlanLocked"
                    }
                  ]
                },
                "example": {
                  "timestamp": 1762300800,
                  "productName": "python",
                  "release": {
                    "name": "3.12",
                    "codename": null,
                    "label": "3.12",
                    "releaseDate": "2023-10-02",
                    "isLts": false,
                    "ltsFrom": null,
                    "isEoas": true,
                    "eoasFrom": "2025-04-08",
                    "isEol": false,
                    "eolFrom": "2028-10-31",
                    "isEoes": null,
                    "eoesFrom": null,
                    "isDiscontinued": null,
                    "discontinuedFrom": null,
                    "isMaintained": true,
                    "latest": {
                      "name": "3.12.12",
                      "date": "2025-10-09",
                      "link": "https://www.python.org/downloads/release/python-31212/"
                    }
                  },
                  "_links": [
                    {
                      "rel": "product",
                      "href": "/v2/eol/products/python"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "`Release not found`: the product has no release with this name, or the product does not exist (the handler also answers 404 when the lookup itself fails), or the caller's organisation was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Release not found"
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "description": "A parameter does not fit this document. Only when request validation runs in enforce mode (the `oas_validation_mode` flag; the default, log mode, lets the request through to the handler, which clamps or ignores the value as described above). The body names the parameter in `field`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "path parameter release: does not match pattern",
                  "field": "release"
                }
              }
            }
          }
        }
      }
    },
    "/exploit-sources": {
      "get": {
        "operationId": "listExploitSources",
        "tags": [
          "Enumerations"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List exploit reference sources with counts",
        "description": "Lists the distinct sources recorded on vulnerability references (for example `exploitdb`, `github`, `metasploit`), each with its reference count, most references first (ties by name). Empty sources are left out. Computed at most once an hour.",
        "responses": {
          "200": {
            "description": "Reference sources with counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`, set by the authentication layer: the answer must not be stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListExploitSourcesResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "exploitSources": [
                    {
                      "name": "github",
                      "count": 52011
                    },
                    {
                      "name": "exploitdb",
                      "count": 46102
                    },
                    {
                      "name": "metasploit",
                      "count": 2304
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/exploit-sources'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb exploits sources"
          }
        ]
      }
    },
    "/exploit-trends": {
      "get": {
        "operationId": "getExploitTrends",
        "tags": [
          "Exploit Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get the global exploit-trends rollup",
        "description": "Returns the catalogue-wide exploit-trends rollup computed daily: totals per evidence tier (mention, bounty, sighting, theoretical, weaponised, knownExploits, predicted) with their breakdowns, monthly (18 months) and yearly (10 years) series, the top 10 CVEs per tier and source, and up to 50 CVEs whose only signal is a prediction. A part missing from the stored rollup reads `{}` or `[]`. The answer is held for 24 hours and sent with `Cache-Control: public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`. It takes no parameters.\n\nNot plan-gated.",
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The answer could not be serialised, or an unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "description": "No rollup has been computed yet, it could not be read or parsed (`ErrorBody`), or a dependency did not answer or the service is in maintenance (retry after `Retry-After` seconds).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "Exploit trends not yet available, please retry shortly"
                }
              }
            }
          },
          "200": {
            "description": "The rollup.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=300, s-maxage=86400, stale-while-revalidate=86400"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetExploitTrendsResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "generatedAt": 1762246800,
                  "totals": {
                    "mention": {
                      "records": 1520,
                      "distinctCves": 980
                    },
                    "bounty": {
                      "records": 4210,
                      "distinctCves": 3105,
                      "resolvedCount": 3900,
                      "criticalCount": 310,
                      "highCount": 1220,
                      "topPrograms": [
                        {
                          "name": "nodejs",
                          "count": 88
                        }
                      ],
                      "bySource": [
                        {
                          "name": "hackerone",
                          "count": 4100
                        }
                      ]
                    },
                    "sighting": {
                      "crowdsec": 182000,
                      "circlSightings": 5400,
                      "shadowserver": 91000,
                      "shadowserverCves": 1450,
                      "shadowserverAnomalies": 300,
                      "shadowserverSurges": 120,
                      "shadowserverMassExploit": 64,
                      "shadowserverRansomware": 210,
                      "shadowserverUniqueIps": 880000,
                      "shadowserverCountries": 190,
                      "distinctIps": 41000,
                      "distinctCountries": 150,
                      "distinctCves": 2600,
                      "records": 278400
                    },
                    "theoretical": {
                      "records": 98000,
                      "distinctCves": 41000,
                      "s3Stored": 52000,
                      "vulncheckXdb": 23000,
                      "circlExploited": 900,
                      "publicPocRecords": 74000,
                      "bySource": [
                        {
                          "name": "github",
                          "count": 61000
                        }
                      ],
                      "byPlatform": [
                        {
                          "name": "linux",
                          "count": 12000
                        }
                      ]
                    },
                    "weaponised": {
                      "snort": 9800,
                      "nse": 640,
                      "nuclei": 3200,
                      "metasploit": 2400,
                      "distinctCves": 11000,
                      "records": 16040
                    },
                    "knownExploits": {
                      "cisaKev": 1460,
                      "euKev": 1390,
                      "vulncheckKev": 4100,
                      "vulnetixKev": 520,
                      "ransomwareKnown": 310,
                      "distinctCves": 4900,
                      "records": 7470,
                      "vulnetixReasons": {
                        "nuclei_template": 210,
                        "crowdsec_sighting": 180
                      }
                    },
                    "predicted": {
                      "epssScoredCves": 290000,
                      "epssHighCves": 2100,
                      "epssMediumCves": 5400,
                      "cessScoredCves": 180000,
                      "cessHighCves": 3100,
                      "avgEpss": 0.021
                    }
                  },
                  "monthly": [
                    {
                      "period": "2026-11",
                      "mention": 12,
                      "bounty": 40,
                      "sighting": 3100,
                      "theoretical": 610,
                      "weaponised": 95,
                      "knownExploits": 22,
                      "total": 3879
                    }
                  ],
                  "yearly": [
                    {
                      "period": "2026",
                      "mention": 410,
                      "bounty": 820,
                      "sighting": 61000,
                      "theoretical": 14000,
                      "weaponised": 2100,
                      "knownExploits": 480,
                      "total": 78810
                    }
                  ],
                  "topCvesByTier": {
                    "knownExploits": {
                      "cisa": [
                        {
                          "cveId": "CVE-2021-44228",
                          "total": 9
                        }
                      ]
                    },
                    "predicted": {
                      "epss": [
                        {
                          "cveId": "CVE-2023-4966",
                          "total": 1,
                          "score": 0.97
                        }
                      ]
                    }
                  },
                  "orphanedPredictions": [
                    {
                      "cveId": "CVE-2025-12345",
                      "epss": 0.81
                    }
                  ]
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/exploit-trends'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb exploit-trends"
          }
        ]
      }
    },
    "/exploit-types": {
      "get": {
        "operationId": "listExploitTypes",
        "tags": [
          "Enumerations"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List Exploit-DB exploit types with counts",
        "description": "Lists the distinct Exploit-DB exploit types recorded on references (for example `remote`, `local`, `webapps`, `dos`), each with its count, most first. The values are whatever the stored records hold; empty values are left out. Computed at most once an hour.",
        "responses": {
          "200": {
            "description": "Exploit types with counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`, set by the authentication layer: the answer must not be stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListExploitTypesResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "exploitTypes": [
                    {
                      "name": "webapps",
                      "count": 21044
                    },
                    {
                      "name": "remote",
                      "count": 11230
                    },
                    {
                      "name": "local",
                      "count": 6120
                    },
                    {
                      "name": "dos",
                      "count": 5980
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/exploit-types'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb exploits types"
          }
        ]
      }
    },
    "/exploits": {
      "get": {
        "operationId": "searchExploits",
        "tags": [
          "Exploit Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search vulnerabilities that have exploits",
        "description": "Pages through CVEs that carry exploit intelligence (ExploitDB, Metasploit, Nuclei, Nmap NSE, VulnCheck XDB, GitHub and other PoCs, CrowdSec), each enriched with CVSS, EPSS, CESS, CWEs, affected products, fix availability, KEV status, exploit counts per source, an exploitation-maturity score, a triviality rating and a timeline.\n\nFilters combine with AND. `limit` defaults to 100 and is capped at 100. There is no `total`: walk pages with `offset` while `hasMore` is true. Filter values the handler does not recognise are not rejected: an unknown `source` uses the default exploit predicate, an unknown `sort` sorts by `recent`, a `minEpss` outside 0-1 is ignored, and `inKev` other than `true`/`1` applies no KEV filter.\n\n**Plans.** Every plan gets the page and every count. Below Pro, each result's `sightings` (the CrowdSec summary and the VulnCheck XDB and reported-exploitation entries) is null and listed in `_pro_data` and `_entitlements`.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results per page. Values over 100 are capped; non-numeric or non-positive values use the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Results to skip. Non-numeric or negative values use 0.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Keep CVEs with an affected record whose collection URL contains this text (case-insensitive), for example `npm`, `pypi` or `maven`. This is a substring match, not the input-model ecosystem.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[A-Za-z0-9.+-]{1,64}$"
            },
            "example": "maven"
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "Keep CVEs with exploit intelligence from this source. `github` and `poc` both select CVEs with any Exploit-table artefact. Omitted, any exploit reference, Exploit-table artefact or VulnCheck KEV entry qualifies (CrowdSec-only CVEs need `source=crowdsec`).",
            "schema": {
              "type": "string",
              "enum": [
                "exploitdb",
                "metasploit",
                "nuclei",
                "nmap-nse",
                "vulncheck-xdb",
                "crowdsec",
                "github",
                "poc"
              ]
            },
            "example": "metasploit"
          },
          {
            "name": "severity",
            "in": "query",
            "required": false,
            "description": "Keep CVEs with a CVSS metric of this base severity. Case-insensitive.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 8,
              "pattern": "^(?:[Cc][Rr][Ii][Tt][Ii][Cc][Aa][Ll]|[Hh][Ii][Gg][Hh]|[Mm][Ee][Dd][Ii][Uu][Mm]|[Ll][Oo][Ww]|[Nn][Oo][Nn][Ee])$"
            },
            "example": "CRITICAL"
          },
          {
            "name": "inKev",
            "in": "query",
            "required": false,
            "description": "`true` or `1` keeps CVEs listed in the KEV table (CISA, ENISA or Vulnesis). Any other value applies no KEV filter.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "1",
                "false",
                "0"
              ]
            },
            "example": "true"
          },
          {
            "name": "minEpss",
            "in": "query",
            "required": false,
            "description": "Keep CVEs with an EPSS score at or above this value. Ignored outside 0-1.",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 1
            },
            "example": 0.5
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Keep CVEs whose id or title contains this text (case-insensitive).",
            "schema": {
              "$ref": "#/components/schemas/SafeText"
            },
            "example": "log4j"
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "`recent` (publication date, newest first), `epss` (latest EPSS, highest first), `severity` (highest CVSS base score first) or `maturity` (KEV listing, then CrowdSec sightings, then EPSS).",
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "epss",
                "severity",
                "maturity"
              ],
              "default": "recent"
            },
            "example": "epss"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The page query failed or timed out (15 s), or an unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "200": {
            "description": "One page of CVEs with exploit intelligence.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`: the answer depends on the caller's plan, so it is never stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExploitSearchResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "position": 0,
                  "take": 1,
                  "step": 1,
                  "filters": {
                    "ecosystem": null,
                    "source": "metasploit",
                    "severity": "CRITICAL",
                    "inKev": true,
                    "minEpss": null,
                    "q": null,
                    "sort": "recent"
                  },
                  "results": [
                    {
                      "cveId": "CVE-2021-44228",
                      "state": "PUBLISHED",
                      "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                      "description": "Apache Log4j2 2.0-beta9 through 2.15.0 JNDI features used in configuration, log messages, and parameters do not protect against attacker controlled LDAP and other JNDI related endpoints.",
                      "aliases": [
                        "GHSA-jfh8-c2jp-5v3q"
                      ],
                      "metrics": {
                        "cvssV2": null,
                        "cvssV3_0": null,
                        "cvssV3_1": {
                          "baseScore": 10.0,
                          "baseSeverity": "CRITICAL",
                          "vectorString": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H",
                          "source": "nvd@nist.gov"
                        },
                        "cvssV4_0": null,
                        "highestSeverity": "CRITICAL",
                        "highestScore": 10.0
                      },
                      "epss": {
                        "score": 0.94358,
                        "percentile": 0.99957,
                        "date": "2026-11-04"
                      },
                      "cess": null,
                      "cwes": [
                        {
                          "cweId": "CWE-502",
                          "description": "Deserialization of Untrusted Data"
                        }
                      ],
                      "affectedProducts": [
                        {
                          "vendor": "Apache Software Foundation",
                          "product": "Apache Log4j2",
                          "packageName": "org.apache.logging.log4j:log4j-core",
                          "ecosystem": "maven",
                          "collectionURL": "https://repo.maven.apache.org/maven2",
                          "versions": [
                            {
                              "version": "2.0-beta9",
                              "status": "affected",
                              "lessThan": "2.15.0",
                              "lessThanOrEqual": null,
                              "versionType": "maven"
                            }
                          ]
                        }
                      ],
                      "fixAvailability": {
                        "hasFixedVersion": true,
                        "fixedVersionCount": 4
                      },
                      "kev": {
                        "inCisaKev": true,
                        "inVulnCheckKev": true,
                        "cisaDateAdded": "2021-12-10T00:00:00Z",
                        "cisaDueDate": "2021-12-24T00:00:00Z",
                        "cisaOverdue": true,
                        "knownRansomwareCampaignUse": "Known"
                      },
                      "ecosystems": [
                        "maven"
                      ],
                      "provenance": {
                        "source": "nvd",
                        "dataOrigin": "NVD"
                      },
                      "timeline": {
                        "datePublished": "2021-12-10T00:00:00Z",
                        "dateUpdated": "2026-11-01T06:12:00Z",
                        "currentAgeDays": 1791,
                        "lifecycleStage": "MATURE",
                        "publicationToKevDays": 0,
                        "publicationToFirstExploitDays": 0,
                        "firstExploitDate": "2021-12-10T08:00:00Z"
                      },
                      "exploitSources": {
                        "exploitDb": 3,
                        "metasploit": 2,
                        "nuclei": 4,
                        "nmapNse": 1,
                        "vulnerabilityLab": 0,
                        "vulnCheckXDB": 41,
                        "vulnCheckReportedExploitation": 12,
                        "crowdSec": 380,
                        "github": 220,
                        "poc": 15,
                        "total": 678
                      },
                      "exploitationMaturity": {
                        "score": 100,
                        "level": "WIDESPREAD",
                        "confidence": "VERY_HIGH"
                      },
                      "exploitTriviality": {
                        "level": "TURNKEY",
                        "reasoning": "Metasploit module available"
                      },
                      "sightings": null,
                      "_links": [
                        {
                          "rel": "info",
                          "href": "/v2/info/CVE-2021-44228"
                        },
                        {
                          "rel": "vuln",
                          "href": "/v2/vuln/CVE-2021-44228"
                        }
                      ]
                    }
                  ],
                  "_pro_data": [
                    "$.results[*].sightings"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "full-enrichment",
                        "requiredPlan": "pro",
                        "paths": [
                          "$.results[*].sightings"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.results[*].sightings"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/exploits?severity=CRITICAL&source=metasploit&limit=10'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb exploits search --severity CRITICAL --source metasploit --limit 10"
          }
        ]
      }
    },
    "/exploits/{exploitUuid}/archive": {
      "get": {
        "operationId": "downloadExploitArchive",
        "tags": [
          "Exploit Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Download an archived exploit file",
        "description": "Streams the stored copy of one exploit file. The media type follows the file extension (`.py`, `.rb`, `.sh`, `.pl`, `.php`, `.js`, `.json`, `.md`, `.html`, `.xml`, `.yaml`, `.txt`; anything else is `application/octet-stream`), and `Content-Disposition` names the file. `X-Vulnetix-Sha256` carries the stored content hash and `X-Vulnetix-Original-Url` the upstream source, when known. Get uuids from `GET /vuln/{identifier}/exploits`.\n\nAn unknown uuid answers 404 `Exploit not found`; a record with no stored copy answers 404 with its `originalUrl`; a copy that has left storage answers 410.\n\n**Plans.** Pro and above. Below Pro the answer is HTTP 200 with a `planLocked` body (feature `exploit-archive`), never 403.",
        "parameters": [
          {
            "name": "exploitUuid",
            "in": "path",
            "required": true,
            "description": "The exploit's uuid, from `GET /vuln/{identifier}/exploits`. Any other string answers 404.",
            "schema": {
              "$ref": "#/components/schemas/Uuid"
            },
            "example": "6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "No exploit has this uuid, or it has no stored copy (`originalUrl` then carries the upstream URL); or the caller's organisation was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ExploitArchiveNotFound"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "error": "No archive on file for this exploit",
                  "originalUrl": "https://github.com/kozmer/log4j-shell-poc"
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "Object storage failed or is not configured, or an unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "200": {
            "description": "The file (Pro and above), or the `planLocked` JSON body below Pro.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Content-Disposition": {
                "description": "`attachment; filename=\"<name>\"`. Absent on the planLocked body.",
                "schema": {
                  "type": "string",
                  "maxLength": 1100
                }
              },
              "X-Vulnetix-Sha256": {
                "description": "The stored content hash of the file, when known.",
                "schema": {
                  "type": "string",
                  "maxLength": 128
                }
              },
              "X-Vulnetix-Original-Url": {
                "description": "The upstream URL the file was taken from, when known.",
                "schema": {
                  "type": "string",
                  "maxLength": 2048
                }
              },
              "Cache-Control": {
                "description": "`private, max-age=300` on the file; `private, no-store` on the planLocked body.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, max-age=300",
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ExploitArchivePlanLocked"
                    },
                    {
                      "description": "A stored `.json` file, verbatim."
                    }
                  ]
                },
                "example": {
                  "planLocked": true,
                  "feature": "exploit-archive",
                  "requiredPlan": "pro",
                  "upgrade": true,
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "exploit-archive",
                        "requiredPlan": "pro"
                      }
                    ]
                  },
                  "error": "Pro subscription required to download archived exploit files",
                  "_pro_data": [
                    "exploit archive download"
                  ]
                }
              },
              "text/plain; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "text/x-python": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/x-ruby": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/x-sh": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "text/x-perl": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/x-httpd-php": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/javascript": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "text/markdown; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "text/html; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/xml": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/yaml": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "The uuid segment is empty.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Missing exploit UUID"
                }
              }
            }
          },
          "410": {
            "description": "The record names a stored copy that is no longer in object storage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExploitArchiveGone"
                },
                "example": {
                  "error": "Archive is no longer available",
                  "originalUrl": "https://github.com/kozmer/log4j-shell-poc",
                  "r2Key": "exploits/github/kozmer/log4j-shell-poc/poc.py"
                }
              }
            }
          }
        },
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "pro",
          "feature": "exploit-archive"
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/exploits/6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b/archive' -OJ"
          }
        ]
      }
    },
    "/exploits/{exploitUuid}/archive/meta": {
      "get": {
        "operationId": "getExploitArchiveMeta",
        "tags": [
          "Exploit Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get an archived exploit file's metadata",
        "description": "Returns an archived exploit's database record and what object storage holds for it (key, size, media type, last modified, ETag), so a caller can inspect it before downloading. `s3.exists` is false when the object is missing or storage is not configured, and `s3.error` carries any other storage failure. An unknown uuid answers 404 `Exploit not found`; a record with no stored copy answers 404 with the record and `s3: {\"exists\": false}`.\n\n**Plans.** Pro and above. Below Pro the answer is HTTP 200 with a `planLocked` body (feature `exploit-archive`), never 403.",
        "parameters": [
          {
            "name": "exploitUuid",
            "in": "path",
            "required": true,
            "description": "The exploit's uuid, from `GET /vuln/{identifier}/exploits`. Any other string answers 404.",
            "schema": {
              "$ref": "#/components/schemas/Uuid"
            },
            "example": "6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "No exploit has this uuid, or it has no stored copy (the body then carries the record and `s3`); or the caller's organisation was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ExploitArchiveNotFound"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "error": "Exploit not found"
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "200": {
            "description": "The metadata (Pro and above), or the `planLocked` body below Pro.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetExploitArchiveMetaResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ExploitArchivePlanLocked"
                    }
                  ]
                },
                "example": {
                  "exploit": {
                    "uuid": "6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b",
                    "exploitId": "kozmer/log4j-shell-poc",
                    "source": "github",
                    "title": "log4j-shell-poc",
                    "author": "kozmer",
                    "platform": "java",
                    "category": "poc",
                    "originalUrl": "https://github.com/kozmer/log4j-shell-poc",
                    "sourceArchiveUrl": null,
                    "bodyContentHash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
                    "fileSize": 4321,
                    "createdAt": 1639353600000,
                    "datePublished": "2021-12-12T00:00:00Z"
                  },
                  "s3": {
                    "key": "exploits/github/kozmer/log4j-shell-poc/poc.py",
                    "exists": true,
                    "contentType": "text/x-python",
                    "fileSize": 4321,
                    "lastModified": "2026-03-02T11:04:00Z",
                    "etag": "5d41402abc4b2a76b9719d911017c592"
                  },
                  "filename": "poc.py",
                  "archiveUrl": "/v2/exploits/6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b/archive"
                }
              }
            }
          },
          "400": {
            "description": "The uuid segment is empty.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Missing exploit UUID"
                }
              }
            }
          }
        },
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "pro",
          "feature": "exploit-archive"
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/exploits/6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b/archive/meta'"
          }
        ]
      }
    },
    "/exploits/{identifier}": {
      "get": {
        "operationId": "getVulnExploitIntelligence",
        "tags": [
          "Exploit Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get exploit and sighting records for a vulnerability",
        "description": "Returns every exploit, sighting, bug-bounty and KEV record held for one vulnerability: exploit references (with ExploitDB, Metasploit, Nuclei, VulnerabilityLab and GitHub detail), VulnCheck XDB exploits, CrowdSec sightings, PoCs and archived exploit files, VulnCheck reported exploitations, HackerOne/Bugcrowd/Intigriti reports, Shadowserver observations, and ENISA and Vulnesis KEV entries.\n\nThe identifier is an advisory id; aliases are followed. Unlike `/vuln/{identifier}/exploits`, this route takes no purl, CPE, TEI or SWID tag (a recorded exception in `.repo/inputs.md`). The `exploits` array is paged, newest first (`limit` default 100, capped at 1000; `offset` past the end gives an empty page); `count` is the page size, while `total`, `exploitCount`, `sightingCount` and `summary` describe the whole set. Out-of-range `limit` or `offset` values use the default rather than failing. `include_content=true` adds the stored ExploitDB code and Metasploit module source where available. An unknown vulnerability answers 200 with zero records.\n\n**Plans.** Every plan gets the counts and summary. Below Pro, `exploits` is null and listed in `_pro_data` and `_entitlements`.",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "A vulnerability id (CVE, GHSA and other families). Aliases are followed.",
            "schema": {
              "$ref": "#/components/schemas/VulnId"
            },
            "example": "CVE-2021-44228"
          },
          {
            "name": "includeContent",
            "in": "query",
            "required": false,
            "description": "`true` adds `exploitDb.rawContent` and `metasploit.moduleContent` from storage where held. Any other value leaves them out.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ],
              "default": "false"
            },
            "example": "true"
          },
          {
            "name": "include_content",
            "in": "query",
            "required": false,
            "description": "Deprecated spelling of `includeContent`; still accepted. `true` adds `exploitDb.rawContent` and `metasploit.moduleContent` from storage where held. Any other value leaves them out.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ],
              "default": "false"
            },
            "example": "true",
            "deprecated": true
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Records in the `exploits` page. Over 1000 is capped; non-numeric or non-positive values use 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 1000,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Records to skip. Non-numeric or negative values use 0.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "200": {
            "description": "The records and counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`: the answer depends on the caller's plan, so it is never stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetVulnExploitIntelligenceResponse"
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 2,
                  "total": 16412,
                  "limit": 2,
                  "offset": 0,
                  "hasMore": true,
                  "exploitCount": 16030,
                  "sightingCount": 382,
                  "summary": {
                    "exploitDb": 3,
                    "metasploit": 2,
                    "nuclei": 4,
                    "nmapNse": 1,
                    "vulnerabilityLab": 0,
                    "vulnCheckXDB": 41,
                    "vulnCheckReportedExploitation": 12,
                    "crowdSec": 380,
                    "shadowserver": 0,
                    "circl": 0,
                    "misp": 0,
                    "enisaKev": 1,
                    "vulnetixKev": 1,
                    "hackerone": 2,
                    "bugcrowd": 0,
                    "intigriti": 0,
                    "bugBounty": 0,
                    "github": 220,
                    "poc": 15745,
                    "other": 6
                  },
                  "exploits": [
                    {
                      "uuid": "2f1c7a8e-5b1d-4c39-9d8e-1a2b3c4d5e6f",
                      "cveId": "CVE-2021-44228",
                      "source": "nvd",
                      "url": "https://www.exploit-db.com/exploits/50592",
                      "type": "exploit",
                      "referenceSource": "exploit-db",
                      "title": "Apache Log4j 2 - Remote Code Execution (RCE)",
                      "httpStatus": 200,
                      "deadLink": false,
                      "createdAt": 1639353600000,
                      "exploitDb": {
                        "id": "50592",
                        "author": "kozmer",
                        "platform": "java",
                        "type": "remote",
                        "port": null,
                        "verified": false,
                        "rawUrl": "https://www.exploit-db.com/raw/50592",
                        "date": 1639353600000
                      }
                    },
                    {
                      "uuid": "c8a1d2e3-4f50-4617-8a9b-0c1d2e3f4a5b",
                      "cveId": "CVE-2021-44228",
                      "source": "crowdsec",
                      "type": "sighting",
                      "crowdSec": {
                        "ip": "203.0.113.24",
                        "reputation": "malicious",
                        "confidence": "high",
                        "backgroundNoiseScore": 10,
                        "firstSeen": 1639180800000,
                        "lastSeen": 1762214400000,
                        "asName": "EXAMPLE-AS",
                        "asNum": 64500,
                        "country": "NL",
                        "city": "Amsterdam",
                        "latitude": 52.37,
                        "longitude": 4.89,
                        "behaviors": [
                          "http:exploit"
                        ],
                        "attackDetails": [
                          "crowdsecurity/apache_log4j2_cve-2021-44228"
                        ],
                        "mitreTechniques": [
                          "T1190"
                        ],
                        "reverseDns": null,
                        "targetCountries": null
                      }
                    }
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier segment is empty.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Missing vulnerability identifier"
                }
              }
            }
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.exploits"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/exploits/CVE-2021-44228?limit=100'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb exploits CVE-2021-44228 --limit 100"
          }
        ]
      }
    },
    "/fix-distributions": {
      "get": {
        "operationId": "listFixDistributions",
        "tags": [
          "Enumerations"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List Linux distributions with fix advisories",
        "description": "Lists the seven Linux distributions whose security advisories are recognised in vulnerability references (Ubuntu, Debian, Red Hat, AlmaLinux, Alpine, SUSE, Rocky Linux), always in that order, each with its advisory id prefix (null for Alpine, which has none) and the number of references that point at its advisories. Computed at most once an hour.",
        "responses": {
          "200": {
            "description": "Distributions with advisory reference counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`, set by the authentication layer: the answer must not be stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListFixDistributionsResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "distributions": [
                    {
                      "name": "ubuntu",
                      "displayName": "Ubuntu",
                      "advisoryPrefix": "USN",
                      "count": 61200
                    },
                    {
                      "name": "debian",
                      "displayName": "Debian",
                      "advisoryPrefix": "DSA",
                      "count": 30411
                    },
                    {
                      "name": "redhat",
                      "displayName": "Red Hat",
                      "advisoryPrefix": "RHSA",
                      "count": 48120
                    },
                    {
                      "name": "almalinux",
                      "displayName": "AlmaLinux",
                      "advisoryPrefix": "ALSA",
                      "count": 9120
                    },
                    {
                      "name": "alpine",
                      "displayName": "Alpine Linux",
                      "advisoryPrefix": null,
                      "count": 3011
                    },
                    {
                      "name": "suse",
                      "displayName": "openSUSE / SUSE",
                      "advisoryPrefix": "openSUSE-SU",
                      "count": 12004
                    },
                    {
                      "name": "rockylinux",
                      "displayName": "Rocky Linux",
                      "advisoryPrefix": "RLSA",
                      "count": 4310
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/fix-distributions'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb fixes distributions"
          }
        ]
      }
    },
    "/gcve": {
      "get": {
        "operationId": "searchGcve",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List CVE JSON 5 records published in a date range",
        "description": "Source records published between two dates (inclusive, UTC), newest first, each as a CVE JSON 5 record with the Vulnesis enrichment container. Despite the path, the range is over every source record, not GCVE issuances only; for GCVE issuances use `/gcve/{year}/{month}`.\n\nDates are `YYYY-MM-DD`; `start` after `end` is a 400. A `start` beyond 2038-01-19 answers an empty page (publication times are stored as 32-bit seconds). Each record is built on request, so a large `limit` is slow. Open to every plan.",
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "required": true,
            "description": "First day, `YYYY-MM-DD`.",
            "schema": {
              "$ref": "#/components/schemas/Date"
            },
            "example": "2024-01-01"
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "description": "Last day, `YYYY-MM-DD`, inclusive.",
            "schema": {
              "$ref": "#/components/schemas/Date"
            },
            "example": "2024-01-31"
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "Only this source's records: an exact, case-sensitive match on the stored source name (`nist-nvd`, `github`, `osv`, `redhat`, `msrc` and the rest).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
            },
            "example": "nist-nvd"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Default 100; a value above 500 is lowered to 500, and a value that is not a positive integer is replaced by the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; this document bounds it at 100000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "A page of records.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GcveSearchResponse"
                },
                "example": {
                  "timestamp": 1793836800,
                  "total": 3120,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "dateRange": {
                    "start": "2021-12-01",
                    "end": "2021-12-31"
                  },
                  "records": [
                    {
                      "dataType": "CVE_RECORD",
                      "dataVersion": "5.1",
                      "cveMetadata": {
                        "cveId": "CVE-2021-44228",
                        "assignerOrgId": "8254265b-2729-46b6-b9e3-3dfca2d5bfca",
                        "state": "PUBLISHED",
                        "datePublished": "2021-12-10T00:00:00Z",
                        "dateUpdated": "2024-08-04T00:00:00Z"
                      },
                      "containers": {
                        "cna": {
                          "providerMetadata": {
                            "orgId": "8254265b-2729-46b6-b9e3-3dfca2d5bfca",
                            "shortName": "apache"
                          },
                          "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                          "descriptions": [
                            {
                              "lang": "en",
                              "value": "Apache Log4j2 2.0-beta9 through 2.15.0 JNDI features ... allow remote code execution."
                            }
                          ],
                          "affected": [
                            {
                              "vendor": "Apache Software Foundation",
                              "product": "Apache Log4j2",
                              "versions": [
                                {
                                  "version": "2.0-beta9",
                                  "status": "affected",
                                  "lessThan": "2.15.0",
                                  "versionType": "maven"
                                }
                              ]
                            }
                          ],
                          "references": [
                            {
                              "url": "https://logging.apache.org/log4j/2.x/security.html"
                            }
                          ]
                        },
                        "adp": [
                          {
                            "providerMetadata": {
                              "orgId": "8254265b-2729-46b6-b9e3-3dfca2d5bfca",
                              "shortName": "VVD"
                            },
                            "title": "Vulnesis Vulnerability Database Enrichment",
                            "x_generatorVersion": "0.2.0",
                            "x_generatedAt": "2026-11-05T00:00:00Z",
                            "x_enrichmentSource": "Vulnesis Vulnerability Database",
                            "x_dataSource": "nist-nvd",
                            "x_dataCollected": [
                              "descriptions",
                              "affected",
                              "references",
                              "epss",
                              "kev"
                            ],
                            "x_epss": {
                              "score": 0.94358,
                              "percentile": 0.99957,
                              "date": "2026-11-04",
                              "modelVersion": "v2025.03.14"
                            },
                            "tags": [
                              "x_actively-exploited",
                              "x_critical-severity"
                            ]
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`start` or `end` is missing or not a real `YYYY-MM-DD` date, or `start` is after `end`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "The record query failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/gcve?start=2024-01-01&end=2024-01-31&limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb gcve --start 2024-01-01 --end 2024-01-31"
          }
        ]
      }
    },
    "/gcve/{year}/{month}": {
      "get": {
        "operationId": "listGcveIssuances",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List GCVE issuances in a month",
        "description": "GCVE ids issued in a calendar month (UTC), in issuance order, each with the advisory id it was issued for. The year runs from 2020 to the current year and a month after the current one is a 400. Answers are cached in the server for an hour (a day for a past month). Open to every plan.",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "required": true,
            "description": "Four-digit year, 2020 to the current year.",
            "schema": {
              "type": "string",
              "minLength": 4,
              "maxLength": 4,
              "pattern": "^20[2-9][0-9]$"
            },
            "example": "2025"
          },
          {
            "name": "month",
            "in": "path",
            "required": true,
            "description": "Month, 1 to 12 (a leading zero is accepted); not after the current month.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2,
              "pattern": "^(?:0?[1-9]|1[0-2])$"
            },
            "example": "3"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Default 100; a value above 500 is lowered to 500, and a value that is not a positive integer is replaced by the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; this document bounds it at 100000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "A page of issuances.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GcveIssuancesResponse"
                },
                "example": {
                  "timestamp": 1793836800000,
                  "year": 2025,
                  "month": 3,
                  "total": 57,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "identifiers": [
                    {
                      "gcveId": "GCVE-VVD-2025-0001",
                      "cveId": "VVD-2025-0001",
                      "datePublished": 1740787200000
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The year or month is not a number or is out of range, or the month is in the future.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "The issuance query failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/gcve/2025/3?limit=100'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb gcve issuances --year 2025 --month 3"
          }
        ]
      }
    },
    "/google/archive/{month}": {
      "get": {
        "operationId": "getGoogleArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Google advisories",
        "description": "Returns every Google advisory published in one calendar month (UTC): GCVE records, Google Cloud security bulletins (split into Chrome and Android where the bulletin is one), Project Zero in-the-wild entries, and CVEs from NVD, GitHub and OSV for Google open-source projects or naming Google as vendor. The month's advisories come from the precomputed archive snapshot, so a month the snapshot has not reached answers 503. Each entry is one CVE from one source (`source`), so a CVE recorded by several sources appears once per source with the same `advisoryId`. Records are fetched by matching the snapshot's ids and sources separately, so a CVE in the month can also bring in its record from another of the month's sources, even one published in a different month. The query keeps running if the client disconnects. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `gpz` and `google`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/google/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Google advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetGoogleArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Google Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 1,
                  "severityCounts": {
                    "High": 1
                  },
                  "sourceBreakdown": {
                    "gcve": 0,
                    "google-cloud": 0,
                    "chrome": 1,
                    "android": 0,
                    "project-zero": 0,
                    "google-oss": 0,
                    "google-vendor": 0
                  },
                  "advisories": [
                    {
                      "advisoryId": "CVE-2024-4671",
                      "source": "google-cloud",
                      "kind": "chrome",
                      "title": "Stable Channel Update for Desktop",
                      "severity": "HIGH",
                      "datePublished": 1715385600000,
                      "cveAliases": [
                        "CVE-2024-4671"
                      ],
                      "isExploited": true,
                      "advisoryUrl": "https://chromereleases.googleblog.com/2024/05/stable-channel-update-for-desktop_9.html",
                      "products": [
                        {
                          "productName": "Chrome",
                          "status": "affected",
                          "vendor": "Google"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-4671"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "kevCisa": true,
                        "kevVulncheck": true,
                        "exploitMaturity": "active",
                        "exploitCount": 4
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/google/archives": {
      "get": {
        "operationId": "listGoogleArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Google advisory archive",
        "description": "Lists every month that has Google advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 30 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `gcve`, `google-cloud`, `project-zero`, `google-oss`, `google-vendor` (the list does not split out `chrome` or `android`), and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/google/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Google advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "gcve": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "gcve": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/google/project-zero/recent": {
      "get": {
        "operationId": "listGoogleProjectZeroRecent",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List recent Project Zero in-the-wild entries",
        "description": "Returns the 12 most recent Google Project Zero in-the-wild exploitation entries, newest first. Entries carry no `severity`, `dateUpdated` or `risk`, `isExploited` is always false here, and `products` is always empty. Takes no parameters. The API caches the answer in process for 30 minutes, even when empty; the query keeps running if the client disconnects.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/google/project-zero/recent'"
          }
        ],
        "responses": {
          "200": {
            "description": "Up to 12 Project Zero entries.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListGoogleProjectZeroRecentResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "total": 1,
                  "advisories": [
                    {
                      "advisoryId": "CVE-2024-4671",
                      "source": "gpz",
                      "kind": "project-zero",
                      "title": "Chrome: use-after-free in Visuals",
                      "datePublished": 1715385600000,
                      "cveAliases": [
                        "CVE-2024-4671"
                      ],
                      "isExploited": false,
                      "advisoryUrl": "https://googleprojectzero.github.io/0days-in-the-wild/0day-RCAs/2024/CVE-2024-4671.html",
                      "products": []
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/google/projects": {
      "get": {
        "operationId": "listGoogleProjects",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List Google open-source projects with CVE counts",
        "description": "Lists 22 Google and Google-incubated open-source projects (Chromium, Android, Go, Kubernetes, TensorFlow and others), always in the same order, each with the number of distinct CVEs published against it in total and in the last 30, 90 and 365 days. CVEs are matched from NVD, GitHub and OSV records by vendor, package and product name. A project whose counts could not be computed is returned with all four counts 0 (and the answer is then not cached). Takes no parameters. The API caches the answer in process for 30 minutes; the query keeps running if the client disconnects.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/google/projects'"
          }
        ],
        "responses": {
          "200": {
            "description": "The 22 projects with CVE counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListGoogleProjectsResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "projects": [
                    {
                      "slug": "chromium",
                      "displayName": "Chromium / Chrome",
                      "homepageURL": "https://www.chromium.org/",
                      "isHardForked": false,
                      "advisoryCount": 3412,
                      "last30Days": 18,
                      "last90Days": 61,
                      "last365Days": 284
                    },
                    {
                      "slug": "kubernetes",
                      "displayName": "Kubernetes",
                      "homepageURL": "https://kubernetes.io/",
                      "isHardForked": true,
                      "advisoryCount": 152,
                      "last30Days": 1,
                      "last90Days": 3,
                      "last365Days": 11
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/identifiers": {
      "get": {
        "operationId": "searchIdentifiers",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search vulnerability ids by prefix",
        "description": "Distinct vulnerability ids (any family) that start with a prefix, case-insensitive, ascending. The prefix is matched literally (`%` and `_` are not wildcards). Answers are cached in the server for 60 seconds. Open to every plan.",
        "parameters": [
          {
            "name": "prefix",
            "in": "query",
            "required": true,
            "description": "The id prefix, 3 to 50 bytes.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 50,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{2,49}$"
            },
            "example": "CVE-2024-38"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Default 100; a value above 500 is lowered to 500, and a value that is not a positive integer is replaced by the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; this document bounds it at 100000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "A page of ids.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentifiersSearchResponse"
                },
                "example": {
                  "timestamp": 1793836800000,
                  "prefix": "CVE-2024-38",
                  "total": 2213,
                  "limit": 2,
                  "offset": 0,
                  "hasMore": true,
                  "identifiers": [
                    "CVE-2024-38000",
                    "CVE-2024-38001"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`prefix` is missing, shorter than 3 or longer than 50 bytes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "The id query failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/identifiers?prefix=CVE-2024-38&limit=100'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb search CVE-2024-38"
          }
        ]
      }
    },
    "/identifiers/{year}/{month}": {
      "get": {
        "operationId": "listIdentifiersByMonth",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List vulnerability ids published in a month",
        "description": "Distinct vulnerability ids with a source record published in a calendar month (UTC), ascending. The year runs from 1999 to the current year and a month after the current one is a 400. Answers are cached in the server for an hour (a day for a past month). Open to every plan.",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "required": true,
            "description": "Four-digit year, 1999 to the current year.",
            "schema": {
              "type": "string",
              "minLength": 4,
              "maxLength": 4,
              "pattern": "^(?:199[9]|20[0-9]{2})$"
            },
            "example": "2024"
          },
          {
            "name": "month",
            "in": "path",
            "required": true,
            "description": "Month, 1 to 12 (a leading zero is accepted); not after the current month.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2,
              "pattern": "^(?:0?[1-9]|1[0-2])$"
            },
            "example": "3"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Default 100; a value above 500 is lowered to 500, and a value that is not a positive integer is replaced by the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; this document bounds it at 100000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "A page of ids.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentifiersMonthResponse"
                },
                "example": {
                  "timestamp": 1793836800000,
                  "year": 2024,
                  "month": 3,
                  "total": 3412,
                  "limit": 2,
                  "offset": 0,
                  "hasMore": true,
                  "identifiers": [
                    "CVE-2024-0001",
                    "CVE-2024-0002"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The year or month is not a number or is out of range, or the month is in the future.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "The id query failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/identifiers/2024/3?limit=100'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ids 2024 3"
          }
        ]
      }
    },
    "/info/{identifier}": {
      "get": {
        "operationId": "getVulnInfo",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get source coverage for a vulnerability",
        "description": "Which sources hold a vulnerability, how many references, problem types, metrics, affected products, impacts, descriptions and scorecards they hold between them, and links to the vulnerability's web page and the stored source files.\n\nThe identifier is any advisory id; its family prefix is upper-cased and an alias is resolved to its primary id. Unlike the `/vuln/{identifier}` family this route does not take a purl, CPE, TEI or SWID tag. An id no source holds answers 200 with `matched: false`, zero counts and null `sources`, `aliases` and `links`; there is no 404. Open to every plan.",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "An advisory id of any family, case-insensitive; an alias resolves to its primary id.",
            "schema": {
              "$ref": "#/components/schemas/VulnId"
            },
            "example": "CVE-2021-44228"
          }
        ],
        "responses": {
          "200": {
            "description": "Coverage of the vulnerability across sources.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetVulnInfoResponse"
                },
                "example": {
                  "_identifier": "CVE-2021-44228",
                  "_timestamp": 1793836800,
                  "cache_hit": false,
                  "matched": true,
                  "gcve": false,
                  "lastFetchedAt": 1793750400000,
                  "lastEnrichedAt": 1793754000000,
                  "sources": [
                    {
                      "name": "nist-nvd",
                      "processing": false
                    },
                    {
                      "name": "github",
                      "processing": false
                    }
                  ],
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "references": 412,
                  "problemTypes": 6,
                  "metrics": 9,
                  "affected": 38,
                  "impacts": 2,
                  "descriptions": 5,
                  "scorecards": 1,
                  "links": [
                    {
                      "type": "page",
                      "format": "http",
                      "url": "https://vdb.vulnes.is/CVE-2021-44228"
                    },
                    {
                      "type": "mitre",
                      "format": "cvelistV5",
                      "url": "https://vulnes.is/mitre-cve/files/2024/CVE-2021-44228.json"
                    }
                  ],
                  "_links": [
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    },
                    {
                      "rel": "timeline",
                      "href": "/v2/vuln/CVE-2021-44228/timeline"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "The source lookup failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/info/CVE-2021-44228'"
          }
        ]
      }
    },
    "/inputs/resolve": {
      "get": {
        "operationId": "resolveInputs",
        "tags": [
          "Inputs"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Resolve inputs to vulnerability ids",
        "description": "What the inputs resolve to, and nothing else: the `resolved` block every input-taking route returns. For a client that holds a purl, CPE, TEI, SWID tag or CEL expression and wants to call a vulnerability-keyed route. Kinds given together narrow the answer. `vulnIds` are ranked as a fan-out runs them: known exploited first, then CVE, GHSA and CNVD ids, then the rest, newest first within each group.\n\nThe legacy names `vulnIds`, `cveId` and `identifier` (for `vulnId`), `packageName` (for `package`) and `packageVersion` and `currentVersion` (for `version`) are read too. For a CEL expression or SWID tag too long for a query string, use the POST. Open to every plan.",
        "parameters": [
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "name": "vulnIds",
            "in": "query",
            "required": false,
            "deprecated": true,
            "description": "Alias of `vulnId`; the values of every spelling are combined, at most 100 in all.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 100,
              "items": {
                "$ref": "#/components/schemas/VulnId"
              }
            },
            "example": [
              "CVE-2021-44228"
            ]
          },
          {
            "name": "cveId",
            "in": "query",
            "required": false,
            "deprecated": true,
            "description": "Alias of `vulnId`.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 100,
              "items": {
                "$ref": "#/components/schemas/VulnId"
              }
            },
            "example": [
              "CVE-2021-44228"
            ]
          },
          {
            "name": "identifier",
            "in": "query",
            "required": false,
            "deprecated": true,
            "description": "Alias of `vulnId`.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 100,
              "items": {
                "$ref": "#/components/schemas/VulnId"
              }
            },
            "example": [
              "CVE-2021-44228"
            ]
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "name": "packageName",
            "in": "query",
            "required": false,
            "deprecated": true,
            "description": "Alias of `package`, read when `package` is absent.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "lodash"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "name": "packageVersion",
            "in": "query",
            "required": false,
            "deprecated": true,
            "description": "Alias of `version`, read when `version` is absent.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "4.17.20"
          },
          {
            "name": "currentVersion",
            "in": "query",
            "required": false,
            "deprecated": true,
            "description": "Alias of `version`, read when `version` and `packageVersion` are absent.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "4.17.20"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "What the inputs became.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResolveInputsResponse"
                },
                "example": {
                  "resolved": {
                    "kinds": [
                      "purl"
                    ],
                    "vulnIds": [
                      "CVE-2021-44228",
                      "CVE-2021-45046"
                    ],
                    "packages": [
                      {
                        "ecosystem": "maven",
                        "name": "org.apache.logging.log4j:log4j-core",
                        "version": "2.14.1"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "No input was given (`field` is `inputs`), or an input is malformed (`field` names it).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                },
                "example": {
                  "error": "name something to resolve: vulnId, package, purl, cpe, vendor/product, swid, tei or cel",
                  "field": "inputs"
                }
              }
            }
          },
          "401": {
            "description": "No valid credential (middleware), or a TEI or CEL input that needs the caller's tenant (`InputError`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "413": {
            "description": "An input is over its limit: more than 100 vulnerability ids, a field over 512 characters, a SWID tag over 64 KiB or a CEL expression over 4 KiB.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "422": {
            "description": "A well-formed input this API cannot resolve.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "503": {
            "description": "The transparency log behind a TEI or CEL input could not be read (`InputError`), or the service is in maintenance or a dependency did not answer.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/inputs/resolve?purl=pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1'"
          }
        ]
      },
      "post": {
        "operationId": "resolveInputsByBody",
        "tags": [
          "Inputs"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Resolve inputs to vulnerability ids from a JSON body",
        "description": "The same as the GET, with the inputs in a JSON body, for a CEL expression or SWID tag too long for a query string. The body is read up to 256 KiB; a longer body is 413 (`Invalid JSON body: http: request body too large`). The legacy key names are accepted as in the query; keys that are not input names are ignored. Open to every plan.",
        "requestBody": {
          "required": true,
          "description": "The inputs, at most 256 KiB.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Inputs"
              },
              "example": {
                "purl": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What the inputs became.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResolveInputsResponse"
                },
                "example": {
                  "resolved": {
                    "kinds": [
                      "purl"
                    ],
                    "vulnIds": [
                      "CVE-2021-44228",
                      "CVE-2021-45046"
                    ],
                    "packages": [
                      {
                        "ecosystem": "maven",
                        "name": "org.apache.logging.log4j:log4j-core",
                        "version": "2.14.1"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "The body is not JSON, or holds a value of the wrong type (`ErrorBody`); no input was given (`field` is `inputs`); or an input is malformed (`field` names it).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "No valid credential (middleware), or a TEI or CEL input that needs the caller's tenant (`InputError`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "413": {
            "description": "The body is over 256 KiB (`{error: \"Invalid JSON body: http: request body too large\"}`), or an input is over its limit: more than 100 vulnerability ids, a field over 512 characters, a SWID tag over 64 KiB or a CEL expression over 4 KiB (`field` names the input).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "error": "Invalid JSON body: http: request body too large"
                }
              }
            }
          },
          "422": {
            "description": "A well-formed input this API cannot resolve.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "503": {
            "description": "The transparency log behind a TEI or CEL input could not be read (`InputError`), or the service is in maintenance or a dependency did not answer.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -X POST -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -H 'Content-Type: application/json' -d '{\"purl\":\"pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1\"}' 'https://api.vdb.vulnes.is/v2/inputs/resolve'"
          }
        ]
      }
    },
    "/iocs": {
      "get": {
        "operationId": "searchIocs",
        "tags": [
          "Threat Activity"
        ],
        "summary": "Search IOC sightings",
        "description": "CrowdSec sightings across every vulnerability, newest `lastSeen` first.\n\nFilters: `cveId` (repeat it; any of them), `asn` (any of them), `country` (any of them), `behavior` (substring of a behaviour), `reputation` (exact), `since` (only sightings last seen at or after it). Different filters combine with AND. `cveId` values are upper-cased; an `asn` that is not a number is ignored; an unparseable `since` is ignored.\n\n`country` and `since` are applied to the page after `limit` and `offset`, so a page can hold fewer than `limit` rows while more match. There is no `total`.\n\n`format=stix` answers a STIX 2.1 bundle (`application/vnd.oasis.stix+json; version=2.1`, `Cache-Control: no-store`): an identity, one vulnerability per CVE, and per sighting an indicator and a sighting object.\n\nTakes every input kind: they resolve to vulnerability ids (aliases included) and filter as `cveId` does, and the JSON answer gains `resolved` (a `format=stix` bundle is returned as is, with no `resolved` key, so it stays valid STIX). `cveId` alone keeps its own meaning.\n\n**Plans.** Below Pro, `sightings` is null and listed in `_pro_data` and `_entitlements`. Below Pro, `format=stix` answers the 200 `planLocked` body instead of the bundle.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.sightings"
          ],
          "exception": "format=stix is a whole-answer gate: below Pro it answers the 200 planLocked body (feature full-enrichment)."
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/iocs?cveId=CVE-2021-44228&country=US&limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb iocs list --cve-id CVE-2021-44228 --country US"
          }
        ],
        "parameters": [
          {
            "name": "cveId",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Advisory id; repeat for any of several. Upper-cased. With another input kind it is read as `vulnId`.",
            "schema": {
              "type": "array",
              "maxItems": 100,
              "items": {
                "$ref": "#/components/schemas/VulnId"
              }
            },
            "example": [
              "CVE-2021-44228"
            ]
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "ISO 3166-1 alpha-2 source country, any case; repeat for any of several. Applied to the page after paging.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 2,
                "maxLength": 2,
                "pattern": "^[A-Za-z]{2}$"
              }
            },
            "example": [
              "US"
            ]
          },
          {
            "name": "asn",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Autonomous system number; repeat for any of several.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 4294967295
              }
            },
            "example": [
              14061
            ]
          },
          {
            "name": "behavior",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of a CrowdSec behaviour, such as `http:exploit`.",
            "schema": {
              "$ref": "#/components/schemas/SafeText"
            },
            "example": "http:exploit"
          },
          {
            "name": "reputation",
            "in": "query",
            "required": false,
            "description": "Exact CrowdSec reputation, such as `malicious` or `suspicious`.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 32,
              "pattern": "^[A-Za-z_-]{1,32}$"
            },
            "example": "malicious"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only sightings last seen at or after this time: RFC 3339, `YYYY-MM-DDTHH:MM:SS`, `YYYY-MM-DD HH:MM:SS` or `YYYY-MM-DD` (UTC). Applied to the page after paging; an unparseable value is ignored.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 35,
              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?(Z|[+-][0-9]{2}:[0-9]{2})?| [0-9]{2}:[0-9]{2}:[0-9]{2})?$"
            },
            "example": "2025-11-01T00:00:00Z"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Default 100, capped at 500.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 50
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; 100000 is the documented one.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "`stix` answers the STIX 2.1 bundle. Any other value answers the JSON page: `json` is the default, and `csv` (which `vulnetix vdb iocs list --format csv` sends before converting locally) also answers JSON.",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "stix",
                "csv"
              ],
              "default": "json"
            },
            "example": "json"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/ThreatActivityInputUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ThreatActivityInputUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/ThreatActivityInputBadRequest"
          },
          "413": {
            "$ref": "#/components/responses/ThreatActivityInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/ThreatActivityInputUnresolvable"
          },
          "200": {
            "description": "A page of sightings; the STIX bundle for `format=stix`; or, below Pro with `format=stix`, the `planLocked` body. With an input kind the answer gains `resolved`, and a STIX bundle then comes back as `application/json`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Cache policy. Every authenticated answer is `private, no-store`: the same URL answers each plan differently, so no shared cache may keep it.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store",
                    "no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/SearchIocsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/SearchIocsStixBundle"
                    },
                    {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/PlanLocked"
                        },
                        {
                          "type": "object",
                          "properties": {
                            "error": {
                              "type": "string",
                              "enum": [
                                "The STIX bundle of IOC sightings requires a Pro plan"
                              ]
                            },
                            "resolved": {
                              "$ref": "#/components/schemas/ResolvedInputs"
                            }
                          }
                        }
                      ]
                    }
                  ]
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "limit": 50,
                  "offset": 0,
                  "sightings": [
                    {
                      "uuid": "0b6f7d1e-6a43-4c55-9d0e-2f1a7c3e9b10",
                      "cveId": "CVE-2021-44228",
                      "source": "crowdsec",
                      "ip": "203.0.113.24",
                      "reputation": "malicious",
                      "asNum": 14061,
                      "country": "US",
                      "behaviors": [
                        "http:exploit"
                      ],
                      "firstSeen": "2025-10-02T08:14:00Z",
                      "lastSeen": "2025-11-04T22:51:00Z",
                      "falsePositivesCount": 0
                    }
                  ]
                }
              },
              "application/vnd.oasis.stix+json; version=2.1": {
                "schema": {
                  "$ref": "#/components/schemas/SearchIocsStixBundle"
                },
                "example": {
                  "type": "bundle",
                  "id": "bundle--5d2b6c1e-0f3a-5b7c-8d9e-1a2b3c4d5e6f",
                  "objects": [
                    {
                      "type": "identity",
                      "spec_version": "2.1",
                      "id": "identity--9a8b7c6d-5e4f-5a3b-8c2d-1e0f9a8b7c6d",
                      "created": "2025-11-05T00:00:00Z",
                      "modified": "2025-11-05T00:00:00Z",
                      "name": "Vulnesis",
                      "identity_class": "organization",
                      "sectors": [
                        "technology"
                      ],
                      "contact_information": "https://vulnes.is"
                    },
                    {
                      "type": "indicator",
                      "spec_version": "2.1",
                      "id": "indicator--1f2e3d4c-5b6a-5978-8877-665544332211",
                      "created_by_ref": "identity--9a8b7c6d-5e4f-5a3b-8c2d-1e0f9a8b7c6d",
                      "created": "2025-11-05T00:00:00Z",
                      "modified": "2025-11-05T00:00:00Z",
                      "name": "203.0.113.24 observed exploiting CVE-2021-44228",
                      "indicator_types": [
                        "malicious-activity"
                      ],
                      "pattern": "[ipv4-addr:value = '203.0.113.24']",
                      "pattern_type": "stix",
                      "valid_from": "2025-10-02T08:14:00Z",
                      "valid_until": "2025-11-04T22:51:00Z",
                      "labels": [
                        "malicious-activity",
                        "reputation:malicious"
                      ]
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/kev": {
      "get": {
        "operationId": "searchKev",
        "tags": [
          "KEV"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search the merged KEV catalogues",
        "description": "Searches the CISA, Vulnesis, ENISA and VulnCheck known-exploited catalogues as one list of rows; a CVE appears once per catalogue that lists it, and a Vulnesis row is left out once CISA or ENISA lists the same CVE. Rows from CISA, Vulnesis and ENISA come first, sorted by `sort`, then VulnCheck rows (newest first) fill any space left in the page.\n\n`limit` defaults to 100 and is capped at 200. `vendor` and `product` are substring matches on the catalogue's own vendor and product fields. The date filters accept RFC 3339, `YYYY-MM-DDTHH:MM:SS`, `YYYY-MM-DD HH:MM:SS` or `YYYY-MM-DD`; an unparseable value is ignored, as is an unknown `source` (none left means all four). `dueBefore`, `dueAfter`, `sort` and `offset` apply to the CISA, Vulnesis and ENISA rows only; VulnCheck rows are not offset, so they repeat on every page that has room for them. There is no total. A CISA, Vulnesis or ENISA row whose `knownRansomwareCampaignUse` is unset is currently left out of the answer (a known defect).\n\nA purl, package, CPE, TEI, SWID tag, CEL expression or `vulnId` narrows the search to the vulnerabilities they resolve to, and the answer then carries `resolved`. `cveId` on its own is a plain id filter.\n\nNot plan-gated.",
        "parameters": [
          {
            "name": "cveId",
            "in": "query",
            "required": false,
            "description": "Keep rows for these ids (upper-cased, exact). Repeatable. With another input kind it is read as `vulnId` and intersected.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 100,
              "items": {
                "$ref": "#/components/schemas/VulnId"
              }
            },
            "example": [
              "CVE-2021-44228"
            ]
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "Catalogues to search, case-insensitive. Repeatable. Default all four.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 4,
              "items": {
                "type": "string",
                "minLength": 4,
                "maxLength": 9,
                "pattern": "^(?:[Cc][Ii][Ss][Aa]|[Vv][Uu][Ll][Nn][Ee][Tt][Ii][Xx]|[Ee][Nn][Ii][Ss][Aa]|[Vv][Uu][Ll][Nn][Cc][Hh][Ee][Cc][Kk])$"
              }
            },
            "example": [
              "CISA",
              "vulncheck"
            ]
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Date added on or after.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 35,
              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}(?:[T ][0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{1,9})?(?:Z|[+-][0-9]{2}:[0-9]{2})?)?$"
            },
            "example": "2024-01-01"
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Date added on or before.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 35,
              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}(?:[T ][0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{1,9})?(?:Z|[+-][0-9]{2}:[0-9]{2})?)?$"
            },
            "example": "2024-01-01"
          },
          {
            "name": "dueBefore",
            "in": "query",
            "required": false,
            "description": "Due date on or before (CISA, Vulnesis and ENISA rows only).",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 35,
              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}(?:[T ][0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{1,9})?(?:Z|[+-][0-9]{2}:[0-9]{2})?)?$"
            },
            "example": "2024-01-01"
          },
          {
            "name": "dueAfter",
            "in": "query",
            "required": false,
            "description": "Due date on or after (CISA, Vulnesis and ENISA rows only).",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 35,
              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}(?:[T ][0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{1,9})?(?:Z|[+-][0-9]{2}:[0-9]{2})?)?$"
            },
            "example": "2024-01-01"
          },
          {
            "name": "vendor",
            "in": "query",
            "required": false,
            "description": "Keep rows whose vendor contains this text (case-insensitive). A native filter here, not the input-model vendor.",
            "schema": {
              "$ref": "#/components/schemas/VendorName"
            },
            "example": "apache"
          },
          {
            "name": "product",
            "in": "query",
            "required": false,
            "description": "Keep rows whose product contains this text (case-insensitive). A native filter here, not the input-model product.",
            "schema": {
              "$ref": "#/components/schemas/ProductName"
            },
            "example": "log4j"
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "`added` (date added, newest first), `due` (due date, soonest first) or `cve` (id ascending). Case-insensitive; anything else sorts by `added`.",
            "schema": {
              "type": "string",
              "enum": [
                "added",
                "due",
                "cve"
              ],
              "default": "added"
            },
            "example": "due"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Over 200 is capped; non-numeric or non-positive values use 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 200,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "CISA, Vulnesis and ENISA rows to skip. Non-numeric or negative values use 0.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/ExploitKevInputUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The catalogue query failed, or an unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/ExploitKevInputUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/ExploitKevInputBadRequest"
          },
          "413": {
            "$ref": "#/components/responses/ExploitKevInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/ExploitKevInputUnresolvable"
          },
          "200": {
            "description": "One page of catalogue rows.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchKevResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 2,
                  "limit": 2,
                  "offset": 0,
                  "sources": [
                    "CISA",
                    "vulnetix",
                    "enisa",
                    "vulncheck"
                  ],
                  "items": [
                    {
                      "source": "CISA",
                      "cveId": "CVE-2021-44228",
                      "vendorProject": "Apache",
                      "product": "Log4j2",
                      "vulnerabilityName": "Apache Log4j2 Remote Code Execution Vulnerability",
                      "requiredAction": "For all affected software assets for which updates exist, the only acceptable remediation actions are: 1) Apply updates; OR 2) remove affected assets from agency networks.",
                      "knownRansomwareCampaignUse": "Known",
                      "dateAdded": "2021-12-10T00:00:00Z",
                      "dueDate": "2021-12-24T00:00:00Z",
                      "overdue": true,
                      "daysUntilDue": -1777
                    },
                    {
                      "source": "enisa",
                      "cveId": "CVE-2021-44228",
                      "vendorProject": "Apache",
                      "product": "Log4j2",
                      "vulnerabilityName": "Apache Log4j2 Remote Code Execution Vulnerability",
                      "dateAdded": "2025-10-01T00:00:00Z",
                      "dueDate": "1970-01-01T00:00:00Z",
                      "overdue": true,
                      "daysUntilDue": -20397
                    }
                  ]
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/kev?source=CISA&sort=due&limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb kev list --source cisa --limit 50"
          }
        ]
      }
    },
    "/malware-campaigns": {
      "get": {
        "operationId": "listMalwareCampaigns",
        "tags": [
          "Malware Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List reconstructed malware campaigns",
        "description": "Returns the supply-chain malware campaigns Vulnesis has reconstructed: per campaign the threat-actor accounts (at most 200 listed, with recovered emails), IOC samples grouped by type (at most 50 values per type), and counts; plus corpus-wide aggregates, including the top 500 actors by threat count.\n\nThe payload is computed once a day and served from the latest snapshot. `campaigns` defaults to `[]` and `aggregates` to `{}` when the snapshot lacks them. Takes no parameters.\n\nAvailable to every plan with no Pro gating; authentication is still required. Cached in-process for 24 hours and sent with `Cache-Control: public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/malware-campaigns'"
          }
        ],
        "responses": {
          "200": {
            "description": "The latest campaigns snapshot.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/SummaryFeedCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListMalwareCampaignsResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "generatedAt": 1762214400,
                  "campaigns": [
                    {
                      "key": "shai-hulud",
                      "name": "Shai-Hulud",
                      "ecosystem": "npm",
                      "startDate": "2025-09-15",
                      "headline": false,
                      "description": "Self-propagating npm worm that stole maintainer tokens and republished infected packages.",
                      "actorCount": 1,
                      "actorsShown": 1,
                      "iocCount": 2,
                      "cveCount": 1,
                      "packageCount": 1,
                      "actors": [
                        {
                          "platform": "npm",
                          "identifier": "example-maintainer",
                          "actorType": "registry-account",
                          "threatCount": 3,
                          "edgeCount": 3,
                          "firstSeen": 1757894400000,
                          "lastSeen": 1758067200000
                        }
                      ],
                      "iocs": [
                        {
                          "iocType": "domains",
                          "total": 1,
                          "truncated": 0,
                          "values": [
                            "webhook.site"
                          ]
                        },
                        {
                          "iocType": "package-name",
                          "total": 1,
                          "truncated": 0,
                          "values": [
                            "@ctrl/tinycolor"
                          ]
                        }
                      ]
                    }
                  ],
                  "aggregates": {
                    "actorsByEcosystem": {
                      "npm": 1
                    },
                    "iocsByType": {
                      "domains": 1,
                      "package-name": 1
                    },
                    "timeline": [
                      {
                        "date": "2025-09-15",
                        "campaign": "Shai-Hulud",
                        "actors": 1,
                        "iocs": 2
                      }
                    ],
                    "totalActors": 1,
                    "totalIocs": 2,
                    "totalCampaigns": 1,
                    "globalActors": 41250,
                    "globalIocs": 218004,
                    "globalMalwareCves": 9120,
                    "globalMalwareRecords": 212345,
                    "globalEmails": 3012,
                    "actorsByPlatform": {
                      "npm": 30111,
                      "github": 11139
                    },
                    "topActors": [
                      {
                        "platform": "npm",
                        "identifier": "example-maintainer",
                        "actorType": "registry-account",
                        "threatCount": 3,
                        "edgeCount": 3,
                        "firstSeen": 1757894400000,
                        "lastSeen": 1758067200000
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "No snapshot exists yet or it does not parse (`Malware campaigns not yet available, please retry shortly`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "Malware campaigns not yet available, please retry shortly"
                }
              }
            }
          }
        }
      }
    },
    "/malware-trends": {
      "get": {
        "operationId": "getMalwareTrends",
        "tags": [
          "Malware Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get supply-chain malware trends",
        "description": "Returns the trend roll-up of four supply-chain malware feeds (OSSF Malicious Packages via OSV.dev, OpenSourceMalware, Vulnesis CLI Malscan, Vulnesis VDB) over a trailing window of months: advisories, packages, IOC samples, actionable IOCs and actors, per feed, per ecosystem and per month, plus the IOC-type mix per feed and the registry exposure-window study.\n\nThe payload is computed once a day and served from the latest snapshot. `totals`, `iocTypesBySource` and `exposure` default to `{}` and `sources`, `ecosystems` and `monthly` to `[]` when the snapshot lacks them; `generatedAt`, `windowMonths` and `note` are present only when the snapshot carries them. Takes no parameters.\n\nAvailable to every plan with no Pro gating; authentication is still required. Cached in-process for 24 hours and sent with `Cache-Control: public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/malware-trends'"
          }
        ],
        "responses": {
          "200": {
            "description": "The latest trends snapshot.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/SummaryFeedCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetMalwareTrendsResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "generatedAt": 1762214400,
                  "windowMonths": 24,
                  "note": "Advisories and IOC samples are additive; packages and actors are counted distinct within each bucket.",
                  "totals": {
                    "advisories": 1200,
                    "packages": 1150,
                    "iocSamples": 4300,
                    "actionableIocs": 900,
                    "actors": 210
                  },
                  "sources": [
                    {
                      "key": "ossf",
                      "name": "OSSF Malicious Packages",
                      "advisories": 1000,
                      "packages": 990,
                      "iocSamples": 3000,
                      "actionableIocs": 10,
                      "actors": 0
                    }
                  ],
                  "ecosystems": [
                    {
                      "ecosystem": "npm",
                      "advisories": 800,
                      "packages": 790,
                      "iocSamples": 2500,
                      "actionableIocs": 400,
                      "actors": 150
                    }
                  ],
                  "monthly": [
                    {
                      "month": "2025-10",
                      "source": "ossf",
                      "ecosystem": "npm",
                      "advisories": 60,
                      "packages": 59,
                      "iocSamples": 120,
                      "actionableIocs": 2,
                      "actors": 0
                    }
                  ],
                  "iocTypesBySource": {
                    "ossf": {
                      "package-name": 2990,
                      "file-hash": 10
                    }
                  },
                  "exposure": {
                    "ossf": {
                      "_all": {
                        "checked": 500,
                        "removed": 420,
                        "erased": 30,
                        "measurable": 50,
                        "medianDays": 3.5,
                        "sameDay": 12,
                        "days1to7": 20,
                        "weeks1to4": 10,
                        "months1to3": 5,
                        "months3to12": 2,
                        "overYear": 1
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "No snapshot exists yet or it does not parse (`Malware trends not yet available, please retry shortly`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "Malware trends not yet available, please retry shortly"
                }
              }
            }
          }
        }
      }
    },
    "/malware/{ecosystem}/{package}": {
      "get": {
        "operationId": "checkPackageMalware",
        "tags": [
          "Malware Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Check a package for known malware",
        "description": "Says whether a package name has been flagged as malicious by any malware source (OpenSourceMalware, OpenSSF malicious-packages, GHSA and others) and lists the malware advisories with counts.\n\nThe package name is matched case-insensitively against the affected package (or product) name; the ecosystem selects the registry, so a name that exists in several ecosystems is told apart. Percent-encode a scoped name (`%40scope%2Fname`).\n\nWhen the package is malicious the answer also carries `threatActors` (the attributed authors, with SSH and GPG key fingerprints), `iocs` (indicators of compromise parsed from OpenSourceMalware payloads) and `impersonationTrap` (the legitimate repository the package falsely claims). Those three are Pro and above: below Pro they are null and listed in `_pro_data` and `_entitlements`; `counts` stays visible to every plan. Even for Pro they are null when nothing is attributed.\n\nA database error degrades to a clean answer rather than an error. The answer is sent with `Cache-Control: private, no-store`.",
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.threatActors",
            "$.iocs",
            "$.impersonationTrap"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/malware/npm/event-stream'"
          }
        ],
        "parameters": [
          {
            "name": "ecosystem",
            "in": "path",
            "required": true,
            "description": "Package ecosystem, case-insensitive. npm, pypi, go/golang, maven, cargo/crates, rubygems, nuget, packagist/composer, pub, hex, vscode and openvsx are matched to their registry; any other ecosystem is looked up by package name alone.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "npm"
          },
          {
            "name": "package",
            "in": "path",
            "required": true,
            "description": "Package name, matched case-insensitively. Percent-encode a scoped npm name as `%40scope%2Fname`.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "event-stream"
          }
        ],
        "responses": {
          "200": {
            "description": "The package's malware status. `isMalicious` tells the two shapes apart.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/MalwareCheckCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/MalwareCheckMalicious"
                    },
                    {
                      "$ref": "#/components/schemas/MalwareCheckClean"
                    }
                  ]
                },
                "example": {
                  "success": true,
                  "ecosystem": "npm",
                  "package": "event-stream",
                  "isMalicious": true,
                  "advisories": [
                    {
                      "cveId": "MAL-2018-1",
                      "source": "osv",
                      "title": "Malicious code in event-stream (npm)",
                      "aliases": [
                        "GHSA-mh6f-8j2x-4483"
                      ]
                    }
                  ],
                  "threatActors": null,
                  "iocs": null,
                  "impersonationTrap": null,
                  "counts": {
                    "advisories": 1,
                    "threatActors": 1,
                    "iocs": 0,
                    "keys": 0
                  },
                  "_pro_data": [
                    "$.threatActors",
                    "$.iocs",
                    "$.impersonationTrap"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "full-enrichment",
                        "requiredPlan": "pro",
                        "paths": [
                          "$.threatActors",
                          "$.iocs",
                          "$.impersonationTrap"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/metric-types": {
      "get": {
        "operationId": "listMetricTypes",
        "tags": [
          "Enumerations"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List scoring metric types with record counts",
        "description": "Lists the distinct metric types of the scoring records (CVSS versions, SSVC and others), each with its record count, most records first. The values are whatever the stored records hold (for example `cvssV3_1`, `cvssV4_0`, `ssvc`); this is not a fixed enumeration. Computed at most once an hour.",
        "responses": {
          "200": {
            "description": "Metric types with record counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`, set by the authentication layer: the answer must not be stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListMetricTypesResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "metricTypes": [
                    {
                      "name": "cvssV3_1",
                      "count": 412300
                    },
                    {
                      "name": "cvssV2_0",
                      "count": 180412
                    },
                    {
                      "name": "cvssV4_0",
                      "count": 40211
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/metric-types'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb metrics types"
          }
        ]
      }
    },
    "/msrc/patch-tuesday-preparation": {
      "get": {
        "operationId": "getMsrcPatchTuesdayPreparation",
        "tags": [
          "MSRC Patch Tuesday"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get advisories pending the next Patch Tuesday",
        "description": "Returns the MSRC advisories published since the most recent Patch Tuesday that are not yet attributed to one, presented as a single upcoming release keyed to the next second Tuesday of the month (18:00 UTC). Advisories are ordered newest first, then by CVE id, and have the same shape as in `GET /msrc/patch-tuesday/{date}` except that they carry no `csafUrl` or `vexUrl`, because the archive files do not exist yet.\n\n`preparation` is null when nothing is pending. Takes no parameters.\n\nAvailable to every plan; authentication is required. Held in an in-process cache for 300 seconds (`X-Cache: HIT` or `MISS`); the response itself is sent with `Cache-Control: private, no-store`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/msrc/patch-tuesday-preparation'"
          }
        ],
        "responses": {
          "200": {
            "description": "The pending release, or null when nothing is pending.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/MsrcXCache"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetMsrcPatchTuesdayPreparationResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "preparation": {
                    "id": "preparation",
                    "releaseDate": 1762884000000,
                    "dateSlug": "2025-11-11",
                    "title": "November 2025 (Preparation)",
                    "cveCount": 1,
                    "exploitedCount": 0,
                    "kbCount": 0,
                    "patchedCount": 0,
                    "noPatchCount": 1,
                    "manifestUrl": null,
                    "status": "Upcoming",
                    "isPreparation": true,
                    "advisories": [
                      {
                        "cveId": "CVE-2025-62210",
                        "trackingId": "CVE-2025-62210",
                        "advisoryUrl": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2025-62210",
                        "severity": "Important",
                        "isExploited": false,
                        "currentReleaseDate": 1762300000000,
                        "initialReleaseDate": 1762300000000,
                        "revisionVersion": "1.0",
                        "risk": {
                          "cves": [
                            "CVE-2025-62210"
                          ]
                        },
                        "productFamilies": []
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/msrc/patch-tuesday/{date}": {
      "get": {
        "operationId": "getMsrcPatchTuesday",
        "tags": [
          "MSRC Patch Tuesday"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a Microsoft Patch Tuesday release",
        "description": "Returns one Patch Tuesday release, found by its UTC release date, with every advisory ordered by CVE id. Each advisory carries its CSAF (and, when MSRC published one, VEX) download URL in the public MSRC archive, its affected products grouped by product family, product and version, and a `risk` block of ranking signals (CVSS, EPSS, CESS, KEV listings, exploit maturity). The counts are computed from the advisories returned.\n\nAvailable to every plan; authentication is required. Held in an in-process cache for 1800 seconds per date (`X-Cache: HIT` or `MISS`; a cached answer repeats the `timestamp` it was built with); the response itself is sent with `Cache-Control: private, no-store`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/msrc/patch-tuesday/2024-06-11'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb msrc patch-tuesday 2024-06-11"
          }
        ],
        "parameters": [
          {
            "name": "date",
            "in": "path",
            "required": true,
            "description": "Release date in UTC, `YYYY-MM-DD`. A value that is not in that form, or is not a real date, is a 400; a date with no release is a 404.",
            "schema": {
              "$ref": "#/components/schemas/Date"
            },
            "example": "2024-06-11"
          }
        ],
        "responses": {
          "200": {
            "description": "The release with its advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/MsrcXCache"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetMsrcPatchTuesdayResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "id": "4c1f7d2e-3b8a-4f61-9c2d-0a5e6b7c8d9e",
                  "releaseDate": 1718128800000,
                  "dateSlug": "2024-06-11",
                  "title": "June 2024 Security Updates",
                  "cveCount": 1,
                  "exploitedCount": 0,
                  "kbCount": 1,
                  "patchedCount": 1,
                  "noPatchCount": 0,
                  "manifestUrl": "https://vulnes.is/msrc-archive/2024-06-11/manifest.json",
                  "status": "Published",
                  "isPreparation": false,
                  "advisories": [
                    {
                      "cveId": "CVE-2024-30080",
                      "trackingId": "CVE-2024-30080",
                      "advisoryUrl": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2024-30080",
                      "severity": "Critical",
                      "exploitabilityIndex": "Exploitation More Likely",
                      "isExploited": false,
                      "currentReleaseDate": 1718128800000,
                      "initialReleaseDate": 1718128800000,
                      "revisionVersion": "1.0",
                      "csafSha256": "9f2b5c0d6e1a4b7c8d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c",
                      "csafUrl": "https://vulnes.is/msrc-archive/2024-06-11/CVE-2024-30080.csaf.json",
                      "risk": {
                        "cves": [
                          "CVE-2024-30080"
                        ],
                        "vendorCvss": 9.8,
                        "cvss": 9.8,
                        "cvssSource": "msrc",
                        "epss": 0.0412,
                        "epssPercentile": 0.92,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      },
                      "productFamilies": [
                        {
                          "familyName": "Windows",
                          "products": [
                            {
                              "productName": "Windows Server 2022",
                              "status": "known_affected",
                              "csafProductId": "12345",
                              "versions": [
                                {
                                  "fixedBuild": "10.0.20348.2527",
                                  "kbArticleId": "5039227",
                                  "kbArticleUrl": "https://support.microsoft.com/help/5039227",
                                  "remediationCategory": "vendor_fix"
                                }
                              ]
                            }
                          ]
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`date` is not `YYYY-MM-DD` (`Invalid date. Use YYYY-MM-DD`) or is not a real date (`Invalid date`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Invalid date. Use YYYY-MM-DD"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "No Patch Tuesday was released on that date (the lookup also answers 404 when it fails for another reason), or the caller's organisation was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/MsrcPatchTuesdayNotFound"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "error": "Patch Tuesday not found",
                  "date": "2024-06-12"
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/msrc/patch-tuesdays": {
      "get": {
        "operationId": "listMsrcPatchTuesdays",
        "tags": [
          "MSRC Patch Tuesday"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List Microsoft Patch Tuesday releases",
        "description": "Lists every Microsoft Patch Tuesday release on file, most recent first, with its CVE, exploited, KB, patched and unpatched counts and the link to its manifest in the public MSRC archive. Use `dateSlug` with `GET /msrc/patch-tuesday/{date}` for the advisories.\n\nServed from a snapshot computed once a day; `timestamp` and `generatedAt` are the snapshot's generation time, not the response time. Takes no parameters.\n\nAvailable to every plan; authentication is required. Held in an in-process cache for 600 seconds (`X-Cache: HIT` or `MISS`); the response itself is sent with `Cache-Control: private, no-store`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/msrc/patch-tuesdays'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb msrc patch-tuesdays"
          }
        ],
        "responses": {
          "200": {
            "description": "Every Patch Tuesday release, most recent first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/MsrcXCache"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListMsrcPatchTuesdaysResponse"
                },
                "example": {
                  "timestamp": 1762214400,
                  "generatedAt": 1762214400,
                  "total": 1,
                  "patchTuesdays": [
                    {
                      "id": "4c1f7d2e-3b8a-4f61-9c2d-0a5e6b7c8d9e",
                      "releaseDate": 1718128800000,
                      "dateSlug": "2024-06-11",
                      "title": "June 2024 Security Updates",
                      "cveCount": 51,
                      "exploitedCount": 1,
                      "kbCount": 14,
                      "patchedCount": 50,
                      "noPatchCount": 1,
                      "manifestUrl": "https://vulnes.is/msrc-archive/2024-06-11/manifest.json",
                      "status": "Published",
                      "isPreparation": false
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "The MSRC archive snapshot has not been produced yet (`msrc archive snapshot is not yet available, please retry shortly`, with `vendor: msrc`), or a dependency did not answer in time, or the service is in maintenance (then `Retry-After` is set).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/MsrcArchiveUnavailable"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "error": "msrc archive snapshot is not yet available, please retry shortly",
                  "vendor": "msrc"
                }
              }
            }
          }
        }
      }
    },
    "/nvd-deep-dive": {
      "get": {
        "operationId": "getNvdDeepDive",
        "tags": [
          "Statistics"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get counts of CVE records missing enrichment",
        "description": "Returns how many CVE records lack each kind of enrichment (CVSS, CPE, the CISA ADP container, affected versions, package name, program target, repository, platforms, remediation, fix version) all-time, per publication year (oldest first) and per month for the last 36 months (oldest first). The figures are computed daily by a background job.\n\nThe answer is held for 24 hours; `generatedAt` is when the job ran, in Unix **milliseconds**. It is sent with `Cache-Control: public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`. Before the first run the answer is `503`; retry later.",
        "responses": {
          "200": {
            "description": "Missing-enrichment counts.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`. This replaces the `private, no-store` set by the authentication layer.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=300, s-maxage=86400, stale-while-revalidate=86400"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetNvdDeepDiveResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "generatedAt": 1793851200000,
                  "allTime": {
                    "totalRecords": 310000,
                    "missingCvss": 41000,
                    "missingCpe": 98000,
                    "missingCisaAdp": 150000,
                    "onlyAffectedVersions": 12000,
                    "noAffectedVersions": 61000,
                    "noPackageName": 180000,
                    "noProgramTarget": 290000,
                    "noRepo": 210000,
                    "noPlatforms": 270000,
                    "noRemediation": 160000,
                    "noFixVersion": 190000,
                    "cannotMatch": 52000
                  },
                  "yearly": [
                    {
                      "period": "2025",
                      "totalRecords": 48000,
                      "missingCvss": 9000,
                      "missingCpe": 21000,
                      "missingCisaAdp": 12000,
                      "onlyAffectedVersions": 2100,
                      "noAffectedVersions": 6100,
                      "noPackageName": 30000,
                      "noProgramTarget": 45000,
                      "noRepo": 33000,
                      "noPlatforms": 41000,
                      "noRemediation": 22000,
                      "noFixVersion": 28000,
                      "cannotMatch": 7000
                    }
                  ],
                  "monthly": [
                    {
                      "period": "2026-10",
                      "totalRecords": 4100,
                      "missingCvss": 700,
                      "missingCpe": 2600,
                      "missingCisaAdp": 900,
                      "onlyAffectedVersions": 150,
                      "noAffectedVersions": 480,
                      "noPackageName": 2500,
                      "noProgramTarget": 3900,
                      "noRepo": 2800,
                      "noPlatforms": 3500,
                      "noRemediation": 1900,
                      "noFixVersion": 2300,
                      "cannotMatch": 600
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "Either the deep-dive has not been computed yet (the latest precomputed row is missing or unreadable; retry later), or the authentication backend did not answer in time (with `Retry-After: 2`).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "NVD deep-dive not yet available, please retry shortly"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/nvd-deep-dive'"
          }
        ]
      }
    },
    "/packages": {
      "get": {
        "operationId": "listPackages",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List packages in the catalog",
        "description": "Pages through the package catalog, 50 packages at most per page.\n\n- Without `q` (or with `q` shorter than 3 characters, which counts as no query) the answer is the most recently published packages, from a list precomputed nightly; `ecosystem` filters that list.\n- With `q` of 3 or more characters the answer is a name search over every indexed package (the same search as `GET /packages/search`), sorted by name. `ecosystem` does not filter a name search: it is ignored there.\n\nEach package on the page carries its ecosystem, latest version, version count, publish time, vulnerability and exploit counts, KEV membership, OpenSSF Scorecard score, malware flag and, when it maps to an end-of-life product, its EOL status. `inOrg` says whether the package appears in your organisation's scanned dependencies; it is always false when your account has no provisioned organisation.\n\n`page` and `perPage` are never rejected: a value below 1 or not a number falls back to the default, and `perPage` above 50 is clamped to 50.\n\n**Plans.** Below Pro, `eol` is reported only for products sourced from endoflife.date; vendor-lifecycle products are left out without a marker, and a name search does not match vendor-lifecycle product names.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Package name to search for (case-insensitive substring). Fewer than 3 characters is treated as no query, and the recent list is served.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256,
              "pattern": "^[A-Za-z0-9@_][A-Za-z0-9._~:@/+ -]{0,255}$"
            },
            "example": "lodash"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Keep only packages of this ecosystem (case-insensitive) in the recent list. Ignored when `q` is a search.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "npm"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "1-based page number. Values below 1 fall back to 1.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 2000,
              "default": 1
            },
            "example": 1
          },
          {
            "name": "perPage",
            "in": "query",
            "required": false,
            "description": "Packages per page. Values below 1 fall back to 50; values above 50 are clamped to 50.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 50,
              "default": 50
            },
            "example": 50
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "eol-vendor-lifecycle",
          "gatedFields": [
            "$.packages[*].eol"
          ],
          "exception": "No `_pro_data` or `_entitlements` marker is added: below Pro, `eol` is simply absent for products not sourced from endoflife.date."
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/packages?q=lodash&page=1&perPage=50'"
          }
        ],
        "responses": {
          "200": {
            "description": "One page of packages. `query` and `ecosystem` are present only when the page has packages.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Set by authentication: the answer depends on the caller.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPackagesResponse"
                },
                "example": {
                  "query": "lodash",
                  "ecosystem": null,
                  "packages": [
                    {
                      "name": "lodash",
                      "ecosystem": "npm",
                      "latestVersion": "4.17.21",
                      "versionCount": 114,
                      "publishedAt": "2021-02-20T15:42:16Z",
                      "inOrg": true,
                      "isMalware": false,
                      "vulnCount": 7,
                      "exploitCount": 3,
                      "inCisaKev": false,
                      "scorecard": 6.4
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "perPage": 50,
                    "totalRows": 1,
                    "totalPages": 1
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/packages/enrichment": {
      "get": {
        "operationId": "getPackageEnrichment",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get Safe Harbour enrichment for one package",
        "description": "Per-version Safe Harbour scores for one package, with the package-level recommendation, OpenSSF Scorecard score and end-of-life status.\n\nAddress the package by `purl`, or by `name` with an optional `ecosystem` and `version`. A `purl` that parses takes precedence and supplies name, ecosystem and (when it has one) version; one that does not parse is ignored. The name is resolved to the package names the VDB knows (`resolvedNames`, `resolvedMode`), exactly first and by a fuzzy match of at most 10 names when nothing matches exactly.\n\nAt most the 500 newest version strings are enriched (newest by string order, not version order); `total` counts every known version. `q` filters those versions by substring, and `page` and `perPage` page through what is left (default 25, at most 100 per page; a value below 1 or not a number falls back to the default). The recommendation in `safeHarbour` is always computed over all enriched versions, whatever the page or filter, and is aimed at `version` when you give one.\n\n**Plans.** Below Pro, `safeHarbour` and `versions[].safeHarbour` are null, and the answer carries `_pro_data` and `_entitlements` (feature `full-enrichment`). Below Pro, `eol` covers only products sourced from endoflife.date.",
        "parameters": [
          {
            "name": "purl",
            "in": "query",
            "required": false,
            "description": "Package URL. When it parses, it supplies name, ecosystem and version and takes precedence over them.",
            "schema": {
              "$ref": "#/components/schemas/Purl"
            },
            "example": "pkg:npm/lodash@4.17.20"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "description": "Package name (case-insensitive). Required when `purl` is absent or does not parse.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512,
              "pattern": "^@?[A-Za-z0-9_][A-Za-z0-9._~:@/+-]{0,510}$",
              "description": "A package name as its ecosystem writes it, including an npm scope (`@scope/name`), a Maven `group:artifact`, and underscores (`typing_extensions`)."
            },
            "example": "lodash"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Package ecosystem (case-insensitive). Echoed on every version row.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "npm"
          },
          {
            "name": "version",
            "in": "query",
            "required": false,
            "description": "The version in use. Aims the package-level recommendation; echoed as `requestedVersion`.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "4.17.20"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Keep only versions containing this substring (case-insensitive).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._+~:-]{1,128}$"
            },
            "example": "4.17"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "1-based page of the version list. Values below 1 fall back to 1; with at most 500 versions enriched, a page past 500 is always empty.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 1
            },
            "example": 1
          },
          {
            "name": "perPage",
            "in": "query",
            "required": false,
            "description": "Versions per page. Values below 1 fall back to 25; values above 100 are clamped to 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            },
            "example": 25
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.safeHarbour",
            "$.versions[*].safeHarbour"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/packages/enrichment?purl=pkg:npm/lodash@4.17.20&perPage=25'"
          }
        ],
        "responses": {
          "200": {
            "description": "The package's enrichment. `safeHarbour` is absent when no version is known.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "The answer depends on the caller's plan, so it is never stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetPackageEnrichmentResponse"
                },
                "example": {
                  "packageName": "lodash",
                  "ecosystem": "npm",
                  "requestedVersion": "4.17.20",
                  "purl": "pkg:npm/lodash@4.17.20",
                  "resolvedNames": [
                    "lodash"
                  ],
                  "resolvedMode": "exact",
                  "timestamp": 1762300800,
                  "total": 114,
                  "scorecard": 6.4,
                  "eol": null,
                  "hasMalware": false,
                  "versions": [
                    {
                      "version": "4.17.21",
                      "ecosystem": "npm",
                      "sources": [
                        "package_version",
                        "dependency"
                      ],
                      "safeHarbour": {
                        "version": "4.17.21",
                        "vulnerabilityCount": 0,
                        "safeHarbourScore": 0.95,
                        "isMajorRelease": false,
                        "maxSeverity": null,
                        "isMalware": false,
                        "exploitCount": 0,
                        "inKev": false
                      }
                    },
                    {
                      "version": "4.17.20",
                      "ecosystem": "npm",
                      "sources": [
                        "package_version",
                        "cve_affected"
                      ],
                      "safeHarbour": {
                        "version": "4.17.20",
                        "vulnerabilityCount": 2,
                        "safeHarbourScore": 0.61,
                        "isMajorRelease": false,
                        "maxSeverity": "HIGH",
                        "isMalware": false,
                        "exploitCount": 1,
                        "maxExploitMaturity": "POC",
                        "maxCvssScore": 7.2,
                        "maxEpssScore": 0.012,
                        "inKev": false,
                        "maxThreatExposure": 31,
                        "cveIds": [
                          "CVE-2021-23337",
                          "CVE-2020-28500"
                        ]
                      }
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "perPage": 25,
                    "totalRows": 114,
                    "totalPages": 5
                  },
                  "safeHarbour": {
                    "recommendedVersions": [
                      "4.17.21"
                    ],
                    "highestScore": 0.95,
                    "recommendation": {
                      "version": "4.17.21",
                      "reason": "v4.17.21 has no known vulnerabilities, exploits, or malware reports."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither `purl` nor `name` gave a package name (body `{error}`), or the request does not fit this document while request validation is enforced (body `{error, field}`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Provide a `purl`, or a `name` (with optional `ecosystem` and `version`)"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/packages/free-demo": {
      "get": {
        "operationId": "listFreeDemoPackages",
        "tags": [
          "Packages"
        ],
        "security": [],
        "summary": "List the free-demo packages",
        "description": "The packages that callers below Pro may get Safe Harbour data for from `GET /packages/safety-matrix`, `POST /packages/safety-matrix/bulk` and `POST /packages/refresh`. It is the same list those routes enforce, so a client can tell in advance which packages will answer. Entries are `<ecosystem>:<name>`, matched case-insensitively. No credential is needed. When the list cannot be loaded the answer is an empty array.",
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl 'https://api.vdb.vulnes.is/v2/packages/free-demo'"
          }
        ],
        "responses": {
          "200": {
            "description": "The free-demo allowlist.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListFreeDemoPackagesResponse"
                },
                "example": {
                  "free_demo_packages": [
                    "pypi:django",
                    "pypi:celery",
                    "npm:axios",
                    "go:k8s.io/kubernetes",
                    "homebrew:curl"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/packages/org": {
      "get": {
        "operationId": "listOrgPackages",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List your organisation's packages",
        "description": "Pages through the packages your organisation's scans have recorded, sorted by name, 50 at most per page, with the same per-package enrichment as `GET /packages` (without `inOrg`, which would always be true). An account with no provisioned organisation gets an empty page.\n\n- `q` is a case-insensitive substring match on the name; `%` and `_` in it act as SQL wildcards.\n- `ecosystem` matches the recorded ecosystem; `ecosystem=unknown` selects packages with no recorded ecosystem, which come back with `ecosystem` as the empty string or the first ecosystem the VDB knows for the name.\n\n`page` and `perPage` are never rejected: a value below 1 or not a number falls back to the default, and `perPage` above 50 is clamped to 50.\n\n**Plans.** Below Pro, `eol` is reported only for products sourced from endoflife.date; vendor-lifecycle products are left out without a marker.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the package name.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256,
              "pattern": "^[A-Za-z0-9@_][A-Za-z0-9._~:@/+ -]{0,255}$"
            },
            "example": "lodash"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Keep only packages of this recorded ecosystem (case-insensitive); `unknown` selects packages with none recorded.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "npm"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "1-based page number. Values below 1 fall back to 1.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 2000,
              "default": 1
            },
            "example": 1
          },
          {
            "name": "perPage",
            "in": "query",
            "required": false,
            "description": "Packages per page. Values below 1 fall back to 50; values above 50 are clamped to 50.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 50,
              "default": 50
            },
            "example": 50
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "eol-vendor-lifecycle",
          "gatedFields": [
            "$.packages[*].eol"
          ],
          "exception": "No `_pro_data` or `_entitlements` marker is added: below Pro, `eol` is simply absent for products not sourced from endoflife.date."
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/packages/org?q=log4j&ecosystem=maven&page=1'"
          }
        ],
        "responses": {
          "200": {
            "description": "One page of your organisation's packages. `query` and `ecosystem` are present only when the page has packages.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Set by authentication: the answer depends on the caller.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListOrgPackagesResponse"
                },
                "example": {
                  "query": "log4j",
                  "ecosystem": "maven",
                  "packages": [
                    {
                      "name": "org.apache.logging.log4j:log4j-core",
                      "ecosystem": "maven",
                      "latestVersion": "2.17.1",
                      "versionCount": 3,
                      "publishedAt": "2021-12-28T19:41:33Z",
                      "isMalware": false,
                      "vulnCount": 9,
                      "exploitCount": 412,
                      "inCisaKev": true,
                      "scorecard": 7.1
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "perPage": 50,
                    "totalRows": 1,
                    "totalPages": 1
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/packages/org-stats": {
      "get": {
        "operationId": "getOrgPackageStats",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get your organisation's package metrics",
        "description": "Totals for the packages your organisation's scans have recorded (distinct packages, distinct package versions, malicious packages), counts per ecosystem (the 50 largest), and a weekly history over the last 52 weeks of how many distinct packages were recorded. `totalMalicious` is computed over at most 20,000 distinct package names. The answer is held in memory for 5 minutes per organisation. An account with no provisioned organisation gets zeroes and empty lists.",
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/packages/org-stats'"
          }
        ],
        "responses": {
          "200": {
            "description": "Organisation package metrics.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Set by authentication: the answer depends on the caller.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetOrgPackageStatsResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "totalPackages": 1834,
                  "totalVersions": 2977,
                  "totalMalicious": 1,
                  "ecosystems": [
                    {
                      "ecosystem": "npm",
                      "packages": 1402,
                      "versions": 2311
                    },
                    {
                      "ecosystem": "unknown",
                      "packages": 12,
                      "versions": 12
                    }
                  ],
                  "publishHistogram": [
                    {
                      "week": "2025-10-27",
                      "count": 211
                    },
                    {
                      "week": "2025-11-03",
                      "count": 96
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/packages/refresh": {
      "post": {
        "operationId": "refreshPackages",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Refresh packages from their registries",
        "description": "Reads each package's version list straight from its registry, records the releases the VDB did not have (yanked releases and strings that are not concrete versions are skipped), and answers with the Safe Harbour picks recomputed by the same code as `POST /packages/safety-matrix/bulk`. No pick rule or score changes.\n\n- Registries: `npm`, `pypi`, `cargo` and `go` (mode `live`). Every other ecosystem is answered from the stored versions only (mode `database`, nothing added).\n- Each entry goes through the shared input model: ecosystem aliases are accepted (`pip`, `golang`, `crates.io`), an unknown ecosystem is a 400, and a name, ecosystem or version longer than 512 characters is a 413. Errors name the entry, for example `packages[1].ecosystem`. Duplicates keep the first.\n- In the answer `name` is the canonical lowercased name and `ecosystem` is your spelling, lowercased.\n- A package refreshed in the last 60 seconds, by any caller, is not fetched again: its row has `cooldown: true` and picks from the stored versions.\n- A registry failure never fails the request: the row carries `error` and picks from what is stored.\n- At most 50 packages per call (413 above that), and 500 calls per organisation in a rolling 24 hours (429). The body is limited to 262,144 bytes; a larger or malformed body is a 400 `Invalid JSON body`.\n\n**Plans.** Checked per package, as on the bulk route: Pro gets every package; below Pro a package on the free-demo allowlist (`GET /packages/free-demo`) is refreshed and every other package comes back as a `plan-locked` row. When no package qualifies, the answer is the 200 `planLocked` body (feature `safe-harbour`).",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "packages"
                ],
                "properties": {
                  "packages": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 50,
                    "description": "The packages to refresh, in the order the answer should follow.",
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "required": [
                        "name",
                        "ecosystem"
                      ],
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512,
                          "pattern": "^@?[A-Za-z0-9_][A-Za-z0-9._~:@/+-]{0,510}$",
                          "description": "A package name as its ecosystem writes it, including an npm scope (`@scope/name`), a Maven `group:artifact`, and underscores (`typing_extensions`)."
                        },
                        "ecosystem": {
                          "$ref": "#/components/schemas/Ecosystem"
                        },
                        "version": {
                          "description": "The version in use. Only the `stable`, `parity` and rolling-target picks use it.",
                          "allOf": [
                            {
                              "$ref": "#/components/schemas/Version"
                            }
                          ]
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "packages": [
                  {
                    "name": "next",
                    "ecosystem": "npm",
                    "version": "14.1.0"
                  }
                ]
              }
            }
          }
        },
        "x-vulnetix-plan": {
          "mode": "per-item",
          "requiredPlan": "pro",
          "feature": "safe-harbour",
          "gatedFields": [
            "$.packages[*]"
          ],
          "exception": "Packages on the free-demo allowlist (`GET /packages/free-demo`) are refreshed on every plan; when no package in the request qualifies the whole answer is `planLocked`."
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -X POST -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -H 'Content-Type: application/json' -d '{\"packages\":[{\"name\":\"next\",\"ecosystem\":\"npm\",\"version\":\"14.1.0\"}]}' 'https://api.vdb.vulnes.is/v2/packages/refresh'"
          }
        ],
        "responses": {
          "200": {
            "description": "One row per package in request order and one entry per ecosystem, or the `planLocked` body when no package qualifies for the caller's plan.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Set by authentication: the answer depends on the caller.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/RefreshPackagesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/PlanLocked"
                    }
                  ]
                },
                "example": {
                  "schemaVersion": "packages-refresh/v1",
                  "timestamp": 1762300800,
                  "total": 1,
                  "cooldownSeconds": 60,
                  "ecosystems": [
                    {
                      "ecosystem": "npm",
                      "mode": "live",
                      "addedVersions": 3
                    }
                  ],
                  "packages": [
                    {
                      "name": "next",
                      "ecosystem": "npm",
                      "state": "ok",
                      "picks": {
                        "scheme": "semver",
                        "orderable": true,
                        "latest": "15.0.3",
                        "safest": "15.0.3",
                        "stable": "14.2.18",
                        "parity": "14.1.0",
                        "rolling": [
                          "15.0.3"
                        ],
                        "rollingDate": "2024-11-08",
                        "rollingTarget": "15.0.3",
                        "rollingPrevDay": [
                          "15.0.2"
                        ],
                        "rollingPrevDayDate": "2024-10-29",
                        "rollingPrevDayTarget": "15.0.2",
                        "rollingPrevSemver": "15.0.2"
                      },
                      "cooldown": false,
                      "addedVersions": 3,
                      "versionsTracked": 400,
                      "safeVersions": 37
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The body is not JSON or is over 262,144 bytes (`{error}`), `packages` is empty, an entry has no name or ecosystem or an unknown or conflicting ecosystem (`{error, field}`), or the request does not fit this document while request validation is enforced (`{error, field}`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "unknown ecosystem \"npmjs\"",
                  "field": "packages[0].ecosystem"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "More than 50 packages (`max` is 50), or a name, ecosystem or version longer than 512 characters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PackagesRefreshTooLargeError"
                },
                "example": {
                  "error": "at most 50 packages per request",
                  "field": "packages",
                  "max": 50
                }
              }
            }
          },
          "429": {
            "description": "Either the organisation has made 500 refresh calls in the last 24 hours (`{error, limit, used}`, with `Retry-After` counting to the next UTC midnight), or the Community plan's daily request quota is spent (`{success, error, details}`).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/RateLimitError"
                    },
                    {
                      "$ref": "#/components/schemas/PackagesRefreshQuotaError"
                    }
                  ]
                },
                "example": {
                  "error": "Daily package refresh limit reached",
                  "limit": 500,
                  "used": 500
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/packages/safety-matrix": {
      "get": {
        "operationId": "getPackageSafetyMatrix",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get the per-version safety matrix for a package",
        "description": "Every known version of a package with its safety aggregates: malware flag, end-of-life state, vulnerability count with the highest severity, CVSS and EPSS, exploit count with the highest exploit grade, CISA KEV membership, a Safe Harbour score and `isSafeHarbour` (true only for a version with no vulnerability, no exploit, no malware and not end of life). A version is counted as affected only when an affected-version record matches it (exact, range, or the `*` wildcard of a malicious-package advisory). Rows are newest first under the ecosystem's own version order, and `picks` carries the four Safe Harbour picks for `version`.\n\nWhere the versions come from:\n\n- The VDB's published-version inventory, scoped to `ecosystem` when you give one.\n- With `live` on (the default) and an `ecosystem`, the package registry is read as well, adding releases newer than the last crawl (`live.merged`, `live.addedVersions`).\n- When nothing knows a version, the package's GitHub releases or tags (`live.versionSource`, `live.sourceRepo`, `live.releasesRead`); `repo` names the repository when the package name does not. With `source=github` and `repo`, the repository is the only source and `live` is off.\n- With `distro`, only the versions that distribution release carries; `live` and the GitHub fallback are off, and the answer gains a `distro` block.\n\n**Plans.** Safe Harbour is a Pro feature. Below Pro the answer is the 200 `planLocked` body (feature `safe-harbour`) unless the package is on the free-demo allowlist (`GET /packages/free-demo`). The allowlist is keyed `<ecosystem>:<name>`, so a call without `ecosystem` never qualifies. Below Pro, end-of-life state covers only products sourced from endoflife.date.",
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "required": true,
            "description": "Package name (case-insensitive; lowercased).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512,
              "pattern": "^@?[A-Za-z0-9_][A-Za-z0-9._~:@/+-]{0,510}$",
              "description": "A package name as its ecosystem writes it, including an npm scope (`@scope/name`), a Maven `group:artifact`, and underscores (`typing_extensions`)."
            },
            "example": "axios"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Package ecosystem (case-insensitive). Scopes the inventory, enables the live registry read and picks the version order. Required for the free-demo exception: the allowlist is keyed `<ecosystem>:<name>`, so a non-Pro call without `ecosystem` is answered with `planLocked`.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "npm"
          },
          {
            "name": "version",
            "in": "query",
            "required": false,
            "description": "The version in use. Echoed as `selectedVersion` and used for the `stable`, `parity` and rolling-target picks; it does not filter the rows.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "1.6.0"
          },
          {
            "name": "live",
            "in": "query",
            "required": false,
            "description": "`0` turns the live registry read off; any other value (the default) leaves it on. It takes effect only with `ecosystem`, and is off under `distro` or `source=github`.",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ],
              "default": "1"
            },
            "example": "0"
          },
          {
            "name": "repo",
            "in": "query",
            "required": false,
            "description": "The GitHub repository the package comes from: `github:o/r#ref`, `git+https://github.com/o/r.git`, `git+ssh://git@github.com/o/r.git`, `git@github.com:o/r.git`, `github.com/o/r`, `https://github.com/o/r/...` or `o/r`. Read only when nothing else knows a version, or with `source=github`.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 512,
              "pattern": "^(?:github:|[Gg]ithub\\.com/|(?:git\\+)?(?:https?|ssh|git)://(?:git@)?github\\.com/|git@github\\.com:)?[A-Za-z0-9][A-Za-z0-9-]{0,38}/[A-Za-z0-9_][A-Za-z0-9._-]{0,99}(?:\\.git)?(?:#[A-Za-z0-9][A-Za-z0-9._/-]{0,255}|/[A-Za-z0-9][A-Za-z0-9._/-]{0,255})?$"
            },
            "example": "axios/axios"
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "`github`, with `repo`: read the versions from the repository alone, skipping the VDB inventory and the registry, as for a git dependency. Turns `live` off.",
            "schema": {
              "type": "string",
              "enum": [
                "github"
              ]
            },
            "example": "github"
          },
          {
            "name": "distro",
            "in": "query",
            "required": false,
            "description": "Keep only the versions one distribution release carries: a purl distro qualifier such as `alpine-3.20`, `debian-12` or `redhat-9.4` (case-insensitive). Turns `live` and the GitHub fallback off and adds a `distro` block; advisories are still attributed at the distribution-family level (`releaseScoped` false).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
            },
            "example": "alpine-3.20"
          },
          {
            "name": "arch",
            "in": "query",
            "required": false,
            "description": "Architecture for `distro` (case-insensitive; a `linux/` prefix is dropped). `amd64` and `arm64` are indexed; `x86_64` and `aarch64` are accepted.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 32,
              "pattern": "^(?:linux/)?[A-Za-z0-9_]{1,24}$",
              "default": "amd64"
            },
            "example": "arm64"
          }
        ],
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "pro",
          "feature": "safe-harbour",
          "gatedFields": [
            "$"
          ],
          "exception": "Packages on the free-demo allowlist (`GET /packages/free-demo`, keyed `<ecosystem>:<name>`) are answered in full on every plan."
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/packages/safety-matrix?name=axios&ecosystem=npm&version=1.6.0'"
          }
        ],
        "responses": {
          "200": {
            "description": "The safety matrix, or below Pro for a package not on the free-demo allowlist the `planLocked` body.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Set by authentication: the answer depends on the caller.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetPackageSafetyMatrixResponse"
                    },
                    {
                      "$ref": "#/components/schemas/PlanLocked"
                    }
                  ]
                },
                "example": {
                  "schemaVersion": "safety-matrix/v1",
                  "packageName": "axios",
                  "ecosystem": "npm",
                  "selectedVersion": "1.6.0",
                  "resolvedNames": [
                    "axios"
                  ],
                  "resolvedMode": "exact",
                  "tier": "community",
                  "timestamp": 1762300800,
                  "total": 2,
                  "scorecard": 6.9,
                  "eolProduct": null,
                  "live": {
                    "merged": true,
                    "source": "npm",
                    "addedVersions": 0,
                    "versionSource": "registry",
                    "sourceRepo": null,
                    "releasesRead": 0
                  },
                  "picks": {
                    "scheme": "semver",
                    "orderable": true,
                    "latest": "1.7.9",
                    "safest": "1.7.9",
                    "stable": "1.7.9",
                    "parity": "1.6.0",
                    "rolling": [
                      "1.7.9"
                    ],
                    "rollingDate": "2024-12-04",
                    "rollingTarget": "1.7.9",
                    "rollingPrevDay": [
                      "1.6.0"
                    ],
                    "rollingPrevDayDate": "2023-11-08",
                    "rollingPrevDayTarget": "1.6.0",
                    "rollingPrevSemver": "1.6.0"
                  },
                  "versions": [
                    {
                      "version": "1.7.9",
                      "publishedAt": 1733304000000,
                      "isSafeHarbour": true,
                      "isMalware": false,
                      "isEol": false,
                      "eolFrom": null,
                      "vulnCount": 0,
                      "maxSeverity": null,
                      "maxCvss": null,
                      "maxEpss": null,
                      "exploitCount": 0,
                      "maxExploitGrade": null,
                      "inKev": false,
                      "safeHarbourScore": 0.97,
                      "isStable": true,
                      "rank": 1
                    },
                    {
                      "version": "1.6.0",
                      "publishedAt": 1699444800000,
                      "isSafeHarbour": false,
                      "isMalware": false,
                      "isEol": false,
                      "eolFrom": null,
                      "vulnCount": 2,
                      "maxSeverity": "HIGH",
                      "maxCvss": 7.5,
                      "maxEpss": 0.004,
                      "exploitCount": 1,
                      "maxExploitGrade": "POC",
                      "inKev": false,
                      "safeHarbourScore": 0.58,
                      "isStable": true,
                      "rank": 0
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`name` is missing (body `{error}`), or the request does not fit this document while request validation is enforced (body `{error, field}`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Provide a `name` (and ideally an `ecosystem`)"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/packages/safety-matrix/bulk": {
      "post": {
        "operationId": "getPackageSafetyMatrixBulk",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get Safe Harbour picks for a batch of packages",
        "description": "The Safe Harbour state and picks for up to 100 packages in one request: what a list row shows, without the per-version matrix. The rules are those of `GET /packages/safety-matrix`: malware is removed before any pick, `latest`, `safest`, `stable` and `parity` come from clean versions (no vulnerability, exploit or end of life) and the rolling picks may include exposed ones. Each stage runs once for the whole batch.\n\n- Names and ecosystems are lowercased; an entry with no name or no ecosystem is dropped, and duplicates keep the first. More than 100 packages after that is a 400.\n- Only the newest 400 versions of each package are considered.\n- There is no live registry read. When neither the VDB nor a registry knows any version of a package (and no `distro` is set), its GitHub releases or tags are read instead, for at most 25 packages per batch; those rows carry `versionSource`, `sourceRepo` and `releasesRead`.\n- `distro` and `arch` limit every package to one distribution release, and the answer gains a `distro` block.\n- The body is limited to 262,144 bytes; a larger or malformed body is a 400 `Invalid JSON body`.\n- An empty batch (no valid entry) answers `total: 0` and no `timestamp`.\n\n**Plans.** Checked per package. Pro gets every package; below Pro a package on the free-demo allowlist (`GET /packages/free-demo`, keyed `<ecosystem>:<name>`) is answered and every other package comes back as a `plan-locked` row. When no package in the batch qualifies, the answer is the 200 `planLocked` body (feature `safe-harbour`). Below Pro, end-of-life state covers only products sourced from endoflife.date.",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "packages"
                ],
                "properties": {
                  "packages": {
                    "type": "array",
                    "maxItems": 100,
                    "description": "The packages, in the order the answer should follow.",
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "required": [
                        "name",
                        "ecosystem"
                      ],
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512,
                          "pattern": "^@?[A-Za-z0-9_][A-Za-z0-9._~:@/+-]{0,510}$",
                          "description": "A package name as its ecosystem writes it, including an npm scope (`@scope/name`), a Maven `group:artifact`, and underscores (`typing_extensions`)."
                        },
                        "ecosystem": {
                          "$ref": "#/components/schemas/Ecosystem"
                        },
                        "version": {
                          "anyOf": [
                            {
                              "$ref": "#/components/schemas/Version"
                            },
                            {
                              "type": "string",
                              "enum": [
                                ""
                              ]
                            }
                          ],
                          "description": "The version in use. Only the `stable`, `parity` and rolling-target picks use it; without it (absent or empty) they are null."
                        },
                        "repo": {
                          "type": "string",
                          "minLength": 3,
                          "maxLength": 512,
                          "pattern": "^(?:github:|[Gg]ithub\\.com/|(?:git\\+)?(?:https?|ssh|git)://(?:git@)?github\\.com/|git@github\\.com:)?[A-Za-z0-9][A-Za-z0-9-]{0,38}/[A-Za-z0-9_][A-Za-z0-9._-]{0,99}(?:\\.git)?(?:#[A-Za-z0-9][A-Za-z0-9._/-]{0,255}|/[A-Za-z0-9][A-Za-z0-9._/-]{0,255})?$",
                          "description": "The GitHub repository the package comes from (`github:o/r#ref`, `git+https://github.com/o/r.git`, `git+ssh://git@github.com/o/r.git`, `git@github.com:o/r.git`, `github.com/o/r`, `https://github.com/o/r/...` or `o/r`). Read only when no registry knows a version."
                        }
                      }
                    }
                  },
                  "distro": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64,
                    "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$",
                    "description": "Limit every package's versions to those one distribution release carries: a purl distro qualifier such as `alpine-3.20`."
                  },
                  "arch": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 32,
                    "pattern": "^(?:linux/)?[A-Za-z0-9_]{1,24}$",
                    "default": "amd64",
                    "description": "Architecture for `distro`: `amd64` (the default) or `arm64`."
                  }
                }
              },
              "example": {
                "packages": [
                  {
                    "name": "axios",
                    "ecosystem": "npm",
                    "version": "1.6.0"
                  },
                  {
                    "name": "requests",
                    "ecosystem": "pypi"
                  }
                ]
              }
            }
          }
        },
        "x-vulnetix-plan": {
          "mode": "per-item",
          "requiredPlan": "pro",
          "feature": "safe-harbour",
          "gatedFields": [
            "$.packages[*]"
          ],
          "exception": "Packages on the free-demo allowlist (`GET /packages/free-demo`, keyed `<ecosystem>:<name>`) are answered on every plan; when no package in the batch qualifies the whole answer is `planLocked`."
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -X POST -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -H 'Content-Type: application/json' -d '{\"packages\":[{\"name\":\"axios\",\"ecosystem\":\"npm\",\"version\":\"1.6.0\"},{\"name\":\"requests\",\"ecosystem\":\"pypi\"}]}' 'https://api.vdb.vulnes.is/v2/packages/safety-matrix/bulk'"
          }
        ],
        "responses": {
          "200": {
            "description": "One row per package in request order, or the `planLocked` body when no package qualifies for the caller's plan.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Set by authentication: the answer depends on the caller.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetPackageSafetyMatrixBulkResponse"
                    },
                    {
                      "$ref": "#/components/schemas/PlanLocked"
                    }
                  ]
                },
                "example": {
                  "schemaVersion": "safety-matrix-bulk/v1",
                  "tier": "community",
                  "timestamp": 1762300800,
                  "total": 2,
                  "packages": [
                    {
                      "name": "axios",
                      "ecosystem": "npm",
                      "state": "ok",
                      "latest": "1.7.9",
                      "safest": "1.7.9",
                      "stable": "1.7.9",
                      "parity": "1.6.0",
                      "rolling": [
                        "1.7.9"
                      ],
                      "rollingDate": "2024-12-04",
                      "rollingTarget": "1.7.9",
                      "rollingPrevDay": [
                        "1.7.8"
                      ],
                      "rollingPrevDayDate": "2024-11-25",
                      "rollingPrevDayTarget": "1.7.8",
                      "rollingPrevSemver": "1.7.8",
                      "versionsTracked": 112,
                      "safeVersions": 9
                    },
                    {
                      "name": "requests",
                      "ecosystem": "pypi",
                      "state": "plan-locked",
                      "latest": null,
                      "safest": null,
                      "stable": null,
                      "parity": null,
                      "rolling": null,
                      "rollingDate": null,
                      "rollingTarget": null,
                      "rollingPrevDay": null,
                      "rollingPrevDayDate": null,
                      "rollingPrevDayTarget": null,
                      "rollingPrevSemver": null,
                      "versionsTracked": 0,
                      "safeVersions": 0
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The body is not JSON or is over 262,144 bytes (`Invalid JSON body`), the batch has more than 100 distinct packages (`{error, max}`), or the request does not fit this document while request validation is enforced (`{error, field}`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/SafetyMatrixBulkTooManyError"
                    }
                  ]
                },
                "example": {
                  "error": "Too many packages in one batch",
                  "max": 100
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/packages/search": {
      "get": {
        "operationId": "searchPackages",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search packages by name",
        "description": "Finds packages whose name contains `q` (case-insensitive) across every package index the VDB keeps: dependencies, published versions, CVE affected records, GitHub repositories, end-of-life products, KEV, CycloneDX and MSRC records. When deps.dev knows the exact name and the VDB does not, the package is fetched from deps.dev during the request and `upstreamSync` is true.\n\nResults are sorted by name and paged with `limit` (default and cap 100) and `offset`. Out-of-range paging values are never rejected: a `limit` below 1 or not a number becomes 100, above 100 is clamped to 100, and a negative `offset` becomes 0. In `q`, `%` and `_` act as SQL wildcards.\n\n`ecosystem` does not filter the matches. It is a hint: it steers the deps.dev lookup and picks the versioning scheme for `safeHarbour.picks`. Without it the picks are computed only for a package with exactly one known ecosystem.\n\nEach package carries its 10 most recent versions with a per-version Safe Harbour score, a package-level Safe Harbour summary, the CVEs that affect it, exploitation signals, the OpenSSF Scorecard score, provenance, EOL status and a CPE.\n\n`degraded: true` means one or more indexes could not be queried (listed in `unavailableSources`): treat an empty answer as inconclusive, not as \"no such package\". `capped: true` means an index hit its row cap and the answer may be incomplete.\n\n**Plans.** Below Pro, `safeHarbour`, `versions[].safeHarbour`, `exploitationSignals`, `generatedCpe` and `cloudLocators` are null, and the answer carries `_pro_data` and `_entitlements` (feature `full-enrichment`). Below Pro, end-of-life matching and `eolStatus` cover only products sourced from endoflife.date.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Package name or part of one, at least 3 characters after trimming.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 256,
              "pattern": "^[A-Za-z0-9@_][A-Za-z0-9._~:@/+ -]{2,255}$"
            },
            "example": "lodash"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Ecosystem hint (case-insensitive). It does not filter the matches; it steers the deps.dev lookup and picks the versioning scheme for `safeHarbour.picks`.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "npm"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Packages per page. Values below 1 become 100; values above 100 are clamped to 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            },
            "example": 20
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Packages to skip. A negative value becomes 0.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.packages[*].safeHarbour",
            "$.packages[*].versions[*].safeHarbour",
            "$.packages[*].cloudLocators",
            "$.packages[*].generatedCpe",
            "$.packages[*].exploitationSignals"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/packages/search?q=lodash&ecosystem=npm&limit=20'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb packages search lodash --ecosystem npm --limit 20"
          }
        ],
        "responses": {
          "200": {
            "description": "Matching packages, one page.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "The answer depends on the caller's plan, so it is never stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PackageSearchResponse"
                },
                "example": {
                  "query": "lodash",
                  "ecosystem": "npm",
                  "timestamp": 1762300800,
                  "total": 1,
                  "limit": 20,
                  "offset": 0,
                  "hasMore": false,
                  "capped": false,
                  "upstreamSync": false,
                  "degraded": false,
                  "unavailableSources": [],
                  "packages": [
                    {
                      "packageName": "lodash",
                      "matchSources": [
                        "dependency",
                        "package_version",
                        "cve_affected"
                      ],
                      "ecosystems": [
                        "npm"
                      ],
                      "versionCount": 114,
                      "versions": [
                        {
                          "version": "4.17.21",
                          "ecosystem": "npm",
                          "sources": [
                            "dependency"
                          ],
                          "cveIds": [],
                          "publishedAt": "2021-02-20T15:42:16Z",
                          "daysSinceRelease": 1719,
                          "safeHarbour": {
                            "version": "4.17.21",
                            "vulnerabilityCount": 0,
                            "safeHarbourScore": 0.95,
                            "isMajorRelease": false,
                            "maxSeverity": null,
                            "isMalware": false,
                            "exploitCount": 0,
                            "inKev": false,
                            "daysSinceRelease": 1719,
                            "publishedAt": 1613835736000
                          }
                        }
                      ],
                      "safeHarbour": {
                        "recommendedVersions": [
                          "4.17.21"
                        ],
                        "highestScore": 0.95,
                        "picks": {
                          "scheme": "semver",
                          "orderable": true,
                          "latest": "4.17.21",
                          "safest": "4.17.21",
                          "rolling": [
                            "4.17.21"
                          ],
                          "rollingDate": "2021-02-20",
                          "rollingTarget": "4.17.21",
                          "rollingPrevDay": [],
                          "reasons": {
                            "stable": "no-running-version",
                            "parity": "no-running-version",
                            "rollingPrevDay": "no-prior-day",
                            "rollingPrevSemver": "no-prior-release"
                          }
                        }
                      },
                      "vulnCount": 7,
                      "isMalware": false,
                      "vulnerabilities": [
                        {
                          "cveId": "CVE-2021-23337",
                          "source": "nvd",
                          "severity": "HIGH",
                          "score": 7.2,
                          "metricType": "cvssV3_1",
                          "vectorString": "CVSS:3.1/AV:N/AC:L/PR:H/UI:N/S:U/C:H/I:H/A:H",
                          "purl": "pkg:npm/lodash"
                        }
                      ],
                      "exploitationSignals": {
                        "inCisaKev": false,
                        "inVulnCheckKev": false,
                        "exploitCount": 3,
                        "xdbCount": 1,
                        "crowdSecSightings": 0
                      },
                      "scorecardScore": 6.4,
                      "hasProvenance": true,
                      "vendor": "lodash",
                      "product": "lodash",
                      "repositoryUrl": "https://github.com/lodash/lodash",
                      "eolStatus": null,
                      "generatedCpe": "cpe:2.3:a:lodash:lodash:*:*:*:*:*:*:*:*",
                      "cloudLocators": null,
                      "_links": [
                        {
                          "rel": "versions",
                          "href": "/v2/lodash/versions"
                        },
                        {
                          "rel": "product",
                          "href": "/v2/product/lodash"
                        },
                        {
                          "rel": "vulns",
                          "href": "/v2/lodash/vulns"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`q` is missing or shorter than 3 characters (body `{success: false, error}`), or the request does not fit this document while request validation is enforced (body `{error, field}`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Query parameter 'q' is required and must be at least 3 characters"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/packages/stats": {
      "get": {
        "operationId": "getPackageStats",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get package catalog metrics",
        "description": "Catalog-wide totals (packages, versions, malicious packages), package counts per ecosystem, a 12-month weekly publish histogram, and malware IOC counts per ecosystem with a 24-month monthly histogram. Every value is precomputed nightly; the answer is held in memory for 10 minutes and may be cached by the CDN for 30 minutes (`Cache-Control`), so it is the same for every caller.\n\nThe four arrays are passed through as the nightly job wrote them; the item fields listed here are the ones it writes today.",
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/packages/stats'"
          }
        ],
        "responses": {
          "200": {
            "description": "Catalog metrics.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "The same answer serves every caller; shared caches may keep it for 30 minutes.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=60, s-maxage=1800, stale-while-revalidate=1800"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetPackageStatsResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "totalPackages": 4812233,
                  "totalVersions": 61734002,
                  "totalMalicious": 21877,
                  "ecosystems": [
                    {
                      "ecosystem": "npm",
                      "packages": 2950112,
                      "versions": 2950112
                    },
                    {
                      "ecosystem": "pypi",
                      "packages": 612004,
                      "versions": 612004
                    }
                  ],
                  "publishHistogram": [
                    {
                      "week": "2025-11-03T00:00:00Z",
                      "count": 98211
                    }
                  ],
                  "malware": {
                    "ecosystems": [
                      {
                        "ecosystem": "npm",
                        "iocs": 18233
                      }
                    ],
                    "monthlyHistogram": [
                      {
                        "month": "2025-10",
                        "ecosystem": "npm",
                        "count": 1204
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/product/{name}": {
      "get": {
        "operationId": "getProduct",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List a product's versions and their sources",
        "description": "Lists every (version, ecosystem) pair the VDB knows for a package or product name. Reads the product index, a view that unions the package and product names found in CVE affected entries, package registries, dependency records, the CISA and VulnCheck KEV catalogues, CVE metadata, GitHub repositories and OpenSSF Scorecard. Each row is one (version, ecosystem) pair with every index row that names it under `sources`.\n\nThe name is resolved first: an exact match, else up to ten fuzzy matches (`resolvedNames`, `resolvedMode`). When nothing is indexed the API fetches the package from deps.dev once and retries. Versions are ordered newest string first, rows without a version last.\n\n`ecosystem` is a hint for the fuzzy resolver only; it does not filter the rows.\n\nWith `withVulnIntel=1` each version carries a Safe Harbour score and the answer carries a package-level summary. On this route Safe Harbour is not plan-gated today: every plan receives it.\n\nPaging caveat: `limit` and `offset` count index rows (one per source), which are then grouped by version and ecosystem, while `total` counts distinct (version, ecosystem) pairs. A page can therefore hold fewer than `limit` versions, one version's sources can be split across two pages, and `hasMore` compares the two different counts.",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Package or product name. Percent-encode reserved characters: a scoped npm name is sent as `%40scope%2Fname`. The value is percent-decoded and lowercased before it is resolved.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "log4j-core"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Hint for name resolution (case-insensitive). It does not filter the versions returned.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "maven"
          },
          {
            "name": "withVulnIntel",
            "in": "query",
            "required": false,
            "description": "Send `1` to add Safe Harbour scoring: a `safeHarbour` object on every version on the page and a package-level `safeHarbour` summary. Only the exact string `1` turns it on; any other value, or leaving it out, returns no `safeHarbour` keys.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ],
              "maxLength": 1
            },
            "example": "1"
          },
          {
            "name": "currentVersion",
            "in": "query",
            "required": false,
            "description": "The version you run today. With `withVulnIntel=1` the summary's recommendation is computed relative to it; ignored otherwise.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "2.14.1"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500: a larger value is clamped to 500, and zero, a negative number or a non-number falls back to 100. Counts index rows, not versions; see the paging caveat.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip. Default 0; a negative number or a non-number falls back to 0. The server sets no upper bound today; 100000 is the documented maximum.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "The versions on this page. A name nothing resolves (and that deps.dev cannot supply) answers 200 with `versions` null, `resolvedNames` null and `total` 0; a resolved name with no index rows answers an empty `versions` array.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetProductResponse"
                },
                "example": {
                  "packageName": "log4j-core",
                  "resolvedNames": [
                    "log4j-core"
                  ],
                  "resolvedMode": "exact",
                  "timestamp": 1762300800,
                  "total": 214,
                  "limit": 2,
                  "offset": 0,
                  "hasMore": true,
                  "versions": [
                    {
                      "version": "2.25.1",
                      "ecosystem": "maven",
                      "sources": [
                        {
                          "sourceTable": "PackageVersion",
                          "sourceId": "0b5c1a64-2a8e-4f0e-9c1d-6c1f3e2d7a10"
                        }
                      ]
                    },
                    {
                      "version": "2.24.3",
                      "ecosystem": "maven",
                      "sources": [
                        {
                          "sourceTable": "PackageVersion",
                          "sourceId": "4f7d2e19-8a43-4b6c-a1f0-2d9e5c7b3a81"
                        }
                      ]
                    }
                  ],
                  "_links": [
                    {
                      "rel": "versions",
                      "href": "/v2/log4j-core/versions"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/product/log4j-core"
                    },
                    {
                      "rel": "vulns",
                      "href": "/v2/log4j-core/vulns"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/product/log4j-core?limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb product log4j-core --limit 50"
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.safeHarbour",
            "$.versions[*].safeHarbour"
          ]
        }
      }
    },
    "/product/{name}/{version}": {
      "get": {
        "operationId": "getProductVersion",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get one version of a product",
        "description": "Lists the product-index rows for one exact version of a package or product, grouped by ecosystem. Reads the product index, a view that unions the package and product names found in CVE affected entries, package registries, dependency records, the CISA and VulnCheck KEV catalogues, CVE metadata, GitHub repositories and OpenSSF Scorecard. Each row is one (version, ecosystem) pair with every index row that names it under `sources`.\n\nThe name is resolved as on `/product/{name}` (no deps.dev fallback here). `ecosystem` is a resolver hint only. A version the index does not hold answers 200 with an empty `versions` array.\n\nWith `withVulnIntel=1` each version carries a Safe Harbour score and the answer carries a package-level summary. On this route Safe Harbour is not plan-gated today: every plan receives it.\n\nPaging caveat: `limit` and `offset` count index rows (one per source), which are then grouped by version and ecosystem, while `total` counts distinct (version, ecosystem) pairs. A page can therefore hold fewer than `limit` versions, one version's sources can be split across two pages, and `hasMore` compares the two different counts.",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Package or product name. Percent-encode reserved characters: a scoped npm name is sent as `%40scope%2Fname`. The value is percent-decoded and lowercased before it is resolved.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "log4j-core"
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "description": "The version, matched exactly (no range or semver comparison) against the versions the product index holds. Percent-decoded, case kept.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "2.14.1"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Hint for name resolution (case-insensitive). It does not filter the rows.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "maven"
          },
          {
            "name": "withVulnIntel",
            "in": "query",
            "required": false,
            "description": "Send `1` to add Safe Harbour scoring: a `safeHarbour` object on every version on the page and a package-level `safeHarbour` summary. Only the exact string `1` turns it on; any other value, or leaving it out, returns no `safeHarbour` keys.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ],
              "maxLength": 1
            },
            "example": "1"
          },
          {
            "name": "currentVersion",
            "in": "query",
            "required": false,
            "description": "The version you run today. With `withVulnIntel=1` the summary's recommendation is computed relative to it; ignored otherwise.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "2.14.1"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500: a larger value is clamped to 500, and zero, a negative number or a non-number falls back to 100. Counts index rows.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip. Default 0; a negative number or a non-number falls back to 0. The server sets no upper bound today; 100000 is the documented maximum.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "The ecosystems that carry this version, with their sources.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                },
                "example": {
                  "packageName": "log4j-core",
                  "resolvedNames": [
                    "log4j-core"
                  ],
                  "resolvedMode": "exact",
                  "timestamp": 1762300800,
                  "total": 1,
                  "limit": 100,
                  "offset": 0,
                  "hasMore": false,
                  "versions": [
                    {
                      "version": "2.14.1",
                      "ecosystem": "maven",
                      "sources": [
                        {
                          "sourceTable": "PackageVersion",
                          "sourceId": "9a3e6f20-51b7-4c2d-8e4a-7f1b0c9d2e35"
                        },
                        {
                          "sourceTable": "CVEAffected",
                          "sourceId": "CVE-2021-44228"
                        }
                      ]
                    }
                  ],
                  "_links": [
                    {
                      "rel": "versions",
                      "href": "/v2/log4j-core/versions"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/product/log4j-core"
                    },
                    {
                      "rel": "vulns",
                      "href": "/v2/log4j-core/vulns"
                    }
                  ],
                  "version": "2.14.1"
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The product-index query failed (`{\"success\": false, \"error\": \"Internal Server Error\"}`), or another unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/product/log4j-core/2.14.1?withVulnIntel=1'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb product log4j-core 2.14.1"
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.safeHarbour",
            "$.versions[*].safeHarbour"
          ]
        }
      }
    },
    "/product/{name}/{version}/{ecosystem}": {
      "get": {
        "operationId": "getProductVersionEcosystem",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get one version of a product in one ecosystem",
        "description": "Lists the product-index rows for one exact version of a package in one ecosystem. Reads the product index, a view that unions the package and product names found in CVE affected entries, package registries, dependency records, the CISA and VulnCheck KEV catalogues, CVE metadata, GitHub repositories and OpenSSF Scorecard. Each row is one (version, ecosystem) pair with every index row that names it under `sources`.\n\nUnlike the query hint on the sibling routes, the `ecosystem` path segment filters: it is lowercased and compared exactly with the index's ecosystem label (no alias mapping, so use the label the index stores, such as `go` rather than `golang`). It is also passed to the resolver as a hint. A combination the index does not hold answers 200 with an empty `versions` array.\n\nWith `withVulnIntel=1` each version carries a Safe Harbour score and the answer carries a package-level summary. On this route Safe Harbour is not plan-gated today: every plan receives it.\n\nPaging caveat: `limit` and `offset` count index rows (one per source), which are then grouped by version and ecosystem, while `total` counts distinct (version, ecosystem) pairs. A page can therefore hold fewer than `limit` versions, one version's sources can be split across two pages, and `hasMore` compares the two different counts.",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "Package or product name. Percent-encode reserved characters: a scoped npm name is sent as `%40scope%2Fname`. The value is percent-decoded and lowercased before it is resolved.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "log4j-core"
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "description": "The version, matched exactly (no range or semver comparison) against the versions the product index holds. Percent-decoded, case kept.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "2.14.1"
          },
          {
            "name": "ecosystem",
            "in": "path",
            "required": true,
            "description": "Ecosystem label as the product index stores it, for example npm, pypi, maven, go, cargo, nuget, rubygems, generic or unknown. Lowercased; not validated, so an unknown label returns no rows.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "maven"
          },
          {
            "name": "withVulnIntel",
            "in": "query",
            "required": false,
            "description": "Send `1` to add Safe Harbour scoring: a `safeHarbour` object on every version on the page and a package-level `safeHarbour` summary. Only the exact string `1` turns it on; any other value, or leaving it out, returns no `safeHarbour` keys.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ],
              "maxLength": 1
            },
            "example": "1"
          },
          {
            "name": "currentVersion",
            "in": "query",
            "required": false,
            "description": "The version you run today. With `withVulnIntel=1` the summary's recommendation is computed relative to it; ignored otherwise.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "2.14.1"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500: a larger value is clamped to 500, and zero, a negative number or a non-number falls back to 100. Counts index rows.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip. Default 0; a negative number or a non-number falls back to 0. The server sets no upper bound today; 100000 is the documented maximum.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "The sources for this version in this ecosystem.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetProductVersionEcosystemResponse"
                },
                "example": {
                  "packageName": "log4j-core",
                  "resolvedNames": [
                    "log4j-core"
                  ],
                  "resolvedMode": "exact",
                  "timestamp": 1762300800,
                  "total": 1,
                  "limit": 100,
                  "offset": 0,
                  "hasMore": false,
                  "versions": [
                    {
                      "version": "2.14.1",
                      "ecosystem": "maven",
                      "sources": [
                        {
                          "sourceTable": "PackageVersion",
                          "sourceId": "9a3e6f20-51b7-4c2d-8e4a-7f1b0c9d2e35"
                        }
                      ]
                    }
                  ],
                  "_links": [
                    {
                      "rel": "versions",
                      "href": "/v2/log4j-core/versions"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/product/log4j-core"
                    },
                    {
                      "rel": "vulns",
                      "href": "/v2/log4j-core/vulns"
                    }
                  ],
                  "version": "2.14.1",
                  "ecosystem": "maven"
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The product-index query failed (`{\"success\": false, \"error\": \"Internal Server Error\"}`), or another unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/product/log4j-core/2.14.1/maven'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb product log4j-core 2.14.1 maven"
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.safeHarbour",
            "$.versions[*].safeHarbour"
          ]
        }
      }
    },
    "/raw/sources": {
      "get": {
        "operationId": "listRawSources",
        "tags": [
          "Raw Archives"
        ],
        "summary": "List the raw advisory archive sources",
        "description": "The upstream sources whose original payloads are archived, with row counts and whether a single advisory can be fetched from each (`perCVE`). Fetch one with `GET /v2/raw/{source}/{cveId}`. A source whose count fails is left out, so `count` can be below 8.\n\n**Plans.** Teams and above. Below Teams the answer is the 200 `planLocked` body (feature `bulk-data-sync`) with `sources: []` and `count: 0`.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "teams",
          "feature": "bulk-data-sync"
        },
        "x-badges": [
          {
            "name": "Teams",
            "position": "after",
            "color": "#0e7490"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/raw/sources'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb raw sources"
          }
        ],
        "parameters": [],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "200": {
            "description": "The source catalogue, or the `planLocked` body below Teams.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/ThreatActivityCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListRawSourcesResponse"
                    },
                    {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/PlanLocked"
                        },
                        {
                          "type": "object",
                          "required": [
                            "sources",
                            "count"
                          ],
                          "properties": {
                            "sources": {
                              "type": "array",
                              "maxItems": 0,
                              "items": {
                                "type": "object"
                              }
                            },
                            "count": {
                              "type": "integer",
                              "format": "int32",
                              "minimum": 0,
                              "maximum": 0
                            }
                          }
                        }
                      ]
                    }
                  ]
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "sources": [
                    {
                      "slug": "mitre-cve",
                      "perCVE": true,
                      "contentType": "application/json",
                      "description": "MITRE CVEListV5 records (cna + adp containers)",
                      "totalRows": 312045,
                      "archivedRows": 311980
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/raw/{source}/{cveId}": {
      "get": {
        "operationId": "downloadRawAdvisory",
        "tags": [
          "Raw Archives"
        ],
        "summary": "Download the raw upstream advisory",
        "description": "The original upstream payload for one advisory, byte for byte, as an attachment, for audit and forensics. Every source stores JSON. Per-advisory retrieval works for `mitre-cve`, `ghsa`, `osv` and `euvd`; the bundle sources (`nist-nvd`, `vulncheck-nvd`, `vulncheck-kev`, `cisa-kev`) answer 400. `X-Vulnetix-Sha256` carries the stored digest when one is on file.\n\nThe id is upper-cased and matched against the archived file name; when several files match, the most recently stored wins.\n\n**Plans.** Teams and above. Below Teams the answer is the 200 `planLocked` body (feature `bulk-data-sync`).",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "teams",
          "feature": "bulk-data-sync"
        },
        "x-badges": [
          {
            "name": "Teams",
            "position": "after",
            "color": "#0e7490"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/raw/mitre-cve/CVE-2021-44228'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb raw get --source mitre-cve CVE-2021-44228"
          }
        ],
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "description": "Source slug from `GET /v2/raw/sources`.",
            "schema": {
              "type": "string",
              "enum": [
                "mitre-cve",
                "ghsa",
                "osv",
                "euvd",
                "nist-nvd",
                "vulncheck-nvd",
                "vulncheck-kev",
                "cisa-kev"
              ]
            },
            "example": "mitre-cve"
          },
          {
            "name": "cveId",
            "in": "path",
            "required": true,
            "description": "The advisory id as the source files it (CVE for mitre-cve, GHSA or CVE for ghsa, the OSV id for osv, such as `PYSEC-2021-19` or `RHSA-2024:1234`, EUVD or CVE for euvd), any case.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 120,
              "pattern": "^[A-Za-z][A-Za-z0-9]{0,15}-[A-Za-z0-9][A-Za-z0-9.:-]{0,100}$"
            },
            "example": "CVE-2021-44228"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "No archived payload on file for this id in this source (the body names both), or the caller's organisation was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "string",
                      "maxLength": 2048
                    },
                    "success": {
                      "type": "boolean",
                      "enum": [
                        false
                      ]
                    },
                    "source": {
                      "type": "string",
                      "maxLength": 32
                    },
                    "cveId": {
                      "type": "string",
                      "maxLength": 120
                    }
                  }
                },
                "example": {
                  "error": "No archived raw payload on file for this CVE in this source.",
                  "source": "mitre-cve",
                  "cveId": "CVE-2021-44228"
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "Object storage could not be read, or an unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "200": {
            "description": "The archived payload as an attachment, or the `planLocked` body below Teams.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/ThreatActivityCacheControl"
              },
              "Content-Disposition": {
                "description": "`attachment; filename=\"<source>-<id>-<archived file name>\"` on the payload.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              },
              "X-Vulnetix-Sha256": {
                "description": "SHA-256 of the archived file, when one is on file.",
                "schema": {
                  "type": "string",
                  "pattern": "^[0-9a-fA-F]{64}$",
                  "maxLength": 64
                }
              },
              "X-Vulnetix-R2-Path": {
                "description": "Object-storage key of the archived file.",
                "schema": {
                  "type": "string",
                  "maxLength": 1024
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/RawAdvisoryPayload"
                    },
                    {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/PlanLocked"
                        },
                        {
                          "type": "object",
                          "required": [
                            "error"
                          ],
                          "properties": {
                            "error": {
                              "type": "string",
                              "enum": [
                                "Bulk data file sync requires a Teams plan"
                              ]
                            }
                          }
                        }
                      ]
                    }
                  ]
                },
                "example": {
                  "dataType": "CVE_RECORD",
                  "dataVersion": "5.1",
                  "cveMetadata": {
                    "cveId": "CVE-2021-44228",
                    "state": "PUBLISHED"
                  }
                }
              }
            }
          },
          "400": {
            "description": "An unknown source slug, or a source that stores bundle archives rather than per-advisory files. When request validation is enforced, a request that does not fit this document is refused with `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Unknown source slug. Hit GET /v2/raw/sources for the catalogue."
                }
              }
            }
          },
          "410": {
            "description": "The archive row exists but the object is gone from storage.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error",
                    "r2Path"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "error": {
                      "type": "string",
                      "maxLength": 256
                    },
                    "r2Path": {
                      "type": "string",
                      "maxLength": 1024
                    }
                  }
                },
                "example": {
                  "error": "Archived payload is no longer present in object storage.",
                  "r2Path": "mitre-cve/2021/44xxx/CVE-2021-44228.json"
                }
              }
            }
          }
        }
      }
    },
    "/redhat/archive/{month}": {
      "get": {
        "operationId": "getRedhatArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of Red Hat advisories",
        "description": "Returns every Red Hat Security Advisory (RHSA) published in one calendar month (UTC), with CVE aliases, severity, affected products, and links to the errata page and the CSAF document mirrored on vulnes.is. Membership comes from the precomputed archive snapshot, so a month the snapshot has not reached answers 503. Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nRed Hat uses its own vocabulary: `rhsaCount`, `rhsaId`, `errataUrl`, no `kind` and no `sourceBreakdown`. `severityCounts` uses Red Hat's ratings (Critical, Important, Moderate, Low, Unrated) from Red Hat's own scores. Each advisory carries a `risk` block (CVSS, the vendor CVSS from `redhat`, EPSS, CESS, KEV membership, exploit maturity).",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/redhat/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's Red Hat advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetRedhatArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — Red Hat Security Advisories",
                  "rhsaCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 0,
                  "severityCounts": {
                    "Important": 1
                  },
                  "advisories": [
                    {
                      "rhsaId": "RHSA-2024:1249",
                      "title": "Important: kernel security update",
                      "severity": "Important",
                      "datePublished": 1710720000000,
                      "dateUpdated": 1711929600000,
                      "cveAliases": [
                        "CVE-2023-6546"
                      ],
                      "isExploited": false,
                      "errataUrl": "https://access.redhat.com/errata/RHSA-2024:1249",
                      "csafUrl": "https://vulnes.is/redhat-archive/2024-03-18/RHSA-2024_1249.csaf.json",
                      "risk": {
                        "cves": [
                          "CVE-2023-6546"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      },
                      "products": [
                        {
                          "productName": "Red Hat Enterprise Linux 8",
                          "status": "fixed",
                          "vendor": "Red Hat",
                          "packageName": "kernel"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/redhat/archives": {
      "get": {
        "operationId": "listRedhatArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the Red Hat advisory archive",
        "description": "Lists every month that has Red Hat advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\nRed Hat's summary names the advisory count `rhsaCount` and carries no `sourceBreakdown`.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/redhat/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with Red Hat advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RedHatArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "rhsaCount": 412,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "rhsaCount": 389,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/scan/cyclonedx": {
      "post": {
        "operationId": "scanCycloneDx",
        "tags": [
          "SBOM Scanning"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Scan a CycloneDX BOM for vulnerabilities",
        "description": "Send a CycloneDX JSON BOM as the request body and get the software-composition analysis back in the same request. The scan is synchronous: there is no queue and nothing to poll.\n\nOnly `components` is read, and only components whose `type` is `library`, `framework` or absent; other types are skipped. A component's `purl` is used when present; a component without a `purl` is skipped, because the ecosystem is only ever taken from the purl. The request Content-Type is not checked and the body is not decompressed.\n\n**Limits:** the body may weigh at most 10 MiB (10,485,760 bytes); a larger one is refused with 413, never truncated. More than 5000 scanned components is 400 (`CycloneDX BOM exceeds maximum of 5000 components (N found)`). A BOM with no resolvable component is 400.\n\n**Response:** the envelope `{meta, data}`. `data.cyclonedx` is a CycloneDX 1.6 document with the vulnerabilities found, `data.stats` summarises the run, and `data.ingestionSnapshot` and `data.findings` appear when the scan was saved to your organisation's scanner results. Errors use the same envelope with `success: false` and the message under both `error` and `data.error`.\n\n**Plans:** reachability queries (`data.reachability`) are Pro and above; below Pro `data.reachability` is null and `meta.tierGated.reachability` is true. `meta.tier` is `pro` for Pro, Teams and Enterprise callers and `community` otherwise.\n\n**Cache:** answers carry `Cache-Control: private, no-store`.",
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.data.reachability"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -H 'Content-Type: application/json' --data-binary @bom.cdx.json 'https://api.vdb.vulnes.is/v2/scan/cyclonedx'"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CycloneDxBom"
              }
            },
            "application/vnd.cyclonedx+json": {
              "schema": {
                "$ref": "#/components/schemas/CycloneDxBom"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Scan completed.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanResult"
                },
                "example": {
                  "meta": {
                    "tier": "community",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800,
                    "tierGated": {
                      "reachability": true
                    }
                  },
                  "data": {
                    "cyclonedx": {
                      "bomFormat": "CycloneDX",
                      "specVersion": "1.6",
                      "version": 1,
                      "components": [
                        {
                          "type": "library",
                          "name": "log4j-core",
                          "group": "org.apache.logging.log4j",
                          "version": "2.14.1",
                          "purl": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
                        }
                      ],
                      "vulnerabilities": [
                        {
                          "id": "CVE-2021-44228",
                          "affects": [
                            {
                              "ref": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
                            }
                          ]
                        }
                      ]
                    },
                    "reachability": null,
                    "stats": {
                      "purlsRequested": 1,
                      "purlsResolved": 1,
                      "vulnerabilitiesFound": 1,
                      "reachabilityQueries": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The body could not be read, is not a CycloneDX JSON BOM, carries more than 5000 scanned components, or has no component that resolves to a purl.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanError"
                },
                "example": {
                  "success": false,
                  "error": "CycloneDX BOM exceeds maximum of 5000 components (5210 found)",
                  "meta": {
                    "tier": "community",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "CycloneDX BOM exceeds maximum of 5000 components (5210 found)"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The body is larger than 10 MiB (10,485,760 bytes).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanError"
                },
                "example": {
                  "success": false,
                  "error": "document exceeds the maximum of 10485760 bytes",
                  "meta": {
                    "tier": "community",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "document exceeds the maximum of 10485760 bytes"
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The vulnerability lookup or the CycloneDX generation failed (scan envelope, `Vulnerability lookup failed` or `CycloneDX generation failed`), or authentication failed unexpectedly (plain error body).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ScanError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "Vulnerability lookup failed",
                  "meta": {
                    "tier": "pro",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "Vulnerability lookup failed"
                  }
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/scan/manifest": {
      "post": {
        "operationId": "scanManifest",
        "tags": [
          "SBOM Scanning"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Scan a package manifest for vulnerabilities",
        "description": "Upload one package-manager manifest or lockfile as `multipart/form-data` and get the software-composition analysis back in the same request. The scan is synchronous: there is no queue and nothing to poll.\n\n**Fields:** `type` (required) names the manifest format and picks the parser; `file` (required) is the manifest itself; `ecosystem` (optional) overrides the ecosystem of every parsed package. The ecosystem must be a purl type or a known alias (`npm`, `pypi`, `pip`, `maven`, `go`, `cargo`, `rubygems`, `composer`, `nuget` and others) and is canonicalised to the purl type; an unknown one is refused with 400 rather than scanned as nothing. The handler also falls back to `type` and `ecosystem` query parameters when the form fields are absent (an unintended second channel; send them as form fields). Any other form field is ignored (earlier versions of this document listed a `metadata` field; it was never read).\n\n**Limits:** the file may weigh at most 10 MiB (10,485,760 bytes) and the whole request 10 MiB plus 64 KiB of multipart framing; a larger upload is refused with 413, never truncated. A manifest that resolves to more than 5000 distinct purls is refused with 413. A manifest with no resolvable dependency is 400.\n\n**Response:** the envelope `{meta, data}`. `data.cyclonedx` is a CycloneDX 1.6 document with the vulnerabilities found, `data.stats` summarises the run, and `data.ingestionSnapshot` and `data.findings` appear when the scan was saved to your organisation's scanner results. Errors use the same envelope with `success: false` and the message under both `error` and `data.error`.\n\n**Plans:** reachability queries (`data.reachability`) are Pro and above; below Pro `data.reachability` is null and `meta.tierGated.reachability` is true. `meta.tier` is `pro` for Pro, Teams and Enterprise callers and `community` otherwise.\n\n**Cache:** answers carry `Cache-Control: private, no-store`.",
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.data.reachability"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -F type=package-lock.json -F file=@package-lock.json 'https://api.vdb.vulnes.is/v2/scan/manifest'"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "type",
                  "file"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "description": "Manifest format; picks the parser. Case-sensitive.",
                    "enum": [
                      "package.json",
                      "package-lock.json",
                      "requirements.txt",
                      "Pipfile.lock",
                      "go.sum",
                      "go.mod",
                      "Cargo.lock",
                      "Gemfile.lock",
                      "pom.xml",
                      "composer.lock",
                      "yarn.lock",
                      "pnpm-lock.yaml"
                    ],
                    "examples": [
                      "package-lock.json"
                    ]
                  },
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "maxLength": 10485760,
                    "description": "The manifest file, at most 10 MiB (10,485,760 bytes). Its part Content-Type is not checked."
                  },
                  "ecosystem": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/Ecosystem"
                      }
                    ],
                    "description": "Overrides the ecosystem of every parsed package. A purl type or a known alias, matched case-insensitively and canonicalised to the purl type; an unknown value is 400 `Unsupported ecosystem`.",
                    "example": "npm"
                  }
                }
              },
              "encoding": {
                "file": {
                  "contentType": "application/octet-stream, text/plain, application/json, application/xml, text/xml, application/yaml, application/x-yaml, application/toml"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Scan completed.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanResult"
                },
                "example": {
                  "meta": {
                    "tier": "community",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800,
                    "tierGated": {
                      "reachability": true
                    }
                  },
                  "data": {
                    "cyclonedx": {
                      "bomFormat": "CycloneDX",
                      "specVersion": "1.6",
                      "version": 1,
                      "components": [
                        {
                          "type": "library",
                          "name": "lodash",
                          "version": "4.17.20",
                          "purl": "pkg:npm/lodash@4.17.20",
                          "bom-ref": "pkg:npm/lodash@4.17.20"
                        }
                      ],
                      "vulnerabilities": [
                        {
                          "id": "CVE-2021-23337",
                          "affects": [
                            {
                              "ref": "pkg:npm/lodash@4.17.20"
                            }
                          ]
                        }
                      ]
                    },
                    "reachability": null,
                    "stats": {
                      "purlsRequested": 1,
                      "purlsResolved": 1,
                      "vulnerabilitiesFound": 1,
                      "reachabilityQueries": 0
                    },
                    "ingestionSnapshot": {
                      "uuid": "6f1d2c3b-8a9e-4c7d-b1f0-2e3d4c5b6a79",
                      "url": "https://www.vulnes.is/resolve/scanner-results/6f1d2c3b-8a9e-4c7d-b1f0-2e3d4c5b6a79",
                      "createdAt": 1762300800000
                    },
                    "findings": [
                      {
                        "findingId": "CVE-2021-23337",
                        "findingUuid": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
                        "packageName": "lodash",
                        "packageVersion": "4.17.20",
                        "purl": "pkg:npm/lodash@4.17.20"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "The upload was refused: the form could not be parsed, `type` or `file` is missing, `type` or `ecosystem` is not supported, the manifest does not parse, or no dependency in it resolves to a purl.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanError"
                },
                "example": {
                  "success": false,
                  "error": "Unsupported manifest type: setup.py",
                  "meta": {
                    "tier": "community",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "Unsupported manifest type: setup.py"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The file is larger than 10 MiB (10,485,760 bytes), the request is larger than 10 MiB plus 64 KiB, or the manifest resolves to more than 5000 distinct purls.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanError"
                },
                "example": {
                  "success": false,
                  "error": "document exceeds the maximum of 10485760 bytes",
                  "meta": {
                    "tier": "community",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "document exceeds the maximum of 10485760 bytes"
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The vulnerability lookup or the CycloneDX generation failed (scan envelope, `Vulnerability lookup failed` or `CycloneDX generation failed`), or authentication failed unexpectedly (plain error body).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ScanError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "Vulnerability lookup failed",
                  "meta": {
                    "tier": "pro",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "Vulnerability lookup failed"
                  }
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/scan/spdx": {
      "post": {
        "operationId": "scanSpdx",
        "tags": [
          "SBOM Scanning"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Scan an SPDX document for vulnerabilities",
        "description": "Send an SPDX 2.3 JSON document as the request body and get the software-composition analysis back in the same request. The scan is synchronous: there is no queue and nothing to poll.\n\nOnly `packages` is read. Each package's purl is taken from the first `externalRefs` entry whose `referenceType` is `purl`; a package without a purl reference is skipped, because the ecosystem is only ever taken from the purl. The request Content-Type is not checked and the body is not decompressed.\n\n**Limits:** the body may weigh at most 10 MiB (10,485,760 bytes); a larger one is refused with 413, never truncated. More than 5000 packages is 400 (`SPDX document exceeds maximum of 5000 packages (N found)`). A document with no resolvable package is 400.\n\n**Response:** the envelope `{meta, data}`. `data.cyclonedx` is a CycloneDX 1.6 document with the vulnerabilities found, `data.stats` summarises the run, and `data.ingestionSnapshot` and `data.findings` appear when the scan was saved to your organisation's scanner results. Errors use the same envelope with `success: false` and the message under both `error` and `data.error`.\n\n**Plans:** reachability queries (`data.reachability`) are Pro and above; below Pro `data.reachability` is null and `meta.tierGated.reachability` is true. `meta.tier` is `pro` for Pro, Teams and Enterprise callers and `community` otherwise.\n\n**Cache:** answers carry `Cache-Control: private, no-store`.",
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.data.reachability"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -H 'Content-Type: application/json' --data-binary @sbom.spdx.json 'https://api.vdb.vulnes.is/v2/scan/spdx'"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SpdxDocument"
              }
            },
            "application/spdx+json": {
              "schema": {
                "$ref": "#/components/schemas/SpdxDocument"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Scan completed.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanResult"
                },
                "example": {
                  "meta": {
                    "tier": "pro",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "cyclonedx": {
                      "bomFormat": "CycloneDX",
                      "specVersion": "1.6",
                      "version": 1,
                      "components": [
                        {
                          "type": "library",
                          "name": "log4j-core",
                          "group": "org.apache.logging.log4j",
                          "version": "2.14.1",
                          "purl": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
                        }
                      ],
                      "vulnerabilities": [
                        {
                          "id": "CVE-2021-44228",
                          "affects": [
                            {
                              "ref": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
                            }
                          ]
                        }
                      ]
                    },
                    "reachability": [
                      {
                        "vulnId": "CVE-2021-44228",
                        "purl": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1",
                        "language": "java",
                        "name": "jndi-lookup-call",
                        "queryText": "(method_invocation name: (identifier) @m (#eq? @m \"lookup\"))"
                      }
                    ],
                    "stats": {
                      "purlsRequested": 1,
                      "purlsResolved": 1,
                      "vulnerabilitiesFound": 1,
                      "reachabilityQueries": 1
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The body could not be read, is not an SPDX JSON document, carries more than 5000 packages, or has no package that resolves to a purl.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanError"
                },
                "example": {
                  "success": false,
                  "error": "no resolvable dependencies found in manifest",
                  "meta": {
                    "tier": "community",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "no resolvable dependencies found in manifest"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The body is larger than 10 MiB (10,485,760 bytes).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanError"
                },
                "example": {
                  "success": false,
                  "error": "document exceeds the maximum of 10485760 bytes",
                  "meta": {
                    "tier": "community",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "document exceeds the maximum of 10485760 bytes"
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The vulnerability lookup or the CycloneDX generation failed (scan envelope, `Vulnerability lookup failed` or `CycloneDX generation failed`), or authentication failed unexpectedly (plain error body).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ScanError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "CycloneDX generation failed",
                  "meta": {
                    "tier": "pro",
                    "endpointVersion": "2.0",
                    "requestId": "0b6f0c52-6a4e-4d2a-9c39-4f1f0e2a7b11",
                    "timestamp": 1762300800
                  },
                  "data": {
                    "error": "CycloneDX generation failed"
                  }
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        }
      }
    },
    "/scorecard/search": {
      "get": {
        "operationId": "searchScorecards",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search OpenSSF Scorecards by repository name",
        "description": "OpenSSF Scorecard runs whose repository name contains the query (case-insensitive substring), highest overall score first, each with its checks and the number of vulnerabilities linked to it. Open to every plan.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Part of a repository name, for example `openssl` or `github.com/openssl/openssl`.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256,
              "pattern": "^[A-Za-z0-9_][A-Za-z0-9_./-]{0,255}$"
            },
            "example": "openssl"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 100. Default 20; any other value (including one above 100) is replaced by 20.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "example": 20
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; this document bounds it at 100000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "A page of scorecard runs.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchScorecardsResponse"
                },
                "example": {
                  "query": "openssl",
                  "total": 3,
                  "limit": 20,
                  "offset": 0,
                  "results": [
                    {
                      "uuid": "5b0f3d0e-8a4c-4f5e-9d61-2c7b8e9f0a1b",
                      "repository": "github.com/openssl/openssl",
                      "overallScore": 6.8,
                      "date": "2026-10-28T00:00:00Z",
                      "scorecardVersion": "v5.0.0",
                      "repositoryCommit": "9a1b2c3d4e5f60718293a4b5c6d7e8f901234567",
                      "linkedCves": 42,
                      "checks": [
                        {
                          "name": "Code-Review",
                          "score": 9,
                          "reason": "Found 28/30 approved changesets -- score normalized to 9",
                          "shortDescription": "Determines if the project requires human code review before pull requests are merged.",
                          "documentationUrl": "https://github.com/ossf/scorecard/blob/main/docs/checks.md#code-review"
                        }
                      ]
                    }
                  ],
                  "_links": [
                    {
                      "rel": "self",
                      "href": "/v2/scorecard/search?q=openssl"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`q` is missing or blank.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "The scorecard query failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/scorecard/search?q=openssl&limit=20'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb scorecard search openssl"
          }
        ]
      }
    },
    "/search/vulns": {
      "get": {
        "operationId": "searchVulnerabilities",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search vulnerabilities by id, alias, title or text",
        "description": "Ranked search over vulnerability ids, aliases, titles and descriptions. A query shaped like an id (no spaces, `PREFIX-REST`) also matches ids and aliases by prefix. Ranks: an id match 100, an alias 96, a title 80 to 100 and a description 45 to 65 by trigram similarity; one result per vulnerability with its best rank. The description index is skipped when the higher-ranked indexes already fill the page.\n\nResults are paged over at most the first 1000 ranked matches. When an index fails or runs out of time the page is still answered and `warnings` says so; when every index fails the answer is 503 or 504, which does not mean nothing matches. Open to every plan.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Free-text search, 3 to 120 characters: letters and digits in any script, spaces and the punctuation `. _ : @ + # , \" / -`. An apostrophe is accepted only before a letter (`Microsoft's`). Leading and trailing whitespace is trimmed.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 120,
              "pattern": "^(?:[\\p{L}\\p{N}\"@#]|\\.\\p{L})(?:[\\p{L}\\p{N} ._:@\\x2B#,\"/-]|'\\p{L}){1,119}$"
            },
            "example": "log4j remote code execution"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Default 10; a value above 50 is lowered to 50, and a value that is not a positive integer is replaced by the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 50,
              "default": 10
            },
            "example": 10
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Ranked results to skip. Default 0; above 1000 is a 400. A value that is not a non-negative integer is read as 0.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 1000,
              "default": 0
            },
            "example": 0
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "Preferred description language. Lower-cased and cut at the first `-` (`en-US` reads `en`); English is the fallback. Default `en`.",
            "schema": {
              "type": "string",
              "minLength": 2,
              "maxLength": 35,
              "pattern": "^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8}){0,3}$",
              "default": "en"
            },
            "example": "en"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of ranked matches.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VulnSearchResponse"
                },
                "example": {
                  "query": "log4j remote code execution",
                  "timestamp": 1793836800,
                  "limit": 10,
                  "offset": 0,
                  "hasMore": true,
                  "warnings": [],
                  "data": [
                    {
                      "cveId": "CVE-2021-44228",
                      "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                      "titles": [
                        {
                          "lang": "en",
                          "value": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                          "source": "nist-nvd"
                        }
                      ],
                      "description": "Apache Log4j2 2.0-beta9 through 2.15.0 JNDI features ... allow remote code execution.",
                      "matchFields": [
                        "description",
                        "title"
                      ],
                      "matchExcerpt": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP",
                      "score": 86.4,
                      "sources": [
                        "github",
                        "nist-nvd"
                      ],
                      "state": "PUBLISHED",
                      "datePublished": 1639094400,
                      "dateUpdated": 1722729600,
                      "aliases": [
                        "GHSA-jfh8-c2jp-5v3q"
                      ],
                      "_links": [
                        {
                          "rel": "info",
                          "href": "/v2/info/CVE-2021-44228"
                        },
                        {
                          "rel": "kev",
                          "href": "/v2/vuln/CVE-2021-44228/kev"
                        }
                      ]
                    }
                  ],
                  "_links": [
                    {
                      "rel": "packages",
                      "href": "/v2/packages/search"
                    },
                    {
                      "rel": "identifiers",
                      "href": "/v2/identifiers"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`q` is missing, shorter than 3 or longer than 120 bytes, or `offset` is above 1000.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "499": {
            "description": "The client closed the connection before the answer was ready.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Every index failed (the database is refusing queries or the connection dropped), or the service is in maintenance. `Retry-After` is 5 for a search failure.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "Cache-Control": {
                "description": "`no-store`.",
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/VulnSearchErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                }
              }
            }
          },
          "504": {
            "description": "The search ran out of its time budget before any index answered. Retry, or narrow the query.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "Cache-Control": {
                "description": "`no-store`.",
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VulnSearchErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Vulnerability search timed out before any index could answer. This is not a statement that no vulnerability matches — retry, or narrow the query.",
                  "query": "log4j remote code execution",
                  "warnings": [
                    "title search exceeded its latency budget; results may be limited"
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/search/vulns?q=log4j%20remote%20code%20execution&limit=10'"
          }
        ]
      }
    },
    "/snort-rules": {
      "get": {
        "operationId": "searchSnortRules",
        "tags": [
          "Detection Rules"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search Snort rules",
        "description": "Searches the Snort and Suricata rule catalogue. Filters combine with AND. Repeated `cveId` or `source` match any of the values; repeated `technique`, `tactic`, `affectedProduct` or `tag` must all be present on the rule. Ordered by `sort` (default `recent`: newest `datePublished` first). Paged by `limit` (default 100, at most 200) and `offset`.\n\nEvery plan gets every rule and its metadata. Below Pro the rule text is withheld: `rawText` is null and `_pro_data` / `_entitlements` name it (feature `detection-rules-catalog`), and free text `q` matches `msg` only, so a search cannot recover text the caller cannot see.\n\nTakes every input kind (`vulnId`, `package`, `ecosystem`, `version`, `vendor`, `product`, `cpe`, `purl`, `swid`, `tei`, `cel`): they resolve to vulnerability ids (aliases included) and replace the `cveId` filter, and the answer gains `resolved`. Inputs that resolve to nothing answer an empty page, never an unfiltered one. `cveId` given alone keeps its own meaning (an exact match, no aliases).",
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "detection-rules-catalog",
          "gatedFields": [
            "$.rules[*].rawText",
            "$.rules[*].bodyOptions"
          ],
          "note": "The search rows carry no parsed bodyOptions today; the rule is kept so it stays gated if they ever do."
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/snort-rules?technique=T1190&classtype=attempted-admin&limit=20'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb snort-rules list --technique T1190 --severity major"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/DetectionVexCveId"
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Rule source, exact match; repeat for OR (for example `emergingthreats`, `snort-registered`, `vulnetix`).",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
              }
            },
            "example": [
              "emergingthreats"
            ]
          },
          {
            "name": "technique",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "ATT&CK technique id the rule's `mitreTechIds` must contain, exact and case-sensitive; repeat for AND.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 9,
                "pattern": "^T[0-9]{4}(?:\\.[0-9]{3})?$"
              }
            },
            "example": [
              "T1190"
            ]
          },
          {
            "name": "tactic",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "ATT&CK tactic id the rule's `mitreTacticIds` must contain, exact and case-sensitive; repeat for AND.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 6,
                "pattern": "^TA[0-9]{4}$"
              }
            },
            "example": [
              "TA0001"
            ]
          },
          {
            "name": "classtype",
            "in": "query",
            "required": false,
            "description": "Snort `classtype`, exact match (for example `attempted-admin`, `web-application-attack`).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$"
            },
            "example": "attempted-admin"
          },
          {
            "name": "severity",
            "in": "query",
            "required": false,
            "description": "`signatureSeverity`, exact match ignoring case. Values are as published: Emerging Threats rules carry `Informational`, `Minor`, `Major` or `Critical`.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 32,
              "pattern": "^[A-Za-z]{1,32}$"
            },
            "example": "major"
          },
          {
            "name": "protocol",
            "in": "query",
            "required": false,
            "description": "Rule header protocol, exact match ignoring case (for example `tcp`, `udp`, `http`, `icmp`, `tls`, `ip`).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 16,
              "pattern": "^[A-Za-z0-9]{1,16}$"
            },
            "example": "tcp"
          },
          {
            "name": "action",
            "in": "query",
            "required": false,
            "description": "Rule action, exact match ignoring case (for example `alert`, `pass`, `drop`, `reject`, `log`).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 16,
              "pattern": "^[A-Za-z]{1,16}$"
            },
            "example": "alert"
          },
          {
            "name": "dstPort",
            "in": "query",
            "required": false,
            "description": "Destination port field, exact match as written in the rule header (for example `443`, `$HTTP_PORTS`, `any`, `[80,443]`).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 65,
              "pattern": "^!?(?:\\$[A-Z][A-Z0-9_]{0,62}|[a-z0-9:,!]{1,64}|\\[[A-Za-z0-9_:,!$]{1,62}\\])$"
            },
            "example": "$HTTP_PORTS"
          },
          {
            "name": "srcPort",
            "in": "query",
            "required": false,
            "description": "Source port field, exact match as written in the rule header.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 65,
              "pattern": "^!?(?:\\$[A-Z][A-Z0-9_]{0,62}|[a-z0-9:,!]{1,64}|\\[[A-Za-z0-9_:,!$]{1,62}\\])$"
            },
            "example": "any"
          },
          {
            "name": "disabled",
            "in": "query",
            "required": false,
            "description": "Only rules that ship disabled (`true` or `1`) or enabled (`false` or `0`); the words are case-insensitive. Any other value is ignored.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 5,
              "pattern": "^(?:[Tt][Rr][Uu][Ee]|[Ff][Aa][Ll][Ss][Ee]|[01])$"
            },
            "example": "false"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Free text; whitespace-separated words must all appear (ILIKE). Pro and above search `msg` and `rawText`; below Pro `msg` only.",
            "schema": {
              "$ref": "#/components/schemas/SafeText"
            },
            "example": "log4j"
          },
          {
            "name": "affectedProduct",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "A value `affectedProducts` must contain, exact match; repeat for AND.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9 _.+:-]{0,127}$"
              }
            },
            "example": [
              "Apache_log4j"
            ]
          },
          {
            "name": "tag",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "A value `tags` must contain, exact match; repeat for AND.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9 _.:-]{0,127}$"
              }
            },
            "example": [
              "Exploit"
            ]
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only rules with `datePublished` at or after this time.",
            "schema": {
              "$ref": "#/components/schemas/DetectionVexLooseTime"
            },
            "example": "2026-01-01T00:00:00Z"
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Only rules with `datePublished` at or before this time.",
            "schema": {
              "$ref": "#/components/schemas/DetectionVexLooseTime"
            },
            "example": "2026-01-01T00:00:00Z"
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "`recent` (newest `datePublished` first), `severity`, or `id` (`snortId`). Case-insensitive; another value means `recent`. `severity` orders by `signatureSeverity` ignoring case: `critical` first, then `high` and Emerging Threats' `Major`, then `medium` and `Minor`, then `low`, then `informational`; any other value and rules without one come last. Ties are broken by `snortId`.",
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "severity",
                "id"
              ],
              "default": "recent"
            },
            "example": "recent"
          },
          {
            "$ref": "#/components/parameters/DetectionVexLimit200"
          },
          {
            "$ref": "#/components/parameters/DetectionVexOffset"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of matching rules. With an input kind given, the answer carries `resolved`, or is the 200 body of the route unchanged otherwise.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/DetectionVexCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/DetectionVexVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchSnortRulesResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 31,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "rules": [
                    {
                      "uuid": "6f1c2a9e-1d3b-4c55-9a51-0b7f3e2d8c41",
                      "snortId": "2034647",
                      "rev": 3,
                      "action": "alert",
                      "protocol": "tcp",
                      "srcIp": "$EXTERNAL_NET",
                      "srcPort": "any",
                      "direction": "->",
                      "dstIp": "$HOME_NET",
                      "dstPort": "any",
                      "msg": "ET EXPLOIT Apache log4j RCE Attempt (http ldap) (CVE-2021-44228)",
                      "flow": "established,to_server",
                      "classtype": "attempted-admin",
                      "disabled": false,
                      "confidence": "High",
                      "signatureSeverity": "Major",
                      "affectedProducts": [
                        "Apache_log4j"
                      ],
                      "tags": [
                        "Exploit"
                      ],
                      "mitreTechIds": [
                        "T1190"
                      ],
                      "mitreTacticIds": [
                        "TA0001"
                      ],
                      "datePublished": "2021-12-10T00:00:00Z",
                      "source": "emergingthreats",
                      "rawText": null
                    }
                  ],
                  "_pro_data": [
                    "$.rules[*].rawText"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "detection-rules-catalog",
                        "requiredPlan": "pro",
                        "paths": [
                          "$.rules[*].rawText"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/DetectionVexSearchBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/DetectionVexUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/DetectionVexInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DetectionVexInputUnresolvable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/DetectionVexInternalError"
          },
          "503": {
            "$ref": "#/components/responses/DetectionVexUnavailable"
          }
        }
      }
    },
    "/sources": {
      "get": {
        "operationId": "listSources",
        "tags": [
          "Enumerations"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List vulnerability data sources",
        "description": "Lists every data source the database holds records from, gathered from every table that records a source. The list is sorted by id. Ids are canonicalised (lower-cased, a `:suffix` dropped, `_` and `-` spellings folded) and internal first-party values are left out.\n\nCurated sources carry a display name, short name and description. For any other source `displayName` and `shortName` are the upper-cased id and `description` is the id itself.\n\nIf a minority of the source tables could not be read in time the answer is still `200`, with `degraded: true` and the unread tables in `droppedSources`; it is cached for 60 seconds instead of an hour (`Cache-Control: public, max-age=60` instead of `public, max-age=3600`). When the main advisory table or half or more of the tables cannot be read the answer is `500`.",
        "responses": {
          "200": {
            "description": "Data sources.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`public, max-age=3600`, or `public, max-age=60` when `degraded` is true. This replaces the `private, no-store` set by the authentication layer.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=3600",
                    "public, max-age=60"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListSourcesResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "sources": [
                    {
                      "id": "nvd",
                      "displayName": "National Vulnerability Database",
                      "shortName": "NVD",
                      "description": "NIST National Vulnerability Database"
                    },
                    {
                      "id": "osv",
                      "displayName": "Open Source Vulnerabilities",
                      "shortName": "OSV",
                      "description": "Open Source Vulnerabilities database"
                    },
                    {
                      "id": "redhat",
                      "displayName": "REDHAT",
                      "shortName": "REDHAT",
                      "description": "redhat"
                    }
                  ],
                  "degraded": false,
                  "droppedSources": []
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/sources'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb sources"
          }
        ]
      }
    },
    "/spec": {
      "get": {
        "operationId": "getOpenApiSpec",
        "tags": [
          "Service"
        ],
        "security": [],
        "summary": "Get the OpenAPI document for the v2 API",
        "description": "Returns this OpenAPI 3.1 document as JSON. No credential is needed and the call does not count against any quota.\n\nThe answer carries a strong `ETag` (a hash of the document) and `Cache-Control: public, max-age=300`. Send the tag back in `If-None-Match` to get `304 Not Modified` with no body while the document is unchanged; the document changes only when the service is redeployed.\n\nThe operations the Vulnesis CLI calls (`/v2/cli.*`) are described in a separate document, `GET /v2/spec/cli`.",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "An entity tag from an earlier `ETag`, a comma-separated list of them, or `*`. Weak (`W/`) tags are compared weakly. On a match the answer is `304` with no body.",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fW/\", *]+$",
              "minLength": 1,
              "maxLength": 1024
            },
            "example": "\"3f1c2a9b8d7e6f5a4b3c2d1e0f9a8b7c\""
          }
        ],
        "responses": {
          "200": {
            "description": "The OpenAPI document.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Cache-Control": {
                "description": "`public, max-age=300`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=300"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenApiDocument"
                },
                "example": {
                  "openapi": "3.1.0",
                  "info": {
                    "title": "Vulnesis VDB API",
                    "version": "2.1.0"
                  },
                  "servers": [
                    {
                      "url": "https://api.vdb.vulnes.is/v2",
                      "description": "Production"
                    }
                  ],
                  "paths": {}
                }
              }
            }
          },
          "304": {
            "description": "The caller's copy (named in `If-None-Match`) is current. No body.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Cache-Control": {
                "description": "`public, max-age=300`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=300"
                  ]
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl 'https://api.vdb.vulnes.is/v2/spec'"
          }
        ]
      }
    },
    "/spec/cli": {
      "get": {
        "operationId": "getCliSpec",
        "tags": [
          "Service"
        ],
        "security": [],
        "summary": "Get the OpenAPI document for the CLI operations",
        "description": "Returns the OpenAPI 3.1 document that describes the `/v2/cli.*` operations the Vulnesis CLI and GitHub Action call. No credential is needed.\n\nCaching works as for `GET /v2/spec`: a strong `ETag`, `Cache-Control: public, max-age=300`, and `304 Not Modified` with no body when `If-None-Match` names the current tag.",
        "parameters": [
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "An entity tag from an earlier `ETag`, a comma-separated list of them, or `*`. Weak (`W/`) tags are compared weakly. On a match the answer is `304` with no body.",
            "schema": {
              "type": "string",
              "pattern": "^[0-9a-fW/\", *]+$",
              "minLength": 1,
              "maxLength": 1024
            },
            "example": "\"3f1c2a9b8d7e6f5a4b3c2d1e0f9a8b7c\""
          }
        ],
        "responses": {
          "200": {
            "description": "The CLI OpenAPI document.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Cache-Control": {
                "description": "`public, max-age=300`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=300"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenApiDocument"
                },
                "example": {
                  "openapi": "3.1.0",
                  "info": {
                    "title": "Vulnesis CLI API",
                    "version": "2.0.0"
                  },
                  "servers": [
                    {
                      "url": "https://api.vdb.vulnes.is/v2",
                      "description": "Production"
                    }
                  ],
                  "paths": {}
                }
              }
            }
          },
          "304": {
            "description": "The caller's copy (named in `If-None-Match`) is current. No body.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/ETag"
              },
              "Cache-Control": {
                "description": "`public, max-age=300`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=300"
                  ]
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl 'https://api.vdb.vulnes.is/v2/spec/cli'"
          }
        ]
      }
    },
    "/spec/cli/ui": {
      "get": {
        "operationId": "getCliApiReferenceUi",
        "tags": [
          "Service"
        ],
        "security": [],
        "summary": "Open the CLI API reference page",
        "description": "Returns an HTML page that renders `GET /v2/spec/cli` as an interactive API reference (Scalar), loaded from the same origin. No credential is needed. Headers are as for `GET /v2/spec/ui`.",
        "responses": {
          "200": {
            "description": "The reference page.",
            "headers": {
              "Cache-Control": {
                "description": "`public, max-age=3600`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=3600"
                  ]
                }
              },
              "Content-Security-Policy": {
                "description": "Restricts the page to the pinned Scalar script from cdn.jsdelivr.net and its one inline initialisation script (allowed by hash); the page fetches only from its own origin and cannot be framed.",
                "schema": {
                  "type": "string",
                  "maxLength": 1024
                }
              },
              "X-Content-Type-Options": {
                "description": "Always `nosniff`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "nosniff"
                  ]
                }
              },
              "Referrer-Policy": {
                "description": "Always `no-referrer`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "no-referrer"
                  ]
                }
              }
            },
            "content": {
              "text/html; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "maxLength": 65536
                },
                "example": "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>Vulnesis CLI API</title>\n<meta name=\"description\" content=\"The operations the Vulnesis CLI and GitHub Action call.\">\n<style>body{margin:0}</style>\n</head>\n<body>\n<div id=\"app\"></div>\n<script src=\"https://cdn.jsdelivr.net/npm/@scalar/api-reference@1.75.1/dist/browser/standalone.js\" integrity=\"sha256-O77upbqBD1tEOZe9JG4yEG8aEXZZog4vzD3oVeUEeVY=\" crossorigin=\"anonymous\"></script>\n<script>Scalar.createApiReference('#app', {\"authentication\":{\"preferredSecurityScheme\":\"ApiKeyAuth\"},\"metaData\":{\"description\":\"The operations the Vulnesis CLI and GitHub Action call.\",\"title\":\"Vulnesis CLI API\"},\"persistAuth\":false,\"url\":\"/v2/spec/cli\",\"withDefaultFonts\":false})</script>\n</body>\n</html>"
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl 'https://api.vdb.vulnes.is/v2/spec/cli/ui'"
          }
        ]
      }
    },
    "/spec/ui": {
      "get": {
        "operationId": "getApiReferenceUi",
        "tags": [
          "Service"
        ],
        "security": [],
        "summary": "Open the API reference page",
        "description": "Returns an HTML page that renders `GET /v2/spec` as an interactive API reference (Scalar). The page loads the document from the same origin it is served from, so a local build shows the local document. No credential is needed.\n\nThe page is cached for an hour (`Cache-Control: public, max-age=3600`) and is served with a strict `Content-Security-Policy`, `X-Content-Type-Options: nosniff` and `Referrer-Policy: no-referrer`.",
        "responses": {
          "200": {
            "description": "The reference page.",
            "headers": {
              "Cache-Control": {
                "description": "`public, max-age=3600`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=3600"
                  ]
                }
              },
              "Content-Security-Policy": {
                "description": "Restricts the page to the pinned Scalar script from cdn.jsdelivr.net and its one inline initialisation script (allowed by hash); the page fetches only from its own origin and cannot be framed.",
                "schema": {
                  "type": "string",
                  "maxLength": 1024
                }
              },
              "X-Content-Type-Options": {
                "description": "Always `nosniff`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "nosniff"
                  ]
                }
              },
              "Referrer-Policy": {
                "description": "Always `no-referrer`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "no-referrer"
                  ]
                }
              }
            },
            "content": {
              "text/html; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "maxLength": 65536
                },
                "example": "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>Vulnesis VDB API</title>\n<meta name=\"description\" content=\"Vulnerability intelligence: advisories, exploits, detection content, remediation and package safety.\">\n<style>body{margin:0}</style>\n</head>\n<body>\n<div id=\"app\"></div>\n<script src=\"https://cdn.jsdelivr.net/npm/@scalar/api-reference@1.75.1/dist/browser/standalone.js\" integrity=\"sha256-O77upbqBD1tEOZe9JG4yEG8aEXZZog4vzD3oVeUEeVY=\" crossorigin=\"anonymous\"></script>\n<script>Scalar.createApiReference('#app', {\"authentication\":{\"preferredSecurityScheme\":\"ApiKeyAuth\"},\"metaData\":{\"description\":\"Vulnerability intelligence: advisories, exploits, detection content, remediation and package safety.\",\"title\":\"Vulnesis VDB API\"},\"persistAuth\":false,\"url\":\"/v2/spec\",\"withDefaultFonts\":false})</script>\n</body>\n</html>"
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl 'https://api.vdb.vulnes.is/v2/spec/ui'"
          }
        ]
      }
    },
    "/summary": {
      "get": {
        "operationId": "getSummary",
        "tags": [
          "Statistics"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get database-wide statistics",
        "description": "Returns database-wide counts: records and identifiers, severity distribution, enrichment coverage, the ten most common CWEs and the ten most affected vendors. The figures are computed daily by a background job; this operation reads the latest of each.\n\nThe assembled answer is held for 24 hours, so `timestamp` is when it was assembled, which can be up to a day old. A statistic the job has not produced reads as `0`; `topCWEs` and `topVendors` are `[]` when not produced. Before the first run (or when the precomputed rows cannot be read) the answer is `503`; retry later.",
        "responses": {
          "200": {
            "description": "Database-wide statistics.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`, set by the authentication layer: the answer must not be stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetSummaryResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "database": {
                    "totalRows": 1520000,
                    "distinctCveIds": 310000,
                    "totalExploits": 130000,
                    "maliciousPackages": 4200,
                    "cvesWithExploits": 48000,
                    "totalReferences": 4400000,
                    "distinctReferenceUrls": 2950000,
                    "totalKev": 1480,
                    "ghsaTotal": 41000,
                    "ghsaNoCve": 9800,
                    "nonCveTotal": 520000,
                    "vulnetixEnriched": 180000
                  },
                  "severity": {
                    "critical": 21000,
                    "high": 72000,
                    "medium": 118000,
                    "low": 28000,
                    "none": 1200
                  },
                  "coverage": {
                    "withCvss": 260000,
                    "cvssV2Count": 90000,
                    "cvssV3Count": 230000,
                    "cvssV4Count": 21000,
                    "withEpss": 290000,
                    "withCess": 50000,
                    "withCwe": 240000,
                    "withCapec": 32000,
                    "withSsvc": 61000,
                    "noReferences": 2800,
                    "averageEpss": 0.021348,
                    "highEpss": 9500,
                    "epssCves": 290000
                  },
                  "topCWEs": [
                    {
                      "cweId": "CWE-79",
                      "count": 52000
                    },
                    {
                      "cweId": "CWE-89",
                      "count": 24000
                    }
                  ],
                  "topVendors": [
                    {
                      "vendor": "Microsoft",
                      "count": 14000
                    },
                    {
                      "vendor": "Google",
                      "count": 11000
                    }
                  ],
                  "enrichment": {
                    "snortRules": 41000,
                    "enrichedIDS": 12000,
                    "patchableAll": 160000,
                    "patchableCve": 140000,
                    "enrichedCPE": 230000,
                    "enrichedPURL": 95000,
                    "enrichedPatchable": 88000,
                    "enrichedCRIT": 5400
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "Either the summary has not been computed yet (the latest precomputed row is missing or unreadable; retry later), or the authentication backend did not answer in time (with `Retry-After: 2`).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Summary not yet available, please retry shortly"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/summary'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb summary"
          }
        ]
      }
    },
    "/suse/archive/{month}": {
      "get": {
        "operationId": "getSuseArchive",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "Get one month of SUSE advisories",
        "description": "Returns every SUSE advisory published in one calendar month (UTC): SUSE Linux Enterprise (`SUSE-SU-*`), openSUSE (`openSUSE-SU-*`) and Rancher (RKE2, K3s, NeuVector) advisories. The month's advisories are found by publication date when the request is served. Each entry is one CVE row; `advisoryId` is the errata id, so several entries can share one `advisoryId` (and then share one `risk` block). Not paginated: the whole month is returned. The API caches each month in process for 30 minutes.\n\nEach advisory carries a `risk` block with the signals used to rank it (CVSS, the vendor's own CVSS from `suse`, EPSS, CESS, KEV membership, exploit maturity). `severityCounts` counts distinct CVEs per normalised severity across every scoring source, so a CVE rated differently by two sources is counted in both buckets and the sum can exceed `cveCount`.\n\nA failed advisory lookup answers 500.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VendorArchiveMonth"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/suse/archive/2024-03'"
          }
        ],
        "responses": {
          "200": {
            "description": "The month's SUSE advisories.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetSuseArchiveResponse"
                },
                "example": {
                  "timestamp": 1730764800,
                  "month": "2024-03",
                  "title": "March 2024 — SUSE Security Advisories",
                  "advisoryCount": 1,
                  "cveCount": 1,
                  "exploitedCount": 0,
                  "severityCounts": {
                    "Critical": 1
                  },
                  "sourceBreakdown": {
                    "sles": 1,
                    "opensuse": 0,
                    "rancher": 0
                  },
                  "advisories": [
                    {
                      "advisoryId": "SUSE-SU-2024:0975-1",
                      "kind": "sles",
                      "title": "Security update for xz",
                      "severity": "CRITICAL",
                      "datePublished": 1711670400000,
                      "cveAliases": [
                        "CVE-2024-3094"
                      ],
                      "isExploited": false,
                      "advisoryUrl": "https://www.suse.com/support/update/announcement/2024/suse-su-20240975-1/",
                      "products": [
                        {
                          "productName": "SUSE Linux Enterprise Server 15 SP5",
                          "status": "affected",
                          "vendor": "SUSE",
                          "packageName": "xz"
                        }
                      ],
                      "risk": {
                        "cves": [
                          "CVE-2024-3094"
                        ],
                        "vendorCvss": 7.5,
                        "cvss": 9.8,
                        "cvssSource": "nist-nvd",
                        "epss": 0.0421,
                        "epssPercentile": 0.9123,
                        "cess": 0.38,
                        "exploitMaturity": "poc",
                        "exploitCount": 1
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/VendorArchiveMonthNotFound"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "$ref": "#/components/responses/VendorArchiveBadRequest"
          }
        }
      }
    },
    "/suse/archives": {
      "get": {
        "operationId": "listSuseArchives",
        "tags": [
          "Vendor Archives"
        ],
        "summary": "List months in the SUSE advisory archive",
        "description": "Lists every month that has SUSE advisories, newest first, with per-month counts. Served from a snapshot the summary processor rebuilds daily: `timestamp` and `generatedAt` are both the snapshot's build time, and the API caches the answer in process for 10 minutes. Takes no parameters and is not paginated. Answers 503 until the first snapshot exists.\n\n`sourceBreakdown` counts advisories per stream; the keys present are among `sles`, `opensuse`, `rancher`, and a stream with no advisories that month is absent. `advisoryCount` is the snapshot's count and can differ from what the month endpoint returns.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "parameters": [],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/suse/archives'"
          }
        ],
        "responses": {
          "200": {
            "description": "Months with SUSE advisories, newest first.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VendorArchiveXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VendorArchiveCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VendorArchiveVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorArchiveIndex"
                },
                "example": {
                  "timestamp": 1730678400,
                  "total": 2,
                  "generatedAt": 1730678400,
                  "archives": [
                    {
                      "month": "2024-10",
                      "title": "October 2024",
                      "advisoryCount": 128,
                      "cveCount": 301,
                      "exploitedCount": 6,
                      "sourceBreakdown": {
                        "sles": 128
                      },
                      "latestDate": 1730332800000
                    },
                    {
                      "month": "2024-09",
                      "title": "September 2024",
                      "advisoryCount": 117,
                      "cveCount": 276,
                      "exploitedCount": 4,
                      "sourceBreakdown": {
                        "sles": 117
                      },
                      "latestDate": 1727654400000
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "503": {
            "$ref": "#/components/responses/VendorArchiveSnapshotUnavailable"
          }
        }
      }
    },
    "/triage": {
      "get": {
        "operationId": "getTriageFeed",
        "tags": [
          "Threat Activity"
        ],
        "summary": "Get the score-driven triage feed",
        "description": "The daily SOC pull: vulnerabilities filtered and ranked by latest EPSS, latest CESS, best CVSS and KEV membership.\n\n**Default window.** With no EPSS floor, no `sort=epss`, no `inKev=true` and none of `since`, `windowDays`, `vendor` or `product`, the feed covers only vulnerabilities published in the last 24 hours. `since` wins over `windowDays` when both are given.\n\n**sort=epss** needs `minEpss` or `minEpssPercentile`, and `minEpss` at least 0.3; otherwise 400. Below 0.3 use `sort=cvss` or `sort=published`.\n\nThe score floors are parsed as numbers but their ranges are not enforced. `minEpssPercentile` is a percentage (0 to 100). Default sort `cvss`; `limit` defaults to 100, capped at 200.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/triage?minEpss=0.7&inKev=true&severity=high&limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb triage --min-epss 0.7 --in-kev true --severity high --limit 50"
          }
        ],
        "parameters": [
          {
            "name": "minEpss",
            "in": "query",
            "required": false,
            "description": "Latest EPSS score floor, 0 to 1. At least 0.3 with `sort=epss`.",
            "schema": {
              "type": "number",
              "format": "double",
              "minimum": 0,
              "maximum": 1
            },
            "example": 0.7
          },
          {
            "name": "minEpssPercentile",
            "in": "query",
            "required": false,
            "description": "Latest EPSS percentile floor as a percentage, 0 to 100.",
            "schema": {
              "type": "number",
              "format": "double",
              "minimum": 0,
              "maximum": 100
            },
            "example": 95
          },
          {
            "name": "minCess",
            "in": "query",
            "required": false,
            "description": "Latest CESS score floor, 0 to 10.",
            "schema": {
              "type": "number",
              "format": "double",
              "minimum": 0,
              "maximum": 10
            },
            "example": 5
          },
          {
            "name": "minCvss",
            "in": "query",
            "required": false,
            "description": "Best CVSS base score floor, 0 to 10.",
            "schema": {
              "type": "number",
              "format": "double",
              "minimum": 0,
              "maximum": 10
            },
            "example": 9
          },
          {
            "name": "severity",
            "in": "query",
            "required": false,
            "description": "CVSS severity band (critical 9.0+, high 7.0 to 8.9, medium 4.0 to 6.9, low 0.1 to 3.9).",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 8,
              "pattern": "^(?:[Cc][Rr][Ii][Tt][Ii][Cc][Aa][Ll]|[Hh][Ii][Gg][Hh]|[Mm][Ee][Dd][Ii][Uu][Mm]|[Ll][Oo][Ww])$"
            },
            "example": "high"
          },
          {
            "name": "inKev",
            "in": "query",
            "required": false,
            "description": "`true` or `1` keeps only known-exploited vulnerabilities; `false` or `0` drops them. Any other value answers 400.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 5,
              "pattern": "^(?:[Tt][Rr][Uu][Ee]|[Ff][Aa][Ll][Ss][Ee]|1|0)$"
            },
            "example": "true"
          },
          {
            "name": "kevSource",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "KEV list to match, exact and case-sensitive (`CISA`, `enisa`, `vulncheck`, `vulnetix`); repeat for any of several. An unknown value matches nothing.",
            "schema": {
              "type": "array",
              "maxItems": 10,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 32,
                "pattern": "^[A-Za-z0-9_-]{1,32}$"
              }
            },
            "example": [
              "CISA"
            ]
          },
          {
            "name": "cwe",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "CWE id such as `CWE-79`, any case; repeat for any of several.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 5,
                "maxLength": 10,
                "pattern": "^[Cc][Ww][Ee]-[0-9]{1,6}$"
              }
            },
            "example": [
              "CWE-502"
            ]
          },
          {
            "name": "vendor",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the affected vendor.",
            "schema": {
              "$ref": "#/components/schemas/VendorName"
            },
            "example": "apache"
          },
          {
            "name": "product",
            "in": "query",
            "required": false,
            "description": "Case-insensitive substring of the affected product.",
            "schema": {
              "$ref": "#/components/schemas/ProductName"
            },
            "example": "log4j"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Published at or after this time: RFC 3339, `YYYY-MM-DDTHH:MM:SS`, `YYYY-MM-DD HH:MM:SS` or `YYYY-MM-DD` (UTC). Wins over `windowDays`.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 35,
              "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?(Z|[+-][0-9]{2}:[0-9]{2})?| [0-9]{2}:[0-9]{2}:[0-9]{2})?$"
            },
            "example": "2025-11-01T00:00:00Z"
          },
          {
            "name": "windowDays",
            "in": "query",
            "required": false,
            "description": "Published in the last N days, 1 to 30. Without it (and without the other scoping filters) the window is 1 day.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 30
            },
            "example": 7
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Ranking. `epss` needs an EPSS floor; `kev-due` orders by KEV due date, soonest first.",
            "schema": {
              "type": "string",
              "enum": [
                "epss",
                "cess",
                "cvss",
                "published",
                "kev-due"
              ],
              "default": "cvss"
            },
            "example": "cvss"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Default 100, capped at 200.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 200,
              "default": 100
            },
            "example": 50
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; 100000 is the documented one.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The query failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "400": {
            "description": "An invalid filter: a score floor that is not a number, an unknown `severity` or `sort`, an `inKev` other than true/false/1/0, an unparseable `since`, `windowDays` outside 1 to 30, `sort=epss` without an EPSS floor, or `minEpss` below 0.3 with `sort=epss`. When request validation is enforced, a request that does not fit this document is refused with `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "windowDays must be 1..30 (got 45)"
                }
              }
            }
          },
          "200": {
            "description": "A page of the feed.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/ThreatActivityCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetTriageFeedResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "limit": 50,
                  "offset": 0,
                  "items": [
                    {
                      "cveId": "CVE-2021-44228",
                      "source": "cve.org",
                      "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                      "datePublished": "2021-12-10T00:00:00Z",
                      "vendor": "Apache Software Foundation",
                      "product": "Apache Log4j2",
                      "cvss": {
                        "vectorString": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H",
                        "baseScore": 10,
                        "severity": "CRITICAL"
                      },
                      "epss": {
                        "score": 0.94358,
                        "percentile": 0.99956
                      },
                      "cess": {
                        "score": 9.1
                      },
                      "kev": {
                        "source": "CISA",
                        "dueDate": "2021-12-24T00:00:00Z",
                        "knownRansomwareCampaignUse": "Known"
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/vendor-trends": {
      "get": {
        "operationId": "getVendorTrends",
        "tags": [
          "Statistics"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get vendor vulnerability counts over time",
        "description": "Returns vendor activity as two time series computed daily by a background job: one bucket per month for the last 18 months and one per calendar year for the last 10 years, newest first. Each bucket gives distinct identifiers published in the period split by prefix (`CVE-`, `GHSA-`, other) and the 50 vendors with the most, with the same split.\n\nThe operation takes no parameters (a `vendor` or `year` query parameter is ignored). The answer is held for 24 hours; `generatedAt` is when the job computed the series (Unix seconds). It is sent with `Cache-Control: public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`, so shared caches keep it for a day. Before the first run the answer is `503`; retry later.",
        "responses": {
          "200": {
            "description": "Vendor counts over time.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`public, max-age=300, s-maxage=86400, stale-while-revalidate=86400`: five minutes in a browser, a day at the CDN. This replaces the `private, no-store` set by the authentication layer.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=300, s-maxage=86400, stale-while-revalidate=86400"
                  ]
                }
              },
              "Vary": {
                "description": "Always `Authorization, Accept-Encoding`: the answer depends on the credential. Set by the API; CloudFront may rewrite it.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetVendorTrendsResponse"
                },
                "example": {
                  "timestamp": 1793872800,
                  "generatedAt": 1793851200,
                  "monthly": [
                    {
                      "period": "2026-11",
                      "totals": {
                        "cve": 1234,
                        "ghsa": 567,
                        "other": 89,
                        "total": 1890
                      },
                      "topVendors": [
                        {
                          "vendor": "Microsoft",
                          "count": 123,
                          "cve": 100,
                          "ghsa": 20,
                          "other": 3
                        }
                      ]
                    }
                  ],
                  "yearly": [
                    {
                      "period": "2026",
                      "totals": {
                        "cve": 38000,
                        "ghsa": 7200,
                        "other": 410,
                        "total": 45610
                      },
                      "topVendors": [
                        {
                          "vendor": "Microsoft",
                          "count": 1400,
                          "cve": 1100,
                          "ghsa": 290,
                          "other": 10
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "Either the vendor series has not been computed yet (the latest precomputed row is missing or unreadable; retry later), or the authentication backend did not answer in time (with `Retry-After: 2`).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Vendor trends not yet available, please retry shortly"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vendor-trends'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb vendor-trends"
          }
        ]
      }
    },
    "/vex": {
      "get": {
        "operationId": "searchVexStatements",
        "tags": [
          "VEX"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search your VEX statements",
        "description": "Searches the statements in the VEX documents your organisation has uploaded (no other organisation's), newest first. Paged by `limit` (default 100, at most 200) and `offset`; the answer has no `total`. `since` is applied to the page after it is read, so a page can hold fewer than `limit` statements while later pages still have some: page on until a page comes back empty.\n\nTakes every input kind (`vulnId`, `package`, `ecosystem`, `version`, `vendor`, `product`, `cpe`, `purl`, `swid`, `tei`, `cel`): they resolve to vulnerability ids (aliases included) and replace the `cveId` filter, and the answer gains `resolved`. Inputs that resolve to nothing answer an empty page, never an unfiltered one. `cveId` given alone keeps its own meaning (an exact match, no aliases).",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vex?status=not_affected&limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb vex list --status not_affected --supplier \"Red Hat\""
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/DetectionVexCveId"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "VEX status, exact and case-sensitive match.",
            "schema": {
              "type": "string",
              "enum": [
                "not_affected",
                "affected",
                "fixed",
                "under_investigation"
              ]
            },
            "example": "not_affected"
          },
          {
            "name": "supplier",
            "in": "query",
            "required": false,
            "description": "Substring of the statement's supplier, ignoring case.",
            "schema": {
              "$ref": "#/components/schemas/SafeText"
            },
            "example": "Red Hat"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only statements whose timestamp is at or after this time, applied after paging.",
            "schema": {
              "$ref": "#/components/schemas/DetectionVexLooseTime"
            },
            "example": "2026-01-01T00:00:00Z"
          },
          {
            "$ref": "#/components/parameters/DetectionVexLimit200"
          },
          {
            "$ref": "#/components/parameters/DetectionVexOffset"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of your organisation's statements, with `resolved` when an input kind was given.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/DetectionVexCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/DetectionVexVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchVexStatementsResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "limit": 50,
                  "offset": 0,
                  "statements": [
                    {
                      "uuid": "a4f2c9d1-7e3b-4b8a-9c21-5d6e7f8a9b0c",
                      "openVexUuid": "e1d2c3b4-a596-4877-8a69-5b4c3d2e1f00",
                      "timestamp": "2024-03-01T12:00:00Z",
                      "vulnerabilityId": "CVE-2021-44228",
                      "vulnerabilityName": "CVE-2021-44228",
                      "products": [
                        {
                          "@id": "pkg:maven/com.example/billing-service@3.2.0"
                        }
                      ],
                      "status": "not_affected",
                      "supplier": "Red Hat",
                      "justification": "vulnerable_code_not_in_execute_path"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/DetectionVexSearchBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/DetectionVexUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/DetectionVexInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DetectionVexInputUnresolvable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "An unexpected server error in the shared middleware. The handler itself never answers 500: a failed statement query answers 200 with `statements: null` and `count` 0.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/DetectionVexUnavailable"
          }
        }
      }
    },
    "/virtual-patches": {
      "get": {
        "operationId": "searchVirtualPatches",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search virtual patches",
        "description": "Blocking defences derived from the proof-of-concept exploits Vulnesis has ingested: Snort and Suricata signatures, ModSecurity and nginx rules, AWS WAF rule statements, Cloudflare expressions and layer-7 patterns. These are what an edge or an inline sensor enforces.\n\nNarrow the catalogue by any input kind (a vulnerability id, a package with ecosystem and version, a purl, a vendor and product, a CPE, a SWID tag, a TEI or a CEL expression) and by the catalogue's own filters. Inputs resolve to vulnerabilities, and a defence matches when it is linked to one of them; with software inputs only, a defence whose exploit names the software matches too. Inputs that name nothing match nothing. With no input the whole catalogue is searched.\n\nFilters combine with AND; `kind` values combine with OR. An unknown `kind`, `confidence` or `deployMode` matches nothing rather than failing. `limit` defaults to 100 and is clamped to 200. For a CEL expression or a SWID tag too long for a query string, use the POST form.\n\n**Plans.** `count`, `total`, `byKind` and `resolved` are answered for every plan. The `virtual-patches` list is Pro and above: below Pro it is `null`, and `_pro_data` and `_entitlements` (feature `virtual-patches`) say so.",
        "parameters": [
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Kinds to keep (OR). Repeat the parameter or separate kinds with commas; matched case-insensitively. An unknown kind matches nothing.",
            "schema": {
              "type": "array",
              "maxItems": 16,
              "items": {
                "$ref": "#/components/schemas/VirtualPatchKindList"
              }
            },
            "example": [
              "SNORT"
            ]
          },
          {
            "$ref": "#/components/parameters/DefenceConfidence"
          },
          {
            "$ref": "#/components/parameters/DefenceDeployMode"
          },
          {
            "$ref": "#/components/parameters/DefenceExploitSource"
          },
          {
            "$ref": "#/components/parameters/DefenceQuery"
          },
          {
            "$ref": "#/components/parameters/DefenceLimit"
          },
          {
            "$ref": "#/components/parameters/DefenceOffset"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "Matching virtual patches.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchVirtualPatchesResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 3,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "byKind": {
                    "SNORT": 2,
                    "AWS_WAF": 1
                  },
                  "resolved": {
                    "kinds": [
                      "purl"
                    ],
                    "vulnIds": [
                      "CVE-2021-44228",
                      "GHSA-jfh8-c2jp-5v3q"
                    ],
                    "packages": [
                      {
                        "ecosystem": "maven",
                        "name": "org.apache.logging.log4j/log4j-core",
                        "version": "2.14.1"
                      }
                    ]
                  },
                  "virtual-patches": [
                    {
                      "uuid": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f",
                      "artifactId": "vulnetix-vp-5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73-snort",
                      "kind": "SNORT",
                      "title": "Log4Shell JNDI lookup in request",
                      "confidence": "HIGH",
                      "deployMode": "block",
                      "falsePositiveRisk": "LOW",
                      "mitreTechIds": [
                        "T1190"
                      ],
                      "rawText": "alert tcp any any -> $HOME_NET any (msg:\"VULNETIX Log4Shell JNDI lookup\"; content:\"${jndi:\"; nocase; sid:9100001; rev:1;)",
                      "fileSize": 121,
                      "exploitUuid": "5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73",
                      "exploitId": "50592",
                      "exploitSource": "exploit-db",
                      "matchedCve": "CVE-2021-44228",
                      "archiveUrl": "/v2/virtual-patches/9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f/archive",
                      "consoleUrl": "https://www.vulnes.is/resolve/virtual-patching?dc=9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f#catalogue",
                      "createdAt": "2025-02-11T08:14:03Z",
                      "updatedAt": "2025-03-02T17:40:55Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "An input is malformed; `field` names it.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DefenceInputUnauthorized"
          },
          "413": {
            "$ref": "#/components/responses/DefenceInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DefenceInputUnresolvable"
          },
          "503": {
            "$ref": "#/components/responses/DefenceInputUnavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "virtual-patches",
          "gatedFields": [
            "$.virtual-patches"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/virtual-patches?purl=pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1&kind=SNORT&limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb virtual-patches list --purl pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1 --kind SNORT"
          }
        ]
      },
      "post": {
        "operationId": "searchVirtualPatchesByBody",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search virtual patches with a JSON body",
        "description": "The same search as `GET /virtual-patches`, with the inputs and filters in a JSON body: use it for a CEL expression or a SWID tag too long for a query string. The body is at most 256 KiB; a larger body is 413 and a malformed one 400. Send `{}` for the whole catalogue.\n\n`?limit=` and `?offset=` in the query string are honoured too; body `limit` and `offset` replace them when above 0. `limit` defaults to 100 and is clamped to 200.\n\n**Plans.** `count`, `total`, `byKind` and `resolved` are answered for every plan. The `virtual-patches` list is Pro and above: below Pro it is `null`, and `_pro_data` and `_entitlements` (feature `virtual-patches`) say so.",
        "parameters": [
          {
            "$ref": "#/components/parameters/DefenceLimit"
          },
          {
            "$ref": "#/components/parameters/DefenceOffset"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "At most 256 KiB.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DefenceSearchBody"
              },
              "example": {
                "cel": "component.name == \"log4j-core\"",
                "kind": [
                  "SNORT"
                ],
                "confidence": "HIGH",
                "limit": 50
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Matching virtual patches.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchVirtualPatchesResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 3,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "byKind": {
                    "SNORT": 2,
                    "AWS_WAF": 1
                  },
                  "resolved": {
                    "kinds": [
                      "purl"
                    ],
                    "vulnIds": [
                      "CVE-2021-44228",
                      "GHSA-jfh8-c2jp-5v3q"
                    ],
                    "packages": [
                      {
                        "ecosystem": "maven",
                        "name": "org.apache.logging.log4j/log4j-core",
                        "version": "2.14.1"
                      }
                    ]
                  },
                  "virtual-patches": [
                    {
                      "uuid": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f",
                      "artifactId": "vulnetix-vp-5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73-snort",
                      "kind": "SNORT",
                      "title": "Log4Shell JNDI lookup in request",
                      "confidence": "HIGH",
                      "deployMode": "block",
                      "falsePositiveRisk": "LOW",
                      "mitreTechIds": [
                        "T1190"
                      ],
                      "rawText": "alert tcp any any -> $HOME_NET any (msg:\"VULNETIX Log4Shell JNDI lookup\"; content:\"${jndi:\"; nocase; sid:9100001; rev:1;)",
                      "fileSize": 121,
                      "exploitUuid": "5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73",
                      "exploitId": "50592",
                      "exploitSource": "exploit-db",
                      "matchedCve": "CVE-2021-44228",
                      "archiveUrl": "/v2/virtual-patches/9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f/archive",
                      "consoleUrl": "https://www.vulnes.is/resolve/virtual-patching?dc=9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f#catalogue",
                      "createdAt": "2025-02-11T08:14:03Z",
                      "updatedAt": "2025-03-02T17:40:55Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The body is not valid JSON, an input has the wrong JSON type, or `kind` is neither a string nor a list of strings (`{error}`); or an input is malformed (`InputError`, `field` names it).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Invalid JSON body: http: request body too large"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DefenceInputUnauthorized"
          },
          "413": {
            "description": "The body is over 256 KiB (`{error: \"Invalid JSON body: http: request body too large\"}`), or an input is over its limit: more than 100 vulnerability ids, a field over 512 characters, a SWID tag over 64 KiB or a CEL expression over 4 KiB (`field` names the input).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "error": "Invalid JSON body: http: request body too large"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/DefenceInputUnresolvable"
          },
          "503": {
            "$ref": "#/components/responses/DefenceInputUnavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "virtual-patches",
          "gatedFields": [
            "$.virtual-patches"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -X POST -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" -H 'Content-Type: application/json' 'https://api.vdb.vulnes.is/v2/virtual-patches' -d '{\"cel\":\"component.name == \\\"log4j-core\\\"\",\"kind\":[\"SNORT\"]}'"
          }
        ]
      }
    },
    "/virtual-patches/{uuid}/archive": {
      "get": {
        "operationId": "downloadVirtualPatch",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Download one virtual patch rule body",
        "description": "Serves one virtual patch's rule body as the file its tool expects, with the conventional filename (`<artifactId>-<name>`) and content type for its kind: SNORT `local.rules`, SURICATA `suricata.rules`, MODSECURITY `modsecurity.conf`, NGINX `nginx-waf.conf`, AWS_WAF `wafv2-rule.json` (application/json), CLOUDFLARE_WAF `cloudflare-expression.txt`, REGEX_L7 `pattern.txt`; text/plain unless stated. A kind without a conventional file is served as `<artifactId>.txt`, text/plain.\n\n**Plans.** Pro and above. Below Pro the answer is HTTP 200 `application/json` with the `planLocked` marker (feature `virtual-patches`), whatever the uuid. The gate reads the caller's Pro flag, not the plan rank.\n\nAn unknown uuid is 404; the uuid is not checked for shape.",
        "parameters": [
          {
            "name": "uuid",
            "in": "path",
            "required": true,
            "description": "The virtual patch's `uuid`, from a list or search answer (its `archiveUrl`).",
            "schema": {
              "$ref": "#/components/schemas/Uuid"
            },
            "example": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f"
          }
        ],
        "responses": {
          "200": {
            "description": "The rule body as its own file, or below Pro the `planLocked` marker (application/json).",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Content-Disposition": {
                "description": "`attachment; filename=\"<artifactId>-<conventional name>\"`. Not sent with the planLocked marker.",
                "schema": {
                  "type": "string",
                  "maxLength": 512
                }
              },
              "X-Vulnetix-Sha256": {
                "description": "sha256 of the body, hex, when the record carries one.",
                "schema": {
                  "type": "string",
                  "maxLength": 128
                }
              },
              "X-Vulnetix-Defence-Kind": {
                "description": "The defence's kind. Not sent with the planLocked marker.",
                "schema": {
                  "$ref": "#/components/schemas/VirtualPatchKind"
                }
              },
              "Cache-Control": {
                "description": "`private, max-age=300` with a rule body; `private, no-store` with the planLocked marker.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, max-age=300",
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "text/plain; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "maxLength": 1048576,
                  "description": "SNORT (`local.rules`), SURICATA (`suricata.rules`), MODSECURITY (`modsecurity.conf`), NGINX (`nginx-waf.conf`), CLOUDFLARE_WAF (`cloudflare-expression.txt`) and REGEX_L7 (`pattern.txt`) bodies, verbatim."
                },
                "example": "alert tcp any any -> $HOME_NET any (msg:\"VULNETIX Log4Shell JNDI lookup\"; content:\"${jndi:\"; nocase; sid:9100001; rev:1;)\n"
              },
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "description": "An AWS_WAF body (`wafv2-rule.json`): the WAFv2 rule JSON, verbatim.",
                      "type": [
                        "object",
                        "array"
                      ],
                      "maxProperties": 64,
                      "maxItems": 64
                    },
                    {
                      "$ref": "#/components/schemas/PlanLocked"
                    }
                  ]
                },
                "example": {
                  "planLocked": true,
                  "feature": "virtual-patches",
                  "requiredPlan": "pro",
                  "upgrade": true,
                  "error": "Pro subscription required to download a defence rule",
                  "_pro_data": [
                    "virtual-patches rule body"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "virtual-patches",
                        "requiredPlan": "pro"
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "description": "No virtual patch has this uuid (`{\"error\": \"Not found\"}`), or the caller's organisation was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Not found"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "whole",
          "requiredPlan": "pro",
          "feature": "virtual-patches"
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/virtual-patches/9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f/archive'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb virtual-patches fetch 9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f -o local.rules"
          }
        ]
      }
    },
    "/vuln/{identifier}": {
      "get": {
        "operationId": "getVuln",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get the CVE JSON 5 records for a vulnerability",
        "description": "Every source's record for a vulnerability as a CVE JSON 5 record, one array element per source (sorted by source name), each with a Vulnesis ADP container carrying EPSS, CESS, KEV, SSVC, exploitation maturity, attack surface, threat exposure, remediation timeline and the other enrichment the database holds for that source, and `x_links` to the other answers.\n\nThe identifier is any advisory id (family prefix upper-cased, alias resolved). Answers are cached in the server for 15 minutes (`X-Cache`). Given a purl, CPE, TEI or SWID tag instead, the route runs once per resolved vulnerability (at most 50, known-exploited first) and answers the `VulnRecordsFanout` envelope with each run's array under `results[].records`. Open to every plan.",
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          }
        ],
        "responses": {
          "200": {
            "description": "One CVE JSON 5 record per source; or, for a purl, CPE, TEI or SWID identifier, the fan-out envelope.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VulnApiXCache"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "array",
                      "maxItems": 64,
                      "items": {
                        "$ref": "#/components/schemas/CVEListV5Record"
                      },
                      "minItems": 1
                    },
                    {
                      "$ref": "#/components/schemas/VulnRecordsFanout"
                    }
                  ]
                },
                "example": [
                  {
                    "dataType": "CVE_RECORD",
                    "dataVersion": "5.1",
                    "cveMetadata": {
                      "cveId": "CVE-2021-44228",
                      "assignerOrgId": "8254265b-2729-46b6-b9e3-3dfca2d5bfca",
                      "state": "PUBLISHED",
                      "datePublished": "2021-12-10T00:00:00Z",
                      "dateUpdated": "2024-08-04T00:00:00Z"
                    },
                    "containers": {
                      "cna": {
                        "providerMetadata": {
                          "orgId": "8254265b-2729-46b6-b9e3-3dfca2d5bfca",
                          "shortName": "apache"
                        },
                        "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                        "descriptions": [
                          {
                            "lang": "en",
                            "value": "Apache Log4j2 2.0-beta9 through 2.15.0 JNDI features ... allow remote code execution."
                          }
                        ],
                        "affected": [
                          {
                            "vendor": "Apache Software Foundation",
                            "product": "Apache Log4j2",
                            "versions": [
                              {
                                "version": "2.0-beta9",
                                "status": "affected",
                                "lessThan": "2.15.0",
                                "versionType": "maven"
                              }
                            ]
                          }
                        ],
                        "references": [
                          {
                            "url": "https://logging.apache.org/log4j/2.x/security.html"
                          }
                        ]
                      },
                      "adp": [
                        {
                          "providerMetadata": {
                            "orgId": "8254265b-2729-46b6-b9e3-3dfca2d5bfca",
                            "shortName": "VVD"
                          },
                          "title": "Vulnesis Vulnerability Database Enrichment",
                          "x_generatorVersion": "0.2.0",
                          "x_generatedAt": "2026-11-05T00:00:00Z",
                          "x_enrichmentSource": "Vulnesis Vulnerability Database",
                          "x_dataSource": "nist-nvd",
                          "x_dataCollected": [
                            "descriptions",
                            "affected",
                            "references",
                            "epss",
                            "kev"
                          ],
                          "x_epss": {
                            "score": 0.94358,
                            "percentile": 0.99957,
                            "date": "2026-11-04",
                            "modelVersion": "v2025.03.14"
                          },
                          "tags": [
                            "x_actively-exploited",
                            "x_critical-severity"
                          ]
                        }
                      ]
                    },
                    "x_links": [
                      {
                        "rel": "info",
                        "href": "/v2/info/CVE-2021-44228"
                      },
                      {
                        "rel": "kev",
                        "href": "/v2/vuln/CVE-2021-44228/kev"
                      }
                    ]
                  }
                ]
              }
            }
          },
          "404": {
            "description": "No record of the vulnerability (`identifier` echoes the normalised, alias-resolved id), or the caller's organisation was not found (middleware).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/VulnNotFoundBody"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "499": {
            "description": "The client closed the connection before the answer was ready.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "The records could not be read or built (`details` carries the database error).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "400": {
            "description": "The identifier is a purl, CPE, TEI or SWID tag that is malformed (`InputError`, `field` names the kind), or the identifier is empty (`ErrorBody`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "No valid credential (middleware), or a TEI that names a tenant release the caller cannot read (`InputError`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "413": {
            "description": "The identifier is over its size limit (512 characters, 64 KiB for a SWID tag).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "422": {
            "description": "A well-formed purl, CPE, TEI or SWID tag this API cannot resolve.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "503": {
            "description": "A dependency did not answer: the service is in maintenance, the database did not answer, or the transparency log behind a TEI could not be read (`InputError`). Retry after `Retry-After` seconds when it is set.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb vuln CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/advisories": {
      "get": {
        "operationId": "getVulnAdvisories",
        "tags": [
          "Remediation"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get vendor advisories for a vulnerability",
        "description": "Vendor remediation: solutions from every source's record, NVD vendor statements, Vulnesis's AI analysis, advisory references (at most 20), Microsoft products and KB updates (at most 100), Red Hat advisories with their products (at most 50 from Red Hat's records, 200 products each), and other vendors on the affected rows with their security pages.\n\nAnswers 404 when no source holds a record. Takes no query parameters.\n\nA purl, CPE, TEI or SWID tag in place of the id fans out under `results`.",
        "parameters": [
          {
            "$ref": "#/components/parameters/RemediationVulnIdentifier"
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/RemediationBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/RemediationUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/RemediationPayloadTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/RemediationUnprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/RemediationUnavailable"
          },
          "200": {
            "description": "OK, or a fan-out answer with one per vulnerability under `results`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/RemediationCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnAdvisoriesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnAdvisoriesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI remote code execution",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "vendorComments": [],
                  "solutions": [
                    {
                      "lang": "en",
                      "value": "Upgrade to Log4j 2.17.1 (Java 8), 2.12.4 (Java 7) or 2.3.2 (Java 6).",
                      "source": "cve.org",
                      "type": "cna"
                    }
                  ],
                  "aiAdvisory": null,
                  "descriptions": [],
                  "references": [
                    {
                      "url": "https://logging.apache.org/log4j/2.x/security.html",
                      "source": "cve.org"
                    }
                  ],
                  "msrcPatches": [],
                  "redhatAdvisories": [
                    {
                      "rhsaId": "RHSA-2021:5128",
                      "errataUrl": "https://access.redhat.com/errata/RHSA-2021:5128",
                      "title": "Important: log4j security update",
                      "products": [
                        {
                          "productName": "Red Hat Enterprise Linux 8",
                          "status": "fixed",
                          "vendor": "Red Hat"
                        }
                      ]
                    }
                  ],
                  "vendorPatches": []
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/RemediationVulnNotFound"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/advisories'"
          }
        ]
      }
    },
    "/vuln/{identifier}/affected": {
      "get": {
        "operationId": "listVulnAffected",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List the products a vulnerability affects",
        "description": "The affected products and version ranges every source gives for a vulnerability, with a purl for each, range strings, and (Pro) a generated CPE and cloud resource locator templates. When the sources list nothing the answer falls back to Microsoft's affected products, then the CISA KEV vendor and product, then cloud services named in the title.\n\nFilters (exact, case-insensitive): `ecosystem` against the ecosystem derived from the collection URL, both read through the shared ecosystem aliases (`docker` matches `oci`; `deb`, `rpm` and `apk`, which a collection URL never names, keep entries whose collection URL is not a known registry or names that distribution family), `vendor`, `product`, and `package` (or `packageName`) against the package name; a `purl` or a purl TEI sets ecosystem and package, a `cpe` sets vendor and product when neither is given. Paged in the server after filtering: `count` and `total` are both the filtered total.\n\n**Plans:** below Pro, `generatedCpe` and `cloudLocators` are null on every entry and listed in `_pro_data` and `_entitlements`. `cpes` carries only the CPEs the record lists itself; a CPE generated from vendor and product is given only in `generatedCpe`, so an entry with no CPEs of its own has no `cpes`.\n\nThe identifier is any advisory id (family prefix upper-cased, alias resolved); a purl, CPE, TEI or SWID tag answers once per resolved vulnerability under `results`, with the input passed to each run as the filters above.",
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "name": "packageName",
            "in": "query",
            "required": false,
            "deprecated": true,
            "description": "Alias of `package`; wins over it when both are given.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "log4j-core"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page. Default 100; a value above 500 is lowered to 500, and a value that is not a positive integer is replaced by the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip. Default 0. The handler sets no upper bound; this document bounds it at 100000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "A page of affected products; or, for a purl, CPE, TEI or SWID identifier, the fan-out envelope.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnAffectedResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnAffectedResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1793836800,
                  "count": 1,
                  "total": 1,
                  "limit": 100,
                  "offset": 0,
                  "hasMore": false,
                  "affected": [
                    {
                      "vendor": "apache",
                      "product": "log4j-core",
                      "packageName": "org.apache.logging.log4j:log4j-core",
                      "collectionURL": "https://repo.maven.apache.org/maven2",
                      "ecosystem": "maven",
                      "purl": "pkg:maven/org.apache.logging.log4j/log4j-core",
                      "cloudLocators": null,
                      "defaultStatus": "unaffected",
                      "cpes": [
                        "cpe:2.3:a:apache:log4j:*:*:*:*:*:*:*:*"
                      ],
                      "source": "github",
                      "versions": [
                        {
                          "version": "2.0-beta9",
                          "status": "affected",
                          "versionType": "maven",
                          "lessThan": "2.15.0",
                          "lessThanOrEqual": null
                        }
                      ],
                      "versionRange": ">=2.0-beta9 <2.15.0",
                      "versionRanges": [
                        ">=2.0-beta9 <2.15.0"
                      ]
                    }
                  ],
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "kev",
                      "href": "/v2/vuln/CVE-2021-44228/kev"
                    }
                  ],
                  "_pro_data": [
                    "$.affected[*].cloudLocators"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "full-enrichment",
                        "requiredPlan": "pro",
                        "paths": [
                          "$.affected[*].cloudLocators"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "500": {
            "description": "The affected-product query failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "The affected rows were cut short (`affected data temporarily unavailable`), the service is in maintenance, or the transparency log behind a TEI could not be read (`InputError`).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier is a purl, CPE, TEI or SWID tag that is malformed (`InputError`, `field` names the kind), or the identifier is empty (`ErrorBody`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "No valid credential (middleware), or a TEI that names a tenant release the caller cannot read (`InputError`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "413": {
            "description": "The identifier is over its size limit (512 characters, 64 KiB for a SWID tag).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "422": {
            "description": "A well-formed purl, CPE, TEI or SWID tag this API cannot resolve.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.affected[*].cloudLocators",
            "$.affected[*].generatedCpe",
            "$.results[*].affected[*].cloudLocators",
            "$.results[*].affected[*].generatedCpe"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/affected?ecosystem=maven'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb affected CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/affected-packages": {
      "get": {
        "operationId": "listVulnAffectedPackages",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List tracked packages a vulnerability affects",
        "description": "The distinct packages (name and ecosystem) a vulnerability affects that the package inventory tracks, so each can be passed to `/packages/safety-matrix`. Package names are matched case-insensitively; language ecosystems come first (npm, pypi, go, cargo, maven, nuget, rubygems, composer), then by name; at most 50.\n\nThe identifier is matched exactly as given (trimmed): it is not upper-cased or alias-resolved, so use the canonical id (`CVE-2021-44228`). A lookup that fails or takes over 8 seconds answers 500 (in a fan-out, that result carries `status` 500 and `error`). A purl, CPE, TEI or SWID tag answers once per resolved vulnerability under `results`. Returns package identity only; open to every plan.",
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          }
        ],
        "responses": {
          "200": {
            "description": "The packages; or, for a purl, CPE, TEI or SWID identifier, the fan-out envelope.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnAffectedPackagesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnAffectedPackagesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "cveId": "CVE-2021-44228",
                  "packages": [
                    {
                      "packageName": "org.apache.logging.log4j:log4j-core",
                      "ecosystem": "maven"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier is a purl, CPE, TEI or SWID tag that is malformed (`InputError`, `field` names the kind), or the identifier is empty (`ErrorBody`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "No valid credential (middleware), or a TEI that names a tenant release the caller cannot read (`InputError`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "413": {
            "description": "The identifier is over its size limit (512 characters, 64 KiB for a SWID tag).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "422": {
            "description": "A well-formed purl, CPE, TEI or SWID tag this API cannot resolve.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "503": {
            "description": "A dependency did not answer: the service is in maintenance, the database did not answer, or the transparency log behind a TEI could not be read (`InputError`). Retry after `Retry-After` seconds when it is set.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/affected-packages'"
          }
        ]
      }
    },
    "/vuln/{identifier}/attack-techniques": {
      "get": {
        "operationId": "listVulnAttackTechniques",
        "tags": [
          "Detection Rules"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List ATT&CK techniques for a vulnerability",
        "description": "Returns the MITRE ATT&CK techniques mapped to one vulnerability, with each technique's MITRE mitigations, detections and D3FEND counter-techniques, and the vulnerability's `state`, `title`, `aliases` and `_links`. Mappings from several sources are merged by technique id; the contributing sources are listed in `_sources`, and `derivedBy: \"vulnetix\"` marks an AI-derived mapping. Any advisory family is accepted. Not paged: every technique is returned, sorted by id, and `total` equals `count`. A vulnerability with no mapping answers 200 with an empty `attackTechniques`.\n\nGiven a purl, CPE, TEI or SWID tag in place of the id, the answer is the fan-out envelope with this route's answer for each resolved vulnerability (at most 50) under `results`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/attack-techniques'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb attack-techniques get CVE-2021-44228"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/DetectionVexIdentifier"
          }
        ],
        "responses": {
          "200": {
            "description": "The techniques mapped to the vulnerability, or the fan-out envelope for a purl, CPE, TEI or SWID identifier.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/DetectionVexCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/DetectionVexVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnAttackTechniquesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnAttackTechniquesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 1,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "attackTechniques": [
                    {
                      "id": "T1190",
                      "name": "Exploit Public-Facing Application",
                      "url": "https://attack.mitre.org/techniques/T1190/",
                      "domain": "Enterprise",
                      "subtechnique": false,
                      "tactics": [
                        "initial-access"
                      ],
                      "capecId": "CAPEC-136",
                      "_sources": [
                        "cve.org",
                        "nist-nvd"
                      ],
                      "mitigations": [
                        {
                          "id": "M1048",
                          "url": "https://attack.mitre.org/mitigations/M1048/",
                          "description": "Application isolation and least privilege limit the impact of an exploited service."
                        }
                      ],
                      "detections": [
                        {
                          "id": "DS0015",
                          "datasource": "Application Log",
                          "detects": "Application Log Content"
                        }
                      ],
                      "d3fend": [
                        {
                          "mitigationId": "M1048",
                          "id": "D3-EAL",
                          "url": "https://d3fend.mitre.org/technique/d3f:ExecutableAllowlisting/"
                        }
                      ]
                    }
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    },
                    {
                      "rel": "kev",
                      "href": "/v2/vuln/CVE-2021-44228/kev"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier is a purl, CPE, TEI or SWID tag that does not parse (`InputError`). When request validation runs in enforce mode (the `oas_validation_mode` flag), a query or path value outside this document's constraints is also a 400 `{error, field}`; in the default log mode it reaches the handler, which ignores or clamps it as described.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                },
                "example": {
                  "error": "purl: missing type",
                  "field": "purl"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DetectionVexUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/DetectionVexInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DetectionVexInputUnresolvable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/DetectionVexInternalError"
          },
          "503": {
            "$ref": "#/components/responses/DetectionVexUnavailable"
          }
        }
      }
    },
    "/vuln/{identifier}/countermeasures": {
      "get": {
        "operationId": "listVulnCountermeasures",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List countermeasures for a vulnerability",
        "description": "Detection content derived from the proof-of-concept exploits Vulnesis has ingested: Sigma rules, YARA rules, STIX 2.1 bundles and OpenIOC documents. These are what a SIEM, an EDR or a threat platform observes. Every defence names the exploit it was derived from.\n\nThe identifier is a vulnerability id of any advisory family (aliases are followed both ways), or in its place a URL-encoded purl, CPE or TEI; the answer then covers every vulnerability it resolves to, in one list. Any input kind in the query string narrows it further. A single advisory id also brings the advisory's `state`, `title`, `aliases` and `_links`.\n\n`limit` defaults to 100 and is clamped to 200.\n\n**Plans.** `count`, `total`, `byKind` and `resolved` are answered for every plan. The `countermeasures` list is Pro and above: below Pro it is `null`, and `_pro_data` and `_entitlements` (feature `countermeasures`) say so.",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "A vulnerability id of any advisory family, or a URL-encoded purl (`pkg:`), CPE (`cpe:`) or TEI (`urn:tei:`), or a base64 (or base64url) SWID tag. This route reads those kinds itself rather than fanning out: the answer is one list for everything they resolve to. Anything else is 400.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 4096,
              "pattern": "^(?:[A-Za-z][A-Za-z0-9.]{0,23}[-:/_][A-Za-z0-9][A-Za-z0-9._:/-]{0,200}|pkg:[A-Za-z][A-Za-z0-9.+-]{0,31}/[!-~]{1,480}|cpe:(?:2\\.3:|/)[!-~]{1,500}|urn(?::|%3[Aa])tei(?::|%3[Aa])[!-~]{1,490}|[A-Za-z0-9+/_-]{16,}={0,2})$"
            },
            "example": "CVE-2021-44228"
          },
          {
            "$ref": "#/components/parameters/DefenceLimit"
          },
          {
            "$ref": "#/components/parameters/DefenceOffset"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "The countermeasures linked to the vulnerabilities the identifier resolves to.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListVulnCountermeasuresResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 3,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "byKind": {
                    "SIGMA": 2,
                    "YARA": 1
                  },
                  "resolved": {
                    "kinds": [
                      "vulnId"
                    ],
                    "vulnIds": [
                      "CVE-2021-44228",
                      "GHSA-jfh8-c2jp-5v3q"
                    ]
                  },
                  "countermeasures": [
                    {
                      "uuid": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f",
                      "artifactId": "vulnetix-cm-5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73-sigma",
                      "kind": "SIGMA",
                      "title": "Log4Shell JNDI lookup in process command line",
                      "confidence": "HIGH",
                      "deployMode": "log",
                      "falsePositiveRisk": "LOW",
                      "mitreTechIds": [
                        "T1190"
                      ],
                      "rawText": "title: Log4Shell JNDI lookup in process command line\nlogsource:\n  category: process_creation\ndetection:\n  selection:\n    CommandLine|contains: '${jndi:'\n  condition: selection\n",
                      "fileSize": 176,
                      "exploitUuid": "5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73",
                      "exploitId": "50592",
                      "exploitSource": "exploit-db",
                      "matchedCve": "CVE-2021-44228",
                      "archiveUrl": "/v2/countermeasures/9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f/archive",
                      "consoleUrl": "https://www.vulnes.is/resolve/countermeasures?dc=9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f#catalogue",
                      "createdAt": "2025-02-11T08:14:03Z",
                      "updatedAt": "2025-03-02T17:40:55Z"
                    }
                  ],
                  "identifier": "CVE-2021-44228",
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "_links": [
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    },
                    {
                      "rel": "exploits",
                      "href": "/v2/exploits/CVE-2021-44228"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier is none of the accepted kinds (`{error, examples}`), or an input is malformed (`InputError`, `field` names it).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/DefenceIdentifierError"
                    },
                    {
                      "$ref": "#/components/schemas/InputError"
                    }
                  ]
                },
                "example": {
                  "error": "Invalid identifier. Use a vulnerability id, a purl, a CPE, a TEI or a SWID tag.",
                  "examples": "CVE-2021-44228, GHSA-jfh8-c2jp-5v3q, pkg:npm/lodash@4.17.20, cpe:2.3:a:apache:log4j:2.14.1:*:*:*:*:*:*:*, urn:tei:purl:vulnes.is:pkg:npm/lodash@4.17.20"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DefenceInputUnauthorized"
          },
          "413": {
            "$ref": "#/components/responses/DefenceInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DefenceInputUnresolvable"
          },
          "503": {
            "$ref": "#/components/responses/DefenceInputUnavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "countermeasures",
          "gatedFields": [
            "$.countermeasures"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/countermeasures'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb countermeasures get CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/cwe-guidance": {
      "get": {
        "operationId": "getVulnCweGuidance",
        "tags": [
          "Remediation"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get CWE remediation guidance for a vulnerability",
        "description": "The weaknesses (CWEs) the vulnerability is classified under, each with remediation guidance for that class of bug, the record's CAPEC attack patterns and the ATT&CK techniques inferred from its weaknesses and references.\n\nAn id with no weakness rows, or an unknown id, answers 200 with `cwes: []`; this route never answers 404 for the vulnerability. It takes no query parameters.\n\nA purl, CPE, TEI or SWID tag in place of the id fans out under `results`.",
        "parameters": [
          {
            "$ref": "#/components/parameters/RemediationVulnIdentifier"
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/RemediationBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/RemediationUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/RemediationPayloadTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/RemediationUnprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/RemediationUnavailable"
          },
          "200": {
            "description": "OK, or a fan-out answer with one per vulnerability under `results`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/RemediationCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnCweGuidanceResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnCweGuidanceResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI remote code execution",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "cwes": [
                    {
                      "cweId": "CWE-502",
                      "name": "CWE-502 Deserialization of Untrusted Data",
                      "source": "cve.org",
                      "guidance": "## Deserialization of Untrusted Data\n\n### What is this vulnerability?\nThe application deserializes data from untrusted sources without validation...",
                      "attackTechniques": [
                        {
                          "techniqueId": "T1203",
                          "relationship": "EXPLOITS"
                        },
                        {
                          "techniqueId": "T1190",
                          "relationship": "EXPLOITS"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/cwe-guidance'"
          }
        ]
      }
    },
    "/vuln/{identifier}/exploits": {
      "get": {
        "operationId": "listVulnExploits",
        "tags": [
          "Exploit Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List archived exploit files for a vulnerability",
        "description": "Lists the exploit files Vulnesis holds a stored copy of for one vulnerability, newest first. Every row is downloadable: fetch `archiveUrl` for the bytes and `archiveMetaUrl` for the storage metadata (both Pro). The list is not paged; `count` and `total` are equal. For every exploit reference, sighting and KEV record use `GET /exploits/{identifier}`.\n\n**Plans.** Every plan gets `count`, `total` and the record envelope. Below Pro, `exploits` (and `results[*].exploits` in a fan-out) is null and listed in `_pro_data` and `_entitlements`.",
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/ExploitKevInputUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ExploitKevInputUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/ExploitKevInputBadRequest"
          },
          "413": {
            "$ref": "#/components/responses/ExploitKevInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/ExploitKevInputUnresolvable"
          },
          "200": {
            "description": "The archived files, or the fan-out envelope for a purl, CPE, TEI or SWID identifier.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`: the answer depends on the caller's plan, so it is never stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnExploitsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnExploitsResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 1,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "exploits": [
                    {
                      "uuid": "6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b",
                      "exploitId": "kozmer/log4j-shell-poc",
                      "source": "github",
                      "title": "log4j-shell-poc",
                      "isArchive": true,
                      "filename": "poc.py",
                      "fileSize": 4321,
                      "bodyContentHash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
                      "originalUrl": "https://github.com/kozmer/log4j-shell-poc",
                      "datePublished": "2021-12-12T00:00:00Z",
                      "platform": "java",
                      "hasArchive": true,
                      "archiveUrl": "/v2/exploits/6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b/archive",
                      "archiveMetaUrl": "/v2/exploits/6e1f0c2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b/archive/meta",
                      "createdAt": 1639353600000
                    }
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    }
                  ]
                }
              }
            }
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.exploits",
            "$.results[*].exploits"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/exploits'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb exploits archived CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/fixes/distributions": {
      "get": {
        "operationId": "listVulnDistributionPatches",
        "tags": [
          "Remediation"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List Linux distribution patches for a vulnerability",
        "description": "Linux distribution patches: first the advisory references on the record (Ubuntu USN, Debian DSA, Red Hat RHSA, AlmaLinux ALSA, Alpine, openSUSE, Rocky RLSA), each once; then distributions named only as a vendor on affected rows (Chainguard, Wolfi, TuxCare...), with an empty `advisoryId` and the tracker URL.\n\nFilter with `distro` (or `os`, which fills it). Page with `limit` (default 100, max 500) and `offset`; `count` equals `total`. Package context is ignored.\n\nA purl, CPE, TEI or SWID tag in place of the id fans out under `results`.",
        "parameters": [
          {
            "$ref": "#/components/parameters/RemediationVulnIdentifier"
          },
          {
            "name": "distro",
            "in": "query",
            "required": false,
            "description": "Only patches for this distribution (matched ignoring case).",
            "schema": {
              "$ref": "#/components/schemas/RemediationDistroKey"
            },
            "example": "ubuntu"
          },
          {
            "$ref": "#/components/parameters/RemediationOs",
            "description": "Its distribution fills `distro` when unset; `amzn` and `opensuse` match no patch."
          },
          {
            "$ref": "#/components/parameters/RemediationLimit"
          },
          {
            "$ref": "#/components/parameters/RemediationOffset"
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/RemediationBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/RemediationUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/RemediationPayloadTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/RemediationUnprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/RemediationUnavailable"
          },
          "200": {
            "description": "OK, or a fan-out answer with one per vulnerability under `results`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/RemediationCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnDistributionPatchesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnDistributionPatchesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI remote code execution",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "count": 1,
                  "total": 1,
                  "limit": 100,
                  "offset": 0,
                  "hasMore": false,
                  "patches": [
                    {
                      "distro": "chainguard",
                      "displayName": "Chainguard",
                      "advisoryId": "",
                      "advisoryUrl": "https://images.chainguard.dev/security/CVE-2021-44228",
                      "source": "osv",
                      "purl": "pkg:chainguard/chainguard/log4j",
                      "affectedPackages": [
                        {
                          "vendor": "Chainguard",
                          "product": "log4j"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/fixes/distributions?os=ubuntu-22.04'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb fixes CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/fixes/registry": {
      "get": {
        "operationId": "listVulnRegistryFixes",
        "tags": [
          "Remediation"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List registry fixes for a vulnerability",
        "description": "Fixed releases in package registries, one per affected package with a fixed version, with its purl and how firmly registry data confirms it.\n\nFilter with `ecosystem` and `packageName` (or `package`, or a `purl` or purl `tei` that fills them), exact and case-insensitive. `ecosystem` is matched against the value derived from the record's collection URL (npm, pypi, cargo, gem, nuget, composer, golang, maven, hex, pub, oci, helm, github), with both read through the shared ecosystem aliases, so `docker` matches `oci`, `crates.io` matches `cargo` and `go` matches `golang`. A collection URL never names an OS distribution, so `deb`, `rpm` and `apk` (from a `pkg:deb/`, `pkg:rpm/` or `pkg:apk/` purl) keep records whose collection URL is not a known registry, or names that distribution family; the package name still filters. Other package context is ignored. Page with `limit` (default 100, max 500) and `offset`; `count` equals `total`.\n\nA purl, CPE, TEI or SWID tag in place of the id fans out under `results` (at most 50, known-exploited first), its package filling `ecosystem` and `packageName` unless set.\n\n**Plans:** `fixes[*].registryVerification` is Pro and above; below Pro it is null and listed in `_pro_data` and `_entitlements` (under `results[*]` on a fan-out).",
        "parameters": [
          {
            "$ref": "#/components/parameters/RemediationVulnIdentifier"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem",
            "description": "Only fixes in this ecosystem, compared after both sides are read through the shared ecosystem aliases (so `docker` matches `oci`). `deb`, `rpm` and `apk` keep records whose collection URL is not a known registry."
          },
          {
            "$ref": "#/components/parameters/RemediationPackageName"
          },
          {
            "$ref": "#/components/parameters/InputPackage",
            "description": "Alias of `packageName`."
          },
          {
            "$ref": "#/components/parameters/InputPURL",
            "description": "Its type and name fill `ecosystem` and `packageName` when unset."
          },
          {
            "$ref": "#/components/parameters/InputTEI",
            "description": "A purl TEI (`urn:tei:purl:...`), read like `purl`; other TEI types are ignored."
          },
          {
            "$ref": "#/components/parameters/RemediationLimit"
          },
          {
            "$ref": "#/components/parameters/RemediationOffset"
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/RemediationBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/RemediationUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/RemediationPayloadTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/RemediationUnprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/RemediationUnavailable"
          },
          "200": {
            "description": "OK, or a fan-out answer with one per vulnerability under `results`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/RemediationCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnRegistryFixesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnRegistryFixesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI remote code execution",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "count": 1,
                  "total": 1,
                  "limit": 100,
                  "offset": 0,
                  "hasMore": false,
                  "fixes": [
                    {
                      "ecosystem": "maven",
                      "displayName": "Maven Central",
                      "registryKey": "maven",
                      "registryUrl": "https://repo.maven.apache.org/maven2",
                      "packageName": "org.apache.logging.log4j:log4j-core",
                      "purl": "pkg:generic/org.apache.logging.log4j:log4j-core@2.15.0",
                      "fixedVersions": [
                        "2.15.0"
                      ],
                      "affectedRange": {
                        "version": "2.0-beta9",
                        "status": "affected",
                        "versionType": "maven",
                        "lessThan": "2.15.0",
                        "lessThanOrEqual": null
                      },
                      "verified": true,
                      "confidence": "high",
                      "registryVerification": null
                    }
                  ],
                  "_pro_data": [
                    "$.fixes[*].registryVerification"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "full-enrichment",
                        "requiredPlan": "pro",
                        "paths": [
                          "$.fixes[*].registryVerification"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.fixes[*].registryVerification",
            "$.results[*].fixes[*].registryVerification"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/fixes/registry?ecosystem=maven'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb fixes CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/fixes/source": {
      "get": {
        "operationId": "listVulnSourceFixes",
        "tags": [
          "Remediation"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List upstream source fixes for a vulnerability",
        "description": "Upstream code references: GitHub fix commits and pull requests, plus gists, Exploit-DB and Vulnerability Lab entries from the same reference table. A commit or PR means building from source until a release ships (`buildFromSourceRequired`).\n\nChoose kinds with `type` (default all). Page with `limit` (default 100, max 500) and `offset`; `count` equals `total`. Package context is ignored.\n\nA purl, CPE, TEI or SWID tag in place of the id fans out under `results`.",
        "parameters": [
          {
            "$ref": "#/components/parameters/RemediationVulnIdentifier"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Kinds to list. Default `all`; another value answers no fixes.",
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "commit",
                "pr",
                "gist",
                "exploit_db",
                "vulnerability_lab"
              ],
              "default": "all"
            },
            "example": "commit"
          },
          {
            "$ref": "#/components/parameters/RemediationLimit"
          },
          {
            "$ref": "#/components/parameters/RemediationOffset"
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/RemediationBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/RemediationUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/RemediationPayloadTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/RemediationUnprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/RemediationUnavailable"
          },
          "200": {
            "description": "OK, or a fan-out answer with one per vulnerability under `results`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/RemediationCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnSourceFixesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnSourceFixesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI remote code execution",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "count": 1,
                  "total": 1,
                  "limit": 100,
                  "offset": 0,
                  "hasMore": false,
                  "fixes": [
                    {
                      "type": "pr",
                      "url": "https://github.com/apache/logging-log4j2/pull/608",
                      "diffUrl": "https://github.com/apache/logging-log4j2/pull/608.diff",
                      "mergedAt": 1638831600,
                      "mergeCommitSha": "c77b3cb39312b83b053d23a2158b99ac7de44dd3",
                      "prState": "closed",
                      "buildFromSourceRequired": true
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/fixes/source?type=commit'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb fixes CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/iocs": {
      "get": {
        "operationId": "getVulnIocs",
        "tags": [
          "Threat Activity"
        ],
        "summary": "Get IOC pivots for a vulnerability",
        "description": "The CrowdSec sightings of a vulnerability, one row per source IP (AS, geolocation, behaviours, MITRE techniques, first and last seen), newest first, plus a Shadowserver summary (host counts over 1, 7, 30 and 90 days and the top ten source countries).\n\nAt most 200 sightings are returned and there is no paging: `count` and `total` are both the number returned. Aliases are followed, so a GHSA id answers for its CVE.\n\n**Plans.** Below Pro, `sightings` and `shadowserver` are null and listed in `_pro_data` and `_entitlements`; `count`, `total` and the record envelope stay.\n\nNamed by a purl, CPE, TEI or SWID tag, the answer is the fan-out envelope with this answer per resolved vulnerability under `results`.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.sightings",
            "$.shadowserver",
            "$.results[*].sightings",
            "$.results[*].shadowserver"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/iocs'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb iocs get CVE-2021-44228"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/ThreatActivityInputUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ThreatActivityInputUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/ThreatActivityInputBadRequest"
          },
          "413": {
            "$ref": "#/components/responses/ThreatActivityInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/ThreatActivityInputUnresolvable"
          },
          "200": {
            "description": "The sightings and Shadowserver summary, or the fan-out envelope.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/ThreatActivityCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnIocsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnIocsResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 1,
                  "sightings": [
                    {
                      "uuid": "0b6f7d1e-6a43-4c55-9d0e-2f1a7c3e9b10",
                      "cveId": "CVE-2021-44228",
                      "source": "crowdsec",
                      "ip": "203.0.113.24",
                      "reputation": "malicious",
                      "confidence": "high",
                      "backgroundNoiseScore": 8,
                      "asNum": 14061,
                      "asName": "DIGITALOCEAN-ASN",
                      "country": "US",
                      "city": "North Bergen",
                      "lat": 40.79,
                      "lon": -74.02,
                      "behaviors": [
                        "http:exploit",
                        "http:scan"
                      ],
                      "classifications": [
                        "scanner:log4j"
                      ],
                      "mitreTechniques": [
                        "T1190"
                      ],
                      "firstSeen": "2025-10-02T08:14:00Z",
                      "lastSeen": "2025-11-04T22:51:00Z",
                      "falsePositivesCount": 0
                    }
                  ],
                  "shadowserver": {
                    "count1d": 412,
                    "count7dAvg": 388.6,
                    "count30dAvg": 401.2,
                    "count90dAvg": 455.9,
                    "topCountries": [
                      {
                        "country": "US",
                        "countryName": "United States",
                        "count": 1204
                      }
                    ],
                    "lastObservationDate": "2025-11-04T00:00:00Z"
                  },
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "sightings",
                      "href": "/v2/vuln/CVE-2021-44228/sightings"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/vuln/{identifier}/kev": {
      "get": {
        "operationId": "getVulnKev",
        "tags": [
          "KEV"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get KEV status for a vulnerability",
        "description": "Returns one vulnerability's entries in the CISA, ENISA and Vulnesis KEV catalogues (newest first, with due dates and overdue status), its VulnCheck KEV entries with their reported exploitations and XDB exploits, a CrowdSec sighting summary, and a summary of the exploitation signals. `inKev` is true when any catalogue, VulnCheck included, lists it. An unknown vulnerability answers 200 with no entries. A catalogue row whose `knownRansomwareCampaignUse` is unset is currently left out of `entries` (a known defect).\n\n**Plans.** Every plan gets `inKev` and `entries`. Below Pro, `vulnCheckKev`, `crowdSecSummary` and `exploitationSignals` (and their `results[*]` mirrors in a fan-out) are null and listed in `_pro_data` and `_entitlements`.",
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/ExploitKevInputUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The KEV query failed, or an unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/ExploitKevInputUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/ExploitKevInputBadRequest"
          },
          "413": {
            "$ref": "#/components/responses/ExploitKevInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/ExploitKevInputUnresolvable"
          },
          "200": {
            "description": "The KEV status, or the fan-out envelope for a purl, CPE, TEI or SWID identifier.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "`private, no-store`: the answer depends on the caller's plan, so it is never stored by a shared cache.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnKevResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnKevResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "inKev": true,
                  "entries": [
                    {
                      "source": "CISA",
                      "vendorProject": "Apache",
                      "product": "Log4j2",
                      "vulnerabilityName": "Apache Log4j2 Remote Code Execution Vulnerability",
                      "requiredAction": "Apply updates per vendor instructions.",
                      "dateAdded": "2021-12-10T00:00:00Z",
                      "dueDate": "2021-12-24T00:00:00Z",
                      "overdue": true,
                      "daysUntilDue": -1777,
                      "knownRansomwareCampaignUse": "Known",
                      "cwes": [
                        "CWE-20",
                        "CWE-400",
                        "CWE-502"
                      ],
                      "notes": null
                    }
                  ],
                  "vulnCheckKev": [
                    {
                      "kevId": "4b0f6a1e-2c3d-4e5f-9a8b-7c6d5e4f3a2b",
                      "reportedExploitations": [
                        {
                          "url": "https://www.cisa.gov/news-events/cybersecurity-advisories/aa21-356a",
                          "dateAdded": 1640131200000
                        }
                      ],
                      "xdbEntries": [
                        {
                          "xdbId": "a1b2c3d4e5f6",
                          "xdbUrl": "https://vulncheck.com/xdb/a1b2c3d4e5f6",
                          "exploitType": "initial-access"
                        }
                      ]
                    }
                  ],
                  "crowdSecSummary": {
                    "totalSightings": 380,
                    "uniqueIPs": 214,
                    "isActive": false,
                    "firstSeen": "1639180800000",
                    "lastSeen": "1762204440000",
                    "topSourceCountries": [
                      "US",
                      "NL"
                    ],
                    "mitreTechniques": [
                      "T1190"
                    ],
                    "behaviors": [
                      "http:exploit"
                    ]
                  },
                  "exploitationSignals": {
                    "inCisaKev": true,
                    "inVulnCheckKev": true,
                    "crowdSecActive": false,
                    "totalExploitSources": 2,
                    "summary": "Actively exploited with 380 honeypot sightings across 214 unique IPs"
                  },
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    }
                  ]
                }
              }
            }
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.exploitationSignals",
            "$.crowdSecSummary",
            "$.vulnCheckKev",
            "$.results[*].exploitationSignals",
            "$.results[*].crowdSecSummary",
            "$.results[*].vulnCheckKev"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/kev'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb kev get CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/nuclei": {
      "get": {
        "operationId": "listVulnNucleiTemplates",
        "tags": [
          "Exploit Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List Nuclei templates for a vulnerability",
        "description": "Lists the ProjectDiscovery Nuclei templates that target one vulnerability, with GitHub and raw URLs. An unknown vulnerability or one with no template answers 200 with `count: 0`.\n\n`format=yaml` returns template bodies fetched from GitHub instead, ready to pipe into `nuclei -t -`: the single template when there is exactly one or `first=true` is set (502 when GitHub cannot be reached; `X-Vulnetix-Source-URL` names it), otherwise every template concatenated as YAML documents separated by `---`, each headed `# Vulnesis: <path>` (a template that cannot be fetched becomes a `# fetch failed` comment). With `format=yaml` and no template the answer is 404 with a one-line text body. Any `format` other than `yaml` returns JSON. In a fan-out (purl, CPE, TEI or SWID identifier) only the JSON listing is meaningful.\n\nNot plan-gated.",
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "`yaml` returns template bodies; anything else returns the JSON listing. Case-insensitive.",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "yaml",
                "JSON",
                "YAML"
              ],
              "default": "json"
            },
            "example": "yaml"
          },
          {
            "name": "first",
            "in": "query",
            "required": false,
            "description": "With `format=yaml`, `true` returns only the first template (by path). Any other value returns all of them.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ],
              "default": "false"
            },
            "example": "true"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/ExploitKevInputUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "With `format=yaml`: no template is on file (text body). Otherwise: the caller's organisation was not found.",
            "content": {
              "text/plain; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                },
                "example": "# No nuclei templates on file for this CVE.\n"
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The template query failed, or an unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/ExploitKevInputUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/ExploitKevInputBadRequest"
          },
          "413": {
            "$ref": "#/components/responses/ExploitKevInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/ExploitKevInputUnresolvable"
          },
          "200": {
            "description": "The JSON listing (or the fan-out envelope), or with `format=yaml` the template bodies.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Vulnetix-Source-URL": {
                "description": "With `format=yaml` and a single template: the raw GitHub URL it was fetched from.",
                "schema": {
                  "type": "string",
                  "maxLength": 2048
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnNucleiTemplatesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnNucleiTemplatesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 1,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "templates": [
                    {
                      "path": "http/cves/2021/CVE-2021-44228.yaml",
                      "rawUrl": "https://raw.githubusercontent.com/projectdiscovery/nuclei-templates/main/http/cves/2021/CVE-2021-44228.yaml",
                      "url": "https://github.com/projectdiscovery/nuclei-templates/blob/main/http/cves/2021/CVE-2021-44228.yaml"
                    }
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    }
                  ]
                }
              },
              "application/yaml": {
                "schema": {
                  "type": "string",
                  "maxLength": 104857600
                },
                "example": "id: CVE-2021-44228\n\ninfo:\n  name: Apache Log4j2 - Remote Code Injection\n  severity: critical\n"
              }
            }
          },
          "502": {
            "description": "With `format=yaml` and a single template: GitHub did not return it.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "error",
                    "detail"
                  ],
                  "properties": {
                    "error": {
                      "type": "string",
                      "maxLength": 256
                    },
                    "detail": {
                      "type": "string",
                      "maxLength": 2048
                    }
                  }
                },
                "example": {
                  "error": "Failed to fetch nuclei template body upstream.",
                  "detail": "upstream 404"
                }
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/nuclei'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb nuclei get CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/remediation-plan": {
      "get": {
        "operationId": "getVulnRemediationPlan",
        "tags": [
          "Remediation"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get a remediation plan for a vulnerability",
        "description": "A prioritised plan for one vulnerability: severity and exploitation signals, an SSVC decision, fix availability, ordered `actions` (upgrade, patch, source fix, workaround or monitor) and the datasets behind them.\n\n**Context.** `ecosystem` and `packageName` (or `package`, or a `purl`) filter `registryFixes` and upgrade actions; `packageManager` picks the upgrade command. `currentVersion` (or `version`, or a `purl` or `cpe` version) is echoed in `context`. `os` and `containerImage` narrow `distributionPatches`. `includeGuidance=true` fills `guidance`; `includeVerificationSteps=true` adds `verification` to upgrade actions. `vendor`, `product` and `registry` are ignored.\n\n**SSVC.** An organisation's stored SSVC policy decides (for the repository in `repo`, if given) and adds its keys to `ssvc`; otherwise the default ladder decides.\n\n`channelActions` has five empty channels today and `versionComparison` is never emitted; use `actions`. Plans are cached for 5 minutes per id and query (`X-Cache`). Answers 404 when no source holds a record.\n\nA purl, CPE, TEI or SWID tag in place of the id fans out under `results` (at most 50), its package filling `ecosystem`, `packageName` and `currentVersion` unless set.\n\n**Plans:** `registryFixes[*].registryVerification`, `crowdSecSummary` and `exploitationSignals` are Pro and above; below Pro they are null and listed in `_pro_data` and `_entitlements` (under `results[*]` on a fan-out).",
        "parameters": [
          {
            "$ref": "#/components/parameters/RemediationVulnIdentifier"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem",
            "description": "Only registry fixes in this ecosystem (exact, ignoring case)."
          },
          {
            "$ref": "#/components/parameters/RemediationPackageName"
          },
          {
            "$ref": "#/components/parameters/InputPackage",
            "description": "Alias of `packageName`."
          },
          {
            "name": "packageManager",
            "in": "query",
            "required": false,
            "description": "Package manager for upgrade commands (yarn, pnpm, poetry...); else the ecosystem default.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 32,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,31}$"
            },
            "example": "yarn"
          },
          {
            "$ref": "#/components/parameters/RemediationCurrentVersion",
            "description": "The version you run; echoed in `context`. Alias `version`."
          },
          {
            "$ref": "#/components/parameters/InputVersion",
            "description": "Alias of `currentVersion`."
          },
          {
            "$ref": "#/components/parameters/InputPURL",
            "description": "Fills `ecosystem`, `packageName` and `currentVersion` when unset; echoed in `context.purl`."
          },
          {
            "$ref": "#/components/parameters/InputCPE",
            "description": "Its version fills `currentVersion` when unset; vendor and product are ignored."
          },
          {
            "$ref": "#/components/parameters/RemediationOs",
            "description": "Narrows `distributionPatches` to the distribution; echoed in `context.matchedDistro`."
          },
          {
            "name": "containerImage",
            "in": "query",
            "required": false,
            "description": "`[registry/]repository[:tag][@digest]`; a base-OS tag narrows `distributionPatches`. Echoed in `context.matchedContainer`.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._/:@-]{0,511}$"
            },
            "example": "eclipse-temurin:17-jre-jammy"
          },
          {
            "name": "topology",
            "in": "query",
            "required": false,
            "description": "Tunes `channelActions` wording (empty today, so no effect yet). Case-insensitive; other values are `unknown`.",
            "schema": {
              "type": "string",
              "enum": [
                "single-host",
                "cluster",
                "serverless",
                "unknown"
              ],
              "default": "unknown"
            },
            "example": "cluster"
          },
          {
            "name": "includeGuidance",
            "in": "query",
            "required": false,
            "description": "Only the exact string `true` fills `guidance`.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ],
              "default": "false"
            },
            "example": "true"
          },
          {
            "name": "includeVerificationSteps",
            "in": "query",
            "required": false,
            "description": "Only the exact string `true` adds `verification` to upgrade actions.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ],
              "default": "false"
            },
            "example": "true"
          },
          {
            "name": "repo",
            "in": "query",
            "required": false,
            "description": "Repository (`owner/name`) whose criticality feeds your organisation's SSVC policy. Ignored over 512 characters.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._/:-]{0,511}$"
            },
            "example": "acme/payments-api"
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/RemediationBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/RemediationUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/RemediationPayloadTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/RemediationUnprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/RemediationUnavailable"
          },
          "200": {
            "description": "OK, or a fan-out answer with one per vulnerability under `results`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Cache": {
                "$ref": "#/components/headers/RemediationXCache"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/RemediationCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnRemediationPlanResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnRemediationPlanResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI remote code execution",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "description": "Apache Log4j2 JNDI features do not protect against attacker controlled endpoints.",
                  "descriptions": [],
                  "context": {
                    "ecosystem": "maven",
                    "packageName": "org.apache.logging.log4j:log4j-core",
                    "currentVersion": "2.14.1",
                    "purl": "",
                    "matchedDistro": null,
                    "matchedContainer": null
                  },
                  "severity": {
                    "cvssScore": 10.0,
                    "cvssVector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H",
                    "baseSeverity": "CRITICAL",
                    "epssScore": 0.9447,
                    "epssPercentile": 0.9998,
                    "cessScore": null,
                    "inKev": true,
                    "kevDueDate": "2021-12-24T00:00:00Z",
                    "exploitationMaturity": {
                      "score": 88,
                      "level": "WIDESPREAD",
                      "confidence": "VERY_HIGH",
                      "factors": {
                        "epss": 0.9447,
                        "cess": null,
                        "kevPresence": true,
                        "exploitDbCount": 3,
                        "metasploitCount": 0,
                        "nucleiCount": 2,
                        "crowdSecSightings": 0,
                        "githubExploits": 0,
                        "vulnCheckXDB": 0
                      },
                      "reasoning": "Listed in CISA KEV; EPSS 94.5%"
                    },
                    "cvssDetails": {
                      "attackVector": "NETWORK",
                      "attackComplexity": "LOW",
                      "privilegesRequired": "NONE",
                      "userInteraction": "NONE",
                      "scope": "CHANGED",
                      "confidentialityImpact": "HIGH",
                      "integrityImpact": "HIGH",
                      "availabilityImpact": "HIGH"
                    }
                  },
                  "ssvc": {
                    "decision": "Act",
                    "priority": "immediate",
                    "exploitation": "ACTIVE",
                    "automatable": "YES",
                    "technicalImpact": "TOTAL"
                  },
                  "fixAvailability": "registry_available",
                  "actions": [
                    {
                      "priority": 1,
                      "type": "upgrade",
                      "title": "Upgrade org.apache.logging.log4j:log4j-core to 2.15.0",
                      "description": "A fixed version is available via maven registry.",
                      "effort": "low",
                      "impact": "complete_fix",
                      "steps": [
                        "Update org.apache.logging.log4j:log4j-core version to 2.15.0 in pom.xml, then run: mvn clean install",
                        "mvn org.owasp:dependency-check-maven:check",
                        "Run your test suite to ensure compatibility"
                      ],
                      "fix": {
                        "ecosystem": "maven",
                        "packageName": "org.apache.logging.log4j:log4j-core",
                        "fixedVersion": "2.15.0",
                        "purl": "pkg:generic/org.apache.logging.log4j:log4j-core@2.15.0"
                      },
                      "buildFromSourceRequired": false
                    }
                  ],
                  "guidance": "",
                  "timeline": {
                    "datePublished": "2021-12-10T00:00:00Z",
                    "currentAgeDays": 1426,
                    "lifecycleStage": "LEGACY",
                    "kevDaysOverdue": 1412
                  },
                  "references": [],
                  "relatedCves": null,
                  "registryFixes": [
                    {
                      "ecosystem": "maven",
                      "displayName": "Maven Central",
                      "registryKey": "maven",
                      "registryUrl": "https://repo.maven.apache.org/maven2",
                      "packageName": "org.apache.logging.log4j:log4j-core",
                      "purl": "pkg:generic/org.apache.logging.log4j:log4j-core@2.15.0",
                      "fixedVersions": [
                        "2.15.0"
                      ],
                      "affectedRange": {
                        "version": "2.0-beta9",
                        "status": "affected",
                        "versionType": "maven",
                        "lessThan": "2.15.0",
                        "lessThanOrEqual": null
                      },
                      "verified": true,
                      "confidence": "high",
                      "registryVerification": null
                    }
                  ],
                  "sourceFixes": [],
                  "distributionPatches": [],
                  "workarounds": [],
                  "configurations": [],
                  "solutions": [],
                  "vendorComments": [],
                  "aiAdvisory": null,
                  "advisoryReferences": [],
                  "cwes": [],
                  "kevEntries": [
                    {
                      "source": "CISA",
                      "vendorProject": "Apache",
                      "product": "Log4j2",
                      "vulnerabilityName": "Apache Log4j2 RCE",
                      "requiredAction": "Apply updates.",
                      "dateAdded": "2021-12-10T00:00:00Z",
                      "dueDate": "2021-12-24T00:00:00Z",
                      "overdue": true,
                      "daysUntilDue": -1413,
                      "knownRansomwareCampaignUse": "Known",
                      "notes": null
                    }
                  ],
                  "vulnCheckKev": [],
                  "exploitationSignals": null,
                  "crowdSecSummary": null,
                  "msrcAdvisory": null,
                  "redhatAdvisories": [],
                  "snortRules": [],
                  "snortRuleCount": 0,
                  "channelActions": {
                    "registry": [],
                    "source": [],
                    "distro": [],
                    "vendor": [],
                    "cloud": []
                  },
                  "_pro_data": [
                    "$.registryFixes[*].registryVerification",
                    "$.crowdSecSummary",
                    "$.exploitationSignals"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "full-enrichment",
                        "requiredPlan": "pro",
                        "paths": [
                          "$.registryFixes[*].registryVerification",
                          "$.crowdSecSummary",
                          "$.exploitationSignals"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/RemediationVulnNotFound"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.registryFixes[*].registryVerification",
            "$.crowdSecSummary",
            "$.exploitationSignals",
            "$.vulnCheckKev",
            "$.results[*].registryFixes[*].registryVerification",
            "$.results[*].crowdSecSummary",
            "$.results[*].exploitationSignals",
            "$.results[*].vulnCheckKev"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/remediation-plan?ecosystem=maven&currentVersion=2.14.1&includeGuidance=true'"
          }
        ]
      }
    },
    "/vuln/{identifier}/scorecard": {
      "get": {
        "operationId": "getVulnScorecard",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get OpenSSF Scorecards for a vulnerability",
        "description": "The OpenSSF Scorecard runs linked to a vulnerability's source records, each with its checks, plus stored fix-commit and pull-request repository health and whether a fix commit lies in a scorecarded repository. An id with no scorecards answers 200 with an empty list; there is no 404, and a failed lookup also reads as empty.\n\nThe identifier is any advisory id (family prefix upper-cased, alias resolved); a purl, CPE, TEI or SWID tag answers once per resolved vulnerability under `results`. Open to every plan.",
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          }
        ],
        "responses": {
          "200": {
            "description": "The scorecards; or, for a purl, CPE, TEI or SWID identifier, the fan-out envelope.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnScorecardResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnScorecardResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1793836800,
                  "scorecards": [
                    {
                      "repository": "github.com/apache/logging-log4j2",
                      "overallScore": 7.4,
                      "date": "2026-10-28T00:00:00Z",
                      "repositoryCommit": "3f1e2a9c4b5d6e7f8091a2b3c4d5e6f708192a3b",
                      "scorecardVersion": "v5.0.0",
                      "checks": [
                        {
                          "name": "Maintained",
                          "score": 10,
                          "reason": "30 commit(s) and 12 issue activity found in the last 90 days -- score normalized to 10",
                          "shortDescription": "Determines if the project is \"actively maintained\".",
                          "documentationUrl": "https://github.com/ossf/scorecard/blob/main/docs/checks.md#maintained"
                        }
                      ]
                    }
                  ],
                  "total": 1,
                  "commitHealth": null,
                  "prRepoHealth": null,
                  "sourceFixCorrelation": {
                    "hasFixCommit": true,
                    "fixCommitSha": "c77b3cb39312b83b053d23a2158b99ac7de44dd3",
                    "fixCommitInScorecardRepo": false,
                    "scorecardScoreAtFixTime": null
                  },
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "kev",
                      "href": "/v2/vuln/CVE-2021-44228/kev"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier is a purl, CPE, TEI or SWID tag that is malformed (`InputError`, `field` names the kind), or the identifier is empty (`ErrorBody`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "No valid credential (middleware), or a TEI that names a tenant release the caller cannot read (`InputError`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "413": {
            "description": "The identifier is over its size limit (512 characters, 64 KiB for a SWID tag).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "422": {
            "description": "A well-formed purl, CPE, TEI or SWID tag this API cannot resolve.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "503": {
            "description": "A dependency did not answer: the service is in maintenance, the database did not answer, or the transparency log behind a TEI could not be read (`InputError`). Retry after `Retry-After` seconds when it is set.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/scorecard'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb scorecard CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/sightings": {
      "get": {
        "operationId": "getVulnSightings",
        "tags": [
          "Threat Activity"
        ],
        "summary": "Get the in-the-wild observation timeline",
        "description": "Every in-the-wild observation of a vulnerability on one timeline, oldest first, in three lanes: `shadowserver` (daily honeypot counts, with `count` and `source` as `<statistic>:<hostType>`), `vulncheck-reported` (attributed exploitation reports, with `url`) and `ai-in-wild` (AI-discovered observations, with `observedBy`, `url`, `source` and `timeToExploit`). Headlines: `firstObservation`, `lastObservation` and `daysSinceLastSeen`. Aliases are followed.\n\n**Plans.** Below Pro, `events` is null and listed in `_pro_data` and `_entitlements`; `count` and the headlines stay.\n\nNamed by a purl, CPE, TEI or SWID tag, the answer is the fan-out envelope with this answer per resolved vulnerability under `results`.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.events",
            "$.results[*].events"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/sightings'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb sightings CVE-2021-44228"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/ThreatActivityInputUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ThreatActivityInputUnavailable"
          },
          "400": {
            "$ref": "#/components/responses/ThreatActivityInputBadRequest"
          },
          "413": {
            "$ref": "#/components/responses/ThreatActivityInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/ThreatActivityInputUnresolvable"
          },
          "200": {
            "description": "The observation timeline, or the fan-out envelope.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/ThreatActivityCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnSightingsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnSightingsResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 2,
                  "firstObservation": "2021-12-10T00:00:00Z",
                  "lastObservation": "2025-11-04T00:00:00Z",
                  "daysSinceLastSeen": 1,
                  "events": [
                    {
                      "lane": "vulncheck-reported",
                      "at": "2021-12-10T00:00:00Z",
                      "source": "vulncheck",
                      "url": "https://www.lunasec.io/docs/blog/log4j-zero-day/"
                    },
                    {
                      "lane": "shadowserver",
                      "at": "2025-11-04T00:00:00Z",
                      "count": 412,
                      "source": "honeypot:scanner"
                    }
                  ],
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "_links": [
                    {
                      "rel": "iocs",
                      "href": "/v2/vuln/CVE-2021-44228/iocs"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/vuln/{identifier}/snort-rules": {
      "get": {
        "operationId": "listVulnSnortRules",
        "tags": [
          "Detection Rules"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List Snort rules for a vulnerability",
        "description": "Returns the Snort and Suricata rules linked to one vulnerability, ordered by `signatureSeverity` as text, descending, rules without one last, then by `snortId` (an alphabetical order, not a severity ranking: `Minor` sorts before `Major`, `Informational` and `Critical`), with the vulnerability's `state`, `title`, `aliases` and `_links`. Rules are linked to CVE, GHSA and CNVD ids only: any other advisory family is a 400. Paged by `limit` (default 100, at most 500) and `offset`.\n\nEvery plan gets every rule and its metadata. Below Pro the rule text is withheld: `rawText` and `bodyOptions` are null and `_pro_data` / `_entitlements` name them (feature `detection-rules-catalog`).\n\nGiven a purl, CPE, TEI or SWID tag in place of the id, the answer is the fan-out envelope: this route's answer for each resolved CVE, GHSA or CNVD id (at most 50) under `results`, the same `limit` and `offset` applied to each, and the other resolved ids under `skipped`.",
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "detection-rules-catalog",
          "gatedFields": [
            "$.rules[*].rawText",
            "$.rules[*].bodyOptions",
            "$.results[*].rules[*].rawText",
            "$.results[*].rules[*].bodyOptions"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/snort-rules?limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb snort-rules get CVE-2021-44228"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/DetectionRuleIdentifier"
          },
          {
            "$ref": "#/components/parameters/DetectionVexLimit500"
          },
          {
            "$ref": "#/components/parameters/DetectionVexOffset"
          }
        ],
        "responses": {
          "200": {
            "description": "The rules linked to the vulnerability, or the fan-out envelope for a purl, CPE, TEI or SWID identifier.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/DetectionVexCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/DetectionVexVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnSnortRulesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnSnortRulesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 12,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "rules": [
                    {
                      "snortId": "2034647",
                      "rev": 3,
                      "action": "alert",
                      "protocol": "tcp",
                      "srcIp": "$EXTERNAL_NET",
                      "srcPort": "any",
                      "direction": "->",
                      "dstIp": "$HOME_NET",
                      "dstPort": "any",
                      "msg": "ET EXPLOIT Apache log4j RCE Attempt (http ldap) (CVE-2021-44228)",
                      "flow": "established,to_server",
                      "classtype": "attempted-admin",
                      "disabled": false,
                      "rawText": "alert tcp $EXTERNAL_NET any -> $HOME_NET any (msg:\"ET EXPLOIT Apache log4j RCE Attempt (http ldap) (CVE-2021-44228)\"; flow:established,to_server; content:\"${jndi:ldap://\"; nocase; classtype:attempted-admin; sid:2034647; rev:3;)",
                      "confidence": "High",
                      "signatureSeverity": "Major",
                      "affectedProducts": [
                        "Apache_log4j"
                      ],
                      "attackTargets": [
                        "Server"
                      ],
                      "tags": [
                        "Exploit"
                      ],
                      "mitreTechIds": [
                        "T1190"
                      ],
                      "mitreTacticIds": [
                        "TA0001"
                      ],
                      "bodyOptions": [
                        {
                          "key": "msg",
                          "value": "ET EXPLOIT Apache log4j RCE Attempt (http ldap) (CVE-2021-44228)"
                        },
                        {
                          "key": "content",
                          "value": "${jndi:ldap://"
                        },
                        {
                          "key": "nocase"
                        }
                      ],
                      "datePublished": "2021-12-10T00:00:00Z",
                      "dateUpdated": "2021-12-14T00:00:00Z",
                      "source": "emergingthreats"
                    }
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    },
                    {
                      "rel": "kev",
                      "href": "/v2/vuln/CVE-2021-44228/kev"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier is an advisory id of a family other than CVE, GHSA or CNVD (Snort rules are linked to those three only; the body carries `examples`), or it is a purl, CPE, TEI or SWID tag that does not parse (`InputError`). When request validation runs in enforce mode (the `oas_validation_mode` flag), a query or path value outside this document's constraints is also a 400 `{error, field}`; in the default log mode it reaches the handler, which ignores or clamps it as described.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/DetectionRuleIdentifierError"
                    },
                    {
                      "$ref": "#/components/schemas/InputError"
                    }
                  ]
                },
                "example": {
                  "error": "Invalid vulnerability identifier. Traffic filter rules support CVE, GHSA, and CNVD identifiers only.",
                  "examples": "CVE-2021-44228, GHSA-jfh8-c2jp-5v3q, CNVD-2024-02713"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DetectionVexUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/DetectionVexInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DetectionVexInputUnresolvable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/DetectionVexInternalError"
          },
          "503": {
            "$ref": "#/components/responses/DetectionVexUnavailable"
          }
        }
      }
    },
    "/vuln/{identifier}/threat-actors": {
      "get": {
        "operationId": "listVulnThreatActors",
        "tags": [
          "Threat Activity"
        ],
        "summary": "List threat actors behind a malicious package",
        "description": "Malware-author intelligence for one advisory (typically a malicious-package advisory such as an OSM or MAL id): the attributed threat actors with their SSH and GPG key fingerprints, the parsed IOCs, and the repositories the package impersonates (`impersonationTrap`). `isMalicious` is true when any of the three has a row.\n\nThe id is upper-cased and matched exactly; aliases are not followed. An empty list is `null`, not `[]`.\n\n**Plans.** Below Pro, `threatActors`, `iocs` and `impersonationTrap` are null and listed in `_pro_data` and `_entitlements`; `isMalicious` and `counts` stay.\n\nNamed by a purl, CPE, TEI or SWID tag, the answer is the fan-out envelope with this answer per resolved vulnerability under `results`.",
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.threatActors",
            "$.iocs",
            "$.impersonationTrap",
            "$.results[*].threatActors",
            "$.results[*].iocs",
            "$.results[*].impersonationTrap"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/MAL-2025-1234/threat-actors'"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/ThreatActivityInputUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ThreatActivityInputUnavailable"
          },
          "400": {
            "description": "A malformed input kind (`field` names it), or an empty identifier. The empty-identifier body is the JSON `{\"error\":\"Missing vulnerability ID\"}` sent as `text/plain`. When request validation is enforced, a request that does not fit this document is refused with `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/InputError"
                    }
                  ]
                },
                "example": {
                  "error": "purl must start with pkg:",
                  "field": "purl"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                },
                "example": "{\"error\":\"Missing vulnerability ID\"}"
              }
            }
          },
          "413": {
            "$ref": "#/components/responses/ThreatActivityInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/ThreatActivityInputUnresolvable"
          },
          "200": {
            "description": "The threat-actor intelligence, or the fan-out envelope.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/ThreatActivityCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnThreatActorsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnThreatActorsResponseFanout"
                    }
                  ]
                },
                "example": {
                  "success": true,
                  "identifier": "MAL-2025-1234",
                  "isMalicious": true,
                  "threatActors": [
                    {
                      "platform": "github",
                      "identifier": "evil-maintainer",
                      "actorType": "individual",
                      "displayName": "Evil Maintainer",
                      "profileUrl": "https://github.com/evil-maintainer",
                      "attributionForm": "publisher",
                      "attributionBasis": "registry-metadata",
                      "confidence": "high",
                      "cveId": "MAL-2025-1234",
                      "cveSource": "osm",
                      "keys": [
                        {
                          "keyType": "ssh-ed25519",
                          "fingerprint": "SHA256:Xq3c0mJ5rF2b8VQx1yYv7pT9wQeR4sD6fG8hJ0kL2mN"
                        }
                      ]
                    }
                  ],
                  "iocs": [
                    {
                      "iocType": "domain",
                      "value": "exfil.example.net",
                      "truncated": false,
                      "cveId": "MAL-2025-1234"
                    }
                  ],
                  "impersonationTrap": [
                    {
                      "cveId": "MAL-2025-1234",
                      "cveSource": "osm",
                      "claimedRepoOwner": "lodash",
                      "claimedRepoUrl": "https://github.com/lodash/lodash",
                      "claimedRepoSource": "package.json"
                    }
                  ],
                  "counts": {
                    "threatActors": 1,
                    "iocs": 1,
                    "keys": 1
                  }
                }
              }
            }
          }
        }
      }
    },
    "/vuln/{identifier}/timeline": {
      "get": {
        "operationId": "getVulnTimeline",
        "tags": [
          "Vulnerabilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get the event timeline for a vulnerability",
        "description": "Everything that happened to a vulnerability in time order: reservation, publication and updates, ADP and GHSA records, exploits and sightings, KEV listings, EPSS and CESS score changes, fixes and patches, advisories and OpenSSF Scorecard runs, with the per-source detail behind them (`sources`) and lifecycle figures (`meta`).\n\n`include` and `exclude` take comma-separated event types (`source`, `exploit`, `score-change`, `patch`, `advisory`, `scorecard`); `dates` limits the `source` events to `published`, `modified` and `reserved`. Unknown values are ignored. Answers are cached in the server for 5 minutes per query string (`X-Cache`).\n\nThe identifier is any advisory id (family prefix upper-cased, alias resolved); a purl, CPE, TEI or SWID tag answers once per resolved vulnerability under `results`. Open to every plan.",
        "parameters": [
          {
            "$ref": "#/components/parameters/VulnIdentifierPath"
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "description": "Event types to include, comma-separated. Default all.",
            "schema": {
              "type": "string",
              "maxLength": 128,
              "pattern": "^(?:source|exploit|score-change|patch|advisory|scorecard)(?:,(?:source|exploit|score-change|patch|advisory|scorecard)){0,5}$"
            },
            "example": "exploit,patch"
          },
          {
            "name": "exclude",
            "in": "query",
            "required": false,
            "description": "Event types to leave out, comma-separated; applied after `include`.",
            "schema": {
              "type": "string",
              "maxLength": 128,
              "pattern": "^(?:source|exploit|score-change|patch|advisory|scorecard)(?:,(?:source|exploit|score-change|patch|advisory|scorecard)){0,5}$"
            },
            "example": "score-change"
          },
          {
            "name": "dates",
            "in": "query",
            "required": false,
            "description": "Which record dates become `source` events, comma-separated. Default all three.",
            "schema": {
              "type": "string",
              "maxLength": 64,
              "pattern": "^(?:published|modified|reserved)(?:,(?:published|modified|reserved)){0,2}$"
            },
            "example": "published,reserved"
          },
          {
            "name": "scoresLimit",
            "in": "query",
            "required": false,
            "description": "EPSS and CESS history points to sample (outliers kept, the rest evenly spaced). Default 30; above 365 is lowered to 365; a value that is not a positive integer is replaced by the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 365,
              "default": 30
            },
            "example": 30
          },
          {
            "name": "scores_limit",
            "in": "query",
            "required": false,
            "description": "Deprecated spelling of `scoresLimit`; still accepted. EPSS and CESS history points to sample (outliers kept, the rest evenly spaced). Default 30; above 365 is lowered to 365; a value that is not a positive integer is replaced by the default.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 365,
              "default": 30
            },
            "example": 30,
            "deprecated": true
          }
        ],
        "responses": {
          "200": {
            "description": "The timeline; or, for a purl, CPE, TEI or SWID identifier, the fan-out envelope.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/VulnApiCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/VulnApiVary"
              },
              "X-Cache": {
                "$ref": "#/components/headers/VulnApiXCache"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnTimelineResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnTimelineResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1793836800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "events": [
                    {
                      "time": 1638316800000,
                      "type": "source",
                      "label": "CVE ID reserved",
                      "icon": "mdi-calendar-plus",
                      "color": "#757575",
                      "sourceRef": "cve"
                    },
                    {
                      "time": 1639094400000,
                      "type": "source",
                      "label": "Published",
                      "icon": "mdi-calendar-clock",
                      "color": "#757575",
                      "sourceRef": "cve"
                    },
                    {
                      "time": 1639785600000,
                      "type": "exploit",
                      "label": "Added to CISA KEV",
                      "icon": "mdi-shield-alert",
                      "color": "#757575",
                      "sourceRef": "cisa-kev",
                      "kevCisa": true
                    }
                  ],
                  "sources": {
                    "cve": {
                      "datePublished": "2021-12-10T00:00:00Z",
                      "dateReserved": "2021-12-01T00:00:00Z",
                      "state": "PUBLISHED"
                    },
                    "kev": {
                      "cisa": {
                        "dateAdded": "2021-12-10T00:00:00Z",
                        "dueDate": "2021-12-24T00:00:00Z",
                        "vendorProject": "Apache",
                        "product": "Log4j2",
                        "vulnerabilityName": "Apache Log4j2 Remote Code Execution Vulnerability",
                        "requiredAction": "Apply updates per vendor instructions.",
                        "knownRansomwareCampaignUse": "Known",
                        "notes": null
                      },
                      "eu": null
                    },
                    "epss": {
                      "history": [
                        {
                          "date": "2026-11-04",
                          "score": 0.94358,
                          "percentile": 0.99957
                        }
                      ],
                      "current": {
                        "date": "2026-11-04",
                        "score": 0.94358,
                        "percentile": 0.99957
                      }
                    },
                    "cess": null,
                    "vulncheck": null,
                    "crowdsec": null,
                    "scorecard": null,
                    "advisories": null,
                    "adp": null
                  },
                  "meta": {
                    "currentAgeDays": 1791,
                    "lifecycleStage": "LEGACY",
                    "publicationToKevDays": 0,
                    "publicationToFirstExploitDays": 0,
                    "publicationToFirstPatchDays": 0,
                    "reservationToPublicationDays": 9,
                    "totalEvents": 3,
                    "insights": [
                      "Legacy vulnerability (4 years old) still actively exploited"
                    ],
                    "futureEpssDate": "2026-12-05T00:00:00Z",
                    "futureEpssScore": 0.94358
                  },
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "kev",
                      "href": "/v2/vuln/CVE-2021-44228/kev"
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "No record of the vulnerability (`identifier` echoes the normalised, alias-resolved id), the metadata lookup failed (the handler answers a database error as not found too), or the caller's organisation was not found (middleware).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/VulnNotFoundBody"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "The answer could not be serialised.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "400": {
            "description": "The identifier is a purl, CPE, TEI or SWID tag that is malformed (`InputError`, `field` names the kind), or the identifier is empty (`ErrorBody`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "No valid credential (middleware), or a TEI that names a tenant release the caller cannot read (`InputError`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                }
              }
            }
          },
          "413": {
            "description": "The identifier is over its size limit (512 characters, 64 KiB for a SWID tag).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "422": {
            "description": "A well-formed purl, CPE, TEI or SWID tag this API cannot resolve.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                }
              }
            }
          },
          "503": {
            "description": "A dependency did not answer: the service is in maintenance, the database did not answer, or the transparency log behind a TEI could not be read (`InputError`). Retry after `Retry-After` seconds when it is set.",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/InputError"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/timeline?include=exploit,patch'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb timeline CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/vex": {
      "get": {
        "operationId": "listVulnVexStatements",
        "tags": [
          "VEX"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List your VEX statements for a vulnerability",
        "description": "Returns the statements about one vulnerability from the VEX documents your organisation has uploaded (no other organisation's), newest first, with the vulnerability's `state`, `title`, `aliases` and `_links`. The id is normalised and alias-resolved, upper-cased (so a GHSA id's lower-case suffix is upper-cased too), then matched exactly against each statement's `vulnerabilityId`. Not paged: at most 200 statements; use `GET /vex` with `cveId` to page further. No statements is a 200 with an empty `statements`.\n\nGiven a purl, CPE, TEI or SWID tag in place of the id, the answer is the fan-out envelope with this route's answer for each resolved vulnerability (at most 50) under `results`.",
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/vex'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb vex get CVE-2021-44228"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/DetectionVexIdentifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Your organisation's statements about the vulnerability, or the fan-out envelope for a purl, CPE, TEI or SWID identifier.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/DetectionVexCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/DetectionVexVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnVexStatementsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnVexStatementsResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 1,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "statements": [
                    {
                      "uuid": "a4f2c9d1-7e3b-4b8a-9c21-5d6e7f8a9b0c",
                      "openVexUuid": "e1d2c3b4-a596-4877-8a69-5b4c3d2e1f00",
                      "statementId": "https://example.com/vex/2024-001#1",
                      "timestamp": "2024-03-01T12:00:00Z",
                      "vulnerabilityId": "CVE-2021-44228",
                      "vulnerabilityName": "CVE-2021-44228",
                      "products": [
                        {
                          "@id": "pkg:maven/com.example/billing-service@3.2.0"
                        }
                      ],
                      "status": "not_affected",
                      "supplier": "Example Corp",
                      "justification": "vulnerable_code_not_in_execute_path",
                      "impactStatement": "JndiLookup is removed from the shaded log4j-core."
                    }
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    },
                    {
                      "rel": "kev",
                      "href": "/v2/vuln/CVE-2021-44228/kev"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier is a purl, CPE, TEI or SWID tag that does not parse (`InputError`). When request validation runs in enforce mode (the `oas_validation_mode` flag), a query or path value outside this document's constraints is also a 400 `{error, field}`; in the default log mode it reaches the handler, which ignores or clamps it as described.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InputError"
                },
                "example": {
                  "error": "purl: missing type",
                  "field": "purl"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DetectionVexUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/DetectionVexInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DetectionVexInputUnresolvable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "An unexpected server error in the shared middleware. The handler itself never answers 500: a failed statement query answers 200 with `statements: null` and `count` 0.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/DetectionVexUnavailable"
          }
        }
      }
    },
    "/vuln/{identifier}/virtual-patches": {
      "get": {
        "operationId": "listVulnVirtualPatches",
        "tags": [
          "Defences"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List virtual patches for a vulnerability",
        "description": "Blocking defences derived from the proof-of-concept exploits Vulnesis has ingested: Snort and Suricata signatures, ModSecurity and nginx rules, AWS WAF rule statements, Cloudflare expressions and layer-7 patterns. These are what an edge or an inline sensor enforces. Every defence names the exploit it was derived from.\n\nThe identifier is a vulnerability id of any advisory family (aliases are followed both ways), or in its place a URL-encoded purl, CPE or TEI; the answer then covers every vulnerability it resolves to, in one list. Any input kind in the query string narrows it further. A single advisory id also brings the advisory's `state`, `title`, `aliases` and `_links`.\n\n`limit` defaults to 100 and is clamped to 200.\n\n**Plans.** `count`, `total`, `byKind` and `resolved` are answered for every plan. The `virtual-patches` list is Pro and above: below Pro it is `null`, and `_pro_data` and `_entitlements` (feature `virtual-patches`) say so.",
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "A vulnerability id of any advisory family, or a URL-encoded purl (`pkg:`), CPE (`cpe:`) or TEI (`urn:tei:`), or a base64 (or base64url) SWID tag. This route reads those kinds itself rather than fanning out: the answer is one list for everything they resolve to. Anything else is 400.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 4096,
              "pattern": "^(?:[A-Za-z][A-Za-z0-9.]{0,23}[-:/_][A-Za-z0-9][A-Za-z0-9._:/-]{0,200}|pkg:[A-Za-z][A-Za-z0-9.+-]{0,31}/[!-~]{1,480}|cpe:(?:2\\.3:|/)[!-~]{1,500}|urn(?::|%3[Aa])tei(?::|%3[Aa])[!-~]{1,490}|[A-Za-z0-9+/_-]{16,}={0,2})$"
            },
            "example": "CVE-2021-44228"
          },
          {
            "$ref": "#/components/parameters/DefenceLimit"
          },
          {
            "$ref": "#/components/parameters/DefenceOffset"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "The virtual patches linked to the vulnerabilities the identifier resolves to.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListVulnVirtualPatchesResponse"
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 3,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "byKind": {
                    "SNORT": 2,
                    "AWS_WAF": 1
                  },
                  "resolved": {
                    "kinds": [
                      "vulnId"
                    ],
                    "vulnIds": [
                      "CVE-2021-44228",
                      "GHSA-jfh8-c2jp-5v3q"
                    ]
                  },
                  "virtual-patches": [
                    {
                      "uuid": "9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f",
                      "artifactId": "vulnetix-vp-5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73-snort",
                      "kind": "SNORT",
                      "title": "Log4Shell JNDI lookup in request",
                      "confidence": "HIGH",
                      "deployMode": "block",
                      "falsePositiveRisk": "LOW",
                      "mitreTechIds": [
                        "T1190"
                      ],
                      "rawText": "alert tcp any any -> $HOME_NET any (msg:\"VULNETIX Log4Shell JNDI lookup\"; content:\"${jndi:\"; nocase; sid:9100001; rev:1;)",
                      "fileSize": 121,
                      "exploitUuid": "5d1e2c0a-7b3f-4e8a-9c61-2f4d8e0b1a73",
                      "exploitId": "50592",
                      "exploitSource": "exploit-db",
                      "matchedCve": "CVE-2021-44228",
                      "archiveUrl": "/v2/virtual-patches/9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f/archive",
                      "consoleUrl": "https://www.vulnes.is/resolve/virtual-patching?dc=9f2c4b1e-3d5a-4c7e-8b90-1a2b3c4d5e6f#catalogue",
                      "createdAt": "2025-02-11T08:14:03Z",
                      "updatedAt": "2025-03-02T17:40:55Z"
                    }
                  ],
                  "identifier": "CVE-2021-44228",
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "_links": [
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    },
                    {
                      "rel": "exploits",
                      "href": "/v2/exploits/CVE-2021-44228"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The identifier is none of the accepted kinds (`{error, examples}`), or an input is malformed (`InputError`, `field` names it).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/DefenceIdentifierError"
                    },
                    {
                      "$ref": "#/components/schemas/InputError"
                    }
                  ]
                },
                "example": {
                  "error": "Invalid identifier. Use a vulnerability id, a purl, a CPE, a TEI or a SWID tag.",
                  "examples": "CVE-2021-44228, GHSA-jfh8-c2jp-5v3q, pkg:npm/lodash@4.17.20, cpe:2.3:a:apache:log4j:2.14.1:*:*:*:*:*:*:*, urn:tei:purl:vulnes.is:pkg:npm/lodash@4.17.20"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DefenceInputUnauthorized"
          },
          "413": {
            "$ref": "#/components/responses/DefenceInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DefenceInputUnresolvable"
          },
          "503": {
            "$ref": "#/components/responses/DefenceInputUnavailable"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "virtual-patches",
          "gatedFields": [
            "$.virtual-patches"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/virtual-patches'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb virtual-patches get CVE-2021-44228"
          }
        ]
      }
    },
    "/vuln/{identifier}/workarounds": {
      "get": {
        "operationId": "getVulnWorkarounds",
        "tags": [
          "Remediation"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get workarounds for a vulnerability",
        "description": "Workarounds and configuration notes from every source's record: `workarounds` from the CVE record's CNA and ADP containers, `configurations` from the CNA container and NVD's evaluator comment, with every source's description for context. Use it when no fix can be applied yet.\n\nAnswers 404 when no source holds a record for the vulnerability. This route takes no query parameters.\n\nA purl, CPE, TEI or SWID tag in place of the id fans out under `results`.",
        "parameters": [
          {
            "$ref": "#/components/parameters/RemediationVulnIdentifier"
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/RemediationBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/RemediationUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/RemediationPayloadTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/RemediationUnprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/RemediationUnavailable"
          },
          "200": {
            "description": "OK, or a fan-out answer with one per vulnerability under `results`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/RemediationCacheControl"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/GetVulnWorkaroundsResponse"
                    },
                    {
                      "$ref": "#/components/schemas/GetVulnWorkaroundsResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI remote code execution",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "workarounds": [
                    {
                      "lang": "en",
                      "value": "Remove the JndiLookup class from the classpath: zip -q -d log4j-core-*.jar org/apache/logging/log4j/core/lookup/JndiLookup.class",
                      "source": "cve.org",
                      "type": "cna"
                    }
                  ],
                  "configurations": [],
                  "descriptions": []
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/RemediationVulnNotFound"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/workarounds'"
          }
        ]
      }
    },
    "/vuln/{identifier}/yara-rules": {
      "get": {
        "operationId": "listVulnYaraRules",
        "tags": [
          "Detection Rules"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List YARA rules for a vulnerability",
        "description": "Returns the YARA rules linked to one vulnerability, newest first (then by `ruleName`), with the vulnerability's `state`, `title`, `aliases` and `_links`. Each rule's `meta` is parsed into an object and its `strings` into `{id, value, modifiers}` entries. Rules are linked to CVE, GHSA and CNVD ids only: any other advisory family is a 400. Paged by `limit` (default 100, at most 500) and `offset`.\n\nEvery plan gets every rule and its metadata. Below Pro the rule text is withheld: `rawText`, `strings` and `condition` are null and `_pro_data` / `_entitlements` name them (feature `detection-rules-catalog`).\n\nGiven a purl, CPE, TEI or SWID tag in place of the id, the answer is the fan-out envelope: this route's answer for each resolved CVE, GHSA or CNVD id (at most 50) under `results`, the same `limit` and `offset` applied to each, and the other resolved ids under `skipped`.",
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "detection-rules-catalog",
          "gatedFields": [
            "$.rules[*].rawText",
            "$.rules[*].strings",
            "$.rules[*].condition",
            "$.results[*].rules[*].rawText",
            "$.results[*].rules[*].strings",
            "$.results[*].rules[*].condition"
          ]
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vuln/CVE-2021-44228/yara-rules'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb yara-rules get CVE-2021-44228"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/DetectionRuleIdentifier"
          },
          {
            "$ref": "#/components/parameters/DetectionVexLimit500"
          },
          {
            "$ref": "#/components/parameters/DetectionVexOffset"
          }
        ],
        "responses": {
          "200": {
            "description": "The rules linked to the vulnerability, or the fan-out envelope for a purl, CPE, TEI or SWID identifier.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/DetectionVexCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/DetectionVexVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ListVulnYaraRulesResponse"
                    },
                    {
                      "$ref": "#/components/schemas/ListVulnYaraRulesResponseFanout"
                    }
                  ]
                },
                "example": {
                  "identifier": "CVE-2021-44228",
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 4,
                  "limit": 100,
                  "offset": 0,
                  "hasMore": false,
                  "state": "PUBLISHED",
                  "title": "Apache Log4j2 JNDI features do not protect against attacker controlled LDAP and other JNDI related endpoints",
                  "aliases": [
                    "GHSA-jfh8-c2jp-5v3q"
                  ],
                  "rules": [
                    {
                      "ruleName": "EXPL_Log4j_CVE_2021_44228_JAVA_Exception_Dec21_1",
                      "source": "yara-forge",
                      "sourceUrl": "https://github.com/Neo23x0/signature-base",
                      "sourceFilePath": "yara/expl_log4j_cve_2021_44228.yar",
                      "rawText": null,
                      "meta": {
                        "author": "Florian Roth",
                        "date": "2021-12-12"
                      },
                      "strings": null,
                      "condition": null,
                      "tags": [
                        "CVE_2021_44228"
                      ],
                      "author": "Florian Roth",
                      "description": "Detects exceptions found in server logs that indicate an exploitation attempt of CVE-2021-44228",
                      "reference": "https://gist.github.com/Neo23x0/e4c8b03ff8cdf1fa63b7d15db6e3860b",
                      "datePublished": "2021-12-12T00:00:00Z",
                      "fileSize": 4211
                    }
                  ],
                  "_links": [
                    {
                      "rel": "info",
                      "href": "/v2/info/CVE-2021-44228"
                    },
                    {
                      "rel": "vuln",
                      "href": "/v2/vuln/CVE-2021-44228"
                    },
                    {
                      "rel": "kev",
                      "href": "/v2/vuln/CVE-2021-44228/kev"
                    }
                  ],
                  "_pro_data": [
                    "$.rules[*].rawText",
                    "$.rules[*].strings",
                    "$.rules[*].condition"
                  ],
                  "_entitlements": {
                    "plan": "community",
                    "gated": [
                      {
                        "feature": "detection-rules-catalog",
                        "requiredPlan": "pro",
                        "paths": [
                          "$.rules[*].rawText",
                          "$.rules[*].strings",
                          "$.rules[*].condition"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "The identifier is an advisory id of a family other than CVE, GHSA or CNVD (YARA rules are linked to those three only; the body carries `examples`), or it is a purl, CPE, TEI or SWID tag that does not parse (`InputError`). When request validation runs in enforce mode (the `oas_validation_mode` flag), a query or path value outside this document's constraints is also a 400 `{error, field}`; in the default log mode it reaches the handler, which ignores or clamps it as described.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/DetectionRuleIdentifierError"
                    },
                    {
                      "$ref": "#/components/schemas/InputError"
                    }
                  ]
                },
                "example": {
                  "error": "Invalid vulnerability identifier. Yara detection rules support CVE, GHSA, and CNVD identifiers only.",
                  "examples": "CVE-2021-44228, GHSA-jfh8-c2jp-5v3q, CNVD-2024-02713"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/DetectionVexUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/DetectionVexInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DetectionVexInputUnresolvable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/DetectionVexInternalError"
          },
          "503": {
            "$ref": "#/components/responses/DetectionVexUnavailable"
          }
        }
      }
    },
    "/vulnetix-kev": {
      "get": {
        "operationId": "listVulnetixKev",
        "tags": [
          "KEV"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Export the Vulnesis KEV catalogue",
        "description": "Exports the Vulnesis KEV catalogue: CVEs with evidence of exploitation that CISA and ENISA have not listed yet (an entry leaves the moment either lists it). Each entry carries CISA-style fields plus its qualifying `reasons`. Entries with known ransomware use come first, then by due date, then by id. The data is licensed Apache-2.0 (`license` and `X-Data-License`).\n\n`format=json` (default) pages the entries (`limit` default 1000, at most 5000; an out-of-range `limit` uses 1000); `include-references=1` adds up to 5 references per kind. `format=csv` returns the whole filtered set as an attachment, without references, with the columns `cveId`, `vendorProject`, `product`, `vulnerabilityName`, `shortDescription`, `requiredAction`, `dateAdded`, `dueDate`, `overdue`, `daysUntilDue`, `knownRansomwareCampaignUse`, `reasons` (`|`-separated), `lastEvaluatedAt` and `source`.\n\n`reason` keeps entries with any (`mode=any`, default) or all (`mode=all`) of the given reasons. `include=cisa,enisa` (or `include-cisa=1`, `include-enisa=1`) appends those catalogues' entries as their own rows (`source` tells them apart; they carry no reasons, so a reason filter never removes them). Unknown values are ignored rather than rejected. Each query variant is held for an hour.\n\nNot plan-gated.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "`json` or `csv` (case-insensitive). Anything other than `csv` returns JSON.",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "csv",
                "JSON",
                "CSV"
              ],
              "default": "json"
            },
            "example": "csv"
          },
          {
            "name": "reason",
            "in": "query",
            "required": false,
            "description": "Keep entries carrying these reasons, case-insensitive. Repeatable.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 17,
              "items": {
                "type": "string",
                "minLength": 9,
                "maxLength": 21,
                "pattern": "^(?:[Cc][Rr][Ii][Tt][Ii][Cc][Aa][Ll]_[Cc][Vv][Ss][Ss]|[Cc][Rr][Oo][Ww][Dd][Ss][Ee][Cc]_[Ss][Ii][Gg][Hh][Tt][Ii][Nn][Gg]|[Dd][Ee][Mm][Oo][Nn][Ss][Tt][Rr][Aa][Tt][Ee][Dd]_[Ee][Xx][Pp][Ll][Oo][Ii][Tt]|[Ee][Xx][Pp][Ll][Oo][Ii][Tt][Dd][Bb]_[Vv][Ee][Rr][Ii][Ff][Ii][Ee][Dd]|[Kk][Nn][Oo][Ww][Nn]_[Rr][Aa][Nn][Ss][Oo][Mm][Ww][Aa][Rr][Ee]|[Mm][Ee][Tt][Aa][Ss][Pp][Ll][Oo][Ii][Tt]_[Mm][Oo][Dd][Uu][Ll][Ee]|[Mm][Ii][Ss][Pp]_[Ss][Ii][Gg][Hh][Tt][Ii][Nn][Gg]|[Mm][Uu][Ll][Tt][Ii]_[Ss][Oo][Uu][Rr][Cc][Ee]_[Ss][Ii][Gg][Hh][Tt][Ii][Nn][Gg]|[Nn][Ss][Ee]_[Ss][Cc][Rr][Ii][Pp][Tt]|[Nn][Uu][Cc][Ll][Ee][Ii]_[Tt][Ee][Mm][Pp][Ll][Aa][Tt][Ee]|[Rr][Ee][Pp][Oo][Rr][Tt][Ee][Dd]_[Ii][Tt][Ww]|[Ss][Hh][Aa][Dd][Oo][Ww][Ss][Ee][Rr][Vv][Ee][Rr]_[Ss][Ii][Gg][Hh][Tt][Ii][Nn][Gg]|[Ss][Hh][Aa][Dd][Oo][Ww][Ss][Ee][Rr][Vv][Ee][Rr]_[Ss][Uu][Rr][Gg][Ee]|[Ss][Nn][Oo][Rr][Tt]_[Rr][Uu][Ll][Ee]|[Vv][Ee][Nn][Dd][Oo][Rr]_[Ee][Xx][Pp][Ll][Oo][Ii][Tt][Ee][Dd]|[Yy][Aa][Rr][Aa]_[Rr][Uu][Ll][Ee]|[Zz][Ee][Rr][Oo]_[Dd][Aa][Yy]_[Ii][Tt][Ww])$"
              }
            },
            "example": [
              "known_ransomware"
            ]
          },
          {
            "name": "mode",
            "in": "query",
            "required": false,
            "description": "`any` keeps entries with at least one `reason`; `all` (exact, lower case) keeps entries with every one.",
            "schema": {
              "type": "string",
              "enum": [
                "any",
                "all"
              ],
              "default": "any"
            },
            "example": "all"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "JSON only: entries per page. A value outside 1-5000 or non-numeric uses 1000.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 5000,
              "default": 1000
            },
            "example": 1000
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "JSON only: entries to skip. Non-numeric or negative values use 0.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          },
          {
            "name": "includeReferences",
            "in": "query",
            "required": false,
            "description": "JSON only: `1` adds `references` to each entry. Any other value leaves them out.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "example": "1"
          },
          {
            "name": "include-references",
            "in": "query",
            "required": false,
            "description": "Deprecated spelling of `includeReferences`; still accepted. JSON only: `1` adds `references` to each entry. Any other value leaves them out.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "example": "1",
            "deprecated": true
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "description": "Authority catalogues to append: `cisa`, `enisa` (case-insensitive), comma-separated or repeated.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "maxItems": 2,
              "items": {
                "type": "string",
                "maxLength": 11,
                "pattern": "^(?:cisa|enisa|CISA|ENISA)(?:,(?:cisa|enisa|CISA|ENISA))?$"
              }
            },
            "example": [
              "cisa,enisa"
            ]
          },
          {
            "name": "include-cisa",
            "in": "query",
            "required": false,
            "description": "`1` appends the CISA catalogue.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "example": "1"
          },
          {
            "name": "include-enisa",
            "in": "query",
            "required": false,
            "description": "`1` appends the ENISA catalogue.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ]
            },
            "example": "1"
          }
        ],
        "responses": {
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The answer could not be serialised, or an unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "success": false,
                  "error": "Internal Server Error"
                }
              }
            }
          },
          "503": {
            "description": "The catalogue could not be read (`ErrorBody`), or a dependency did not answer or the service is in maintenance (retry after `Retry-After` seconds).",
            "headers": {
              "Retry-After": {
                "$ref": "#/components/headers/Retry-After"
              },
              "X-Maintenance-Mode": {
                "$ref": "#/components/headers/X-Maintenance-Mode"
              },
              "X-Data-License": {
                "description": "The data licence (set before the catalogue is read).",
                "schema": {
                  "type": "string",
                  "enum": [
                    "Apache-2.0"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    },
                    {
                      "$ref": "#/components/schemas/MaintenanceError"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "Vulnesis KEV not yet available, please retry shortly"
                }
              }
            }
          },
          "200": {
            "description": "The catalogue: a JSON page, or with `format=csv` the whole filtered set as `vulnetix-kev.csv`.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "X-Data-License": {
                "description": "The data licence.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "Apache-2.0"
                  ]
                }
              },
              "Cache-Control": {
                "description": "`public, max-age=300, s-maxage=3600, stale-while-revalidate=3600`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "public, max-age=300, s-maxage=3600, stale-while-revalidate=3600"
                  ]
                }
              },
              "Content-Disposition": {
                "description": "CSV only: `attachment; filename=\"vulnetix-kev.csv\"`.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "attachment; filename=\"vulnetix-kev.csv\""
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VulnetixKevResponse"
                },
                "example": {
                  "generatedAt": 1762300800,
                  "license": "Apache-2.0",
                  "total": 520,
                  "count": 1,
                  "limit": 1,
                  "offset": 0,
                  "items": [
                    {
                      "cveId": "CVE-2025-24813",
                      "source": "vulnetix",
                      "vendorProject": "Apache",
                      "product": "Tomcat",
                      "vulnerabilityName": "Apache Tomcat Path Equivalence Vulnerability",
                      "shortDescription": "Path equivalence in Apache Tomcat partial PUT handling.",
                      "requiredAction": "Apply vendor updates.",
                      "dateAdded": "2026-03-12",
                      "dueDate": "2026-04-02",
                      "overdue": true,
                      "daysUntilDue": -217,
                      "knownRansomwareCampaignUse": null,
                      "reasons": [
                        "nuclei_template",
                        "crowdsec_sighting"
                      ],
                      "lastEvaluatedAt": "2026-11-05T02:00:00Z",
                      "references": {
                        "nuclei": [
                          "http/cves/2025/CVE-2025-24813.yaml"
                        ]
                      }
                    }
                  ]
                }
              },
              "text/csv; charset=utf-8": {
                "schema": {
                  "type": "string",
                  "maxLength": 104857600
                },
                "example": "cveId,vendorProject,product,vulnerabilityName,shortDescription,requiredAction,dateAdded,dueDate,overdue,daysUntilDue,knownRansomwareCampaignUse,reasons,lastEvaluatedAt,source\nCVE-2025-24813,Apache,Tomcat,Apache Tomcat Path Equivalence Vulnerability,Path equivalence in Apache Tomcat partial PUT handling.,Apply vendor updates.,2026-03-12,2026-04-02,true,-217,,nuclei_template|crowdsec_sighting,2026-11-05T02:00:00Z,vulnetix\n"
              }
            }
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/vulnetix-kev?reason=known_ransomware&limit=100'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb kev list --reason known_ransomware"
          }
        ]
      }
    },
    "/yara-rules": {
      "get": {
        "operationId": "searchYaraRules",
        "tags": [
          "Detection Rules"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Search YARA rules",
        "description": "Searches the YARA rule catalogue. Filters combine with AND. Repeated `cveId` or `source` match any of the values; repeated `tag` or `imports` must all be present on the rule. Ordered newest first, or by name with `sort=name`. Paged by `limit` (default 100, at most 200) and `offset`. Rows carry `meta`, `strings` and `condition` as the stored text, not parsed (see `YaraRuleSearchRow`).\n\nEvery plan gets every rule and its metadata. Below Pro the rule text is withheld: `rawText`, `strings` and `condition` are null and `_pro_data` / `_entitlements` name them (feature `detection-rules-catalog`); free text `q` matches `ruleName` and `meta` only; and a `matchString` search, which has only rule text to search, answers the 200 `planLocked` body with an empty page.\n\nTakes every input kind (`vulnId`, `package`, `ecosystem`, `version`, `vendor`, `product`, `cpe`, `purl`, `swid`, `tei`, `cel`): they resolve to vulnerability ids (aliases included) and replace the `cveId` filter, and the answer gains `resolved`. Inputs that resolve to nothing answer an empty page, never an unfiltered one. `cveId` given alone keeps its own meaning (an exact match, no aliases).",
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "detection-rules-catalog",
          "gatedFields": [
            "$.rules[*].rawText",
            "$.rules[*].strings",
            "$.rules[*].condition"
          ],
          "exception": "`matchString` is a whole-answer gate: below Pro a request carrying it answers the `planLocked` body (feature `detection-rules-catalog`) with an empty page."
        },
        "x-badges": [
          {
            "name": "Pro",
            "position": "after",
            "color": "#7c3aed"
          }
        ],
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/yara-rules?tag=ransomware&imports=pe&limit=20'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb yara-rules list --tag ransomware --imports pe"
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/DetectionVexCveId"
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "Rule source, exact match; repeat for OR (for example `yara-forge`, `yarahub`, `vulnetix`).",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
              }
            },
            "example": [
              "yara-forge"
            ]
          },
          {
            "name": "ruleName",
            "in": "query",
            "required": false,
            "description": "Rule name, matched with ILIKE. A value with no `%` or `_` matches anywhere in the name; a value containing either is used as the SQL pattern as written (`_` matches any one character, a leading or trailing `%` any run).",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 130,
              "pattern": "^%?[A-Za-z_][A-Za-z0-9_]{0,127}%?$"
            },
            "example": "Log4j"
          },
          {
            "name": "author",
            "in": "query",
            "required": false,
            "description": "Author, matched with ILIKE; the same wildcard rule as `ruleName`.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 130,
              "pattern": "^%?[A-Za-z][A-Za-z0-9 ._@,-]{0,127}%?$"
            },
            "example": "Florian Roth"
          },
          {
            "name": "tag",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "A value `tags` must contain, exact match; repeat for AND.",
            "schema": {
              "type": "array",
              "maxItems": 50,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "pattern": "^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$"
              }
            },
            "example": [
              "ransomware"
            ]
          },
          {
            "name": "imports",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": true,
            "description": "A YARA module the rule imports (`pe`, `elf`, `math`, `hash`, `dotnet`, ...); repeat for AND.",
            "schema": {
              "type": "array",
              "maxItems": 20,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 32,
                "pattern": "^[a-z][a-z0-9_]{0,31}$"
              }
            },
            "example": [
              "pe"
            ]
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Free text; whitespace-separated words must all appear (ILIKE). Pro and above search `rawText`, `strings` and `meta`; below Pro `ruleName` and `meta` only.",
            "schema": {
              "$ref": "#/components/schemas/SafeText"
            },
            "example": "mimikatz"
          },
          {
            "name": "matchString",
            "in": "query",
            "required": false,
            "description": "Substring (ILIKE) of the stored `strings` section. Pro and above only: below Pro a request carrying it answers the `planLocked` body.",
            "schema": {
              "$ref": "#/components/schemas/SafeText"
            },
            "example": "jndi:ldap"
          },
          {
            "name": "matchMeta",
            "in": "query",
            "required": false,
            "description": "Substring (ILIKE) of the stored `meta` section, which is JSON text (`{\"severity\":\"high\"}`), so a `key=value` form does not match.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256,
              "pattern": "^[A-Za-z0-9 ._:@+#,=\"-]{1,256}$"
            },
            "example": "Florian Roth"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only rules with `datePublished` at or after this time.",
            "schema": {
              "$ref": "#/components/schemas/DetectionVexLooseTime"
            },
            "example": "2026-01-01T00:00:00Z"
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Only rules with `datePublished` at or before this time.",
            "schema": {
              "$ref": "#/components/schemas/DetectionVexLooseTime"
            },
            "example": "2026-01-01T00:00:00Z"
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "`recent` (newest `datePublished` first) or `name` (`ruleName`). Case-insensitive; another value means `recent`.",
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "name"
              ],
              "default": "recent"
            },
            "example": "recent"
          },
          {
            "$ref": "#/components/parameters/DetectionVexLimit200"
          },
          {
            "$ref": "#/components/parameters/DetectionVexOffset"
          },
          {
            "$ref": "#/components/parameters/InputVulnId"
          },
          {
            "$ref": "#/components/parameters/InputPackage"
          },
          {
            "$ref": "#/components/parameters/InputEcosystem"
          },
          {
            "$ref": "#/components/parameters/InputVersion"
          },
          {
            "$ref": "#/components/parameters/InputVendor"
          },
          {
            "$ref": "#/components/parameters/InputProduct"
          },
          {
            "$ref": "#/components/parameters/InputCPE"
          },
          {
            "$ref": "#/components/parameters/InputPURL"
          },
          {
            "$ref": "#/components/parameters/InputSWID"
          },
          {
            "$ref": "#/components/parameters/InputTEI"
          },
          {
            "$ref": "#/components/parameters/InputCEL"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of matching rules (with `resolved` when an input kind was given), or, below Pro with `matchString`, the `planLocked` body with an empty page.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/DetectionVexCacheControl"
              },
              "Vary": {
                "$ref": "#/components/headers/DetectionVexVary"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/SearchYaraRulesResponse"
                    },
                    {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/PlanLocked"
                        },
                        {
                          "$ref": "#/components/schemas/SearchYaraRulesPlanLockedPage"
                        }
                      ]
                    }
                  ]
                },
                "example": {
                  "timestamp": 1762300800,
                  "count": 1,
                  "total": 213,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "rules": [
                    {
                      "uuid": "0b8e4f7a-5c2d-4e19-8a3b-7d6c1f2e9a04",
                      "ruleName": "MAL_Ransom_LockBit_Jun23",
                      "source": "yara-forge",
                      "sourceUrl": "https://github.com/Neo23x0/signature-base",
                      "sourceFilePath": "yara/mal_lockbit.yar",
                      "rawText": "rule MAL_Ransom_LockBit_Jun23 { strings: $s1 = \"LockBit\" ascii condition: uint16(0) == 0x5a4d and $s1 }",
                      "bodyContentHash": "9c1185a5c5e9fc54612808977ee8f548b2258d31",
                      "meta": "{\"author\":\"Florian Roth\",\"date\":\"2023-06-01\"}",
                      "strings": "[{\"id\":\"$s1\",\"value\":\"LockBit\",\"modifiers\":[\"ascii\"]}]",
                      "condition": "uint16(0) == 0x5a4d and $s1",
                      "tags": [
                        "ransomware"
                      ],
                      "imports": [
                        "pe"
                      ],
                      "author": "Florian Roth",
                      "description": "Detects LockBit ransomware samples",
                      "datePublished": "2023-06-01T00:00:00Z",
                      "fileSize": 1873
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/DetectionVexSearchBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/DetectionVexUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "$ref": "#/components/responses/DetectionVexInputTooLarge"
          },
          "422": {
            "$ref": "#/components/responses/DetectionVexInputUnresolvable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/DetectionVexInternalError"
          },
          "503": {
            "$ref": "#/components/responses/DetectionVexUnavailable"
          }
        }
      }
    },
    "/{ecosystem}/{group}/{artifact}": {
      "get": {
        "operationId": "getEcosystemGroupPackage",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List product-index rows for a group/artifact package",
        "description": "Lists the raw product-index rows for a two-part package name such as a Maven `group:artifact`. Both `group:artifact` and `group/artifact` are resolved (exact, else fuzzy; up to ten names each) and the union is queried. The `ecosystem` segment is a resolver hint, not a filter. There is no deps.dev fallback on this route. `_links` are built from the lowercased `group:artifact`.\n\nAnswers 404 with an empty page when no row matches. An `artifact` of `versions` is served by `/{ecosystem}/{package}/versions` instead, and paths whose first segment is a fixed API segment (such as `malware`) by those routes.",
        "parameters": [
          {
            "name": "ecosystem",
            "in": "path",
            "required": true,
            "description": "Ecosystem hint (case-insensitive), for example maven. Does not filter.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "maven"
          },
          {
            "name": "group",
            "in": "path",
            "required": true,
            "description": "First part of the name, such as a Maven groupId or an npm scope (`@angular`). Percent-decoded and lowercased.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 255,
              "pattern": "^@?[A-Za-z0-9][A-Za-z0-9._~@+-]{0,253}$"
            },
            "example": "org.apache.logging.log4j"
          },
          {
            "name": "artifact",
            "in": "path",
            "required": true,
            "description": "Second part of the name, such as a Maven artifactId. Percent-decoded and lowercased.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 255,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._~@+-]{0,254}$"
            },
            "example": "log4j-core"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500: a larger value is clamped to 500, and zero, a negative number or a non-number falls back to 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip. Default 0; a negative number or a non-number falls back to 0. The server sets no upper bound today; 100000 is the documented maximum.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "The rows on this page.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetEcosystemGroupPackageResponse"
                },
                "example": {
                  "data": [
                    {
                      "packageName": "org.apache.logging.log4j:log4j-core",
                      "version": "2.14.1",
                      "ecosystem": "maven",
                      "sourceTable": "CVEAffected",
                      "sourceId": "CVE-2021-44228"
                    }
                  ],
                  "resolvedNames": [
                    "org.apache.logging.log4j:log4j-core"
                  ],
                  "resolvedMode": "exact",
                  "pagination": {
                    "limit": 1,
                    "offset": 0,
                    "hasMore": true,
                    "total": 412
                  },
                  "_links": [
                    {
                      "rel": "versions",
                      "href": "/v2/org.apache.logging.log4j:log4j-core/versions"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/product/org.apache.logging.log4j:log4j-core"
                    },
                    {
                      "rel": "vulns",
                      "href": "/v2/org.apache.logging.log4j:log4j-core/vulns"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "The package is not in the product index (body `EcosystemPackageNotFound`; there is no deps.dev lookup on this route, and `resolvedNames` is always an array here, empty when nothing resolved), or the caller's organisation was not found (`ErrorBody`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/EcosystemPackageNotFound"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "Package not found",
                  "data": [],
                  "resolvedNames": [],
                  "resolvedMode": "empty",
                  "pagination": {
                    "limit": 100,
                    "offset": 0,
                    "hasMore": false,
                    "total": 0
                  }
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The product-index query failed (`{\"success\": false, \"error\": \"Internal Server Error\"}`), or another unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/maven/org.apache.logging.log4j/log4j-core'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ecosystem group maven org.apache.logging.log4j log4j-core"
          }
        ]
      }
    },
    "/{ecosystem}/{package}": {
      "get": {
        "operationId": "getEcosystemPackage",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List product-index rows for a package",
        "description": "Lists the raw product-index rows (one per source and version) for a package name. The name is resolved to up to ten names (exact first, then fuzzy). The `ecosystem` segment is a hint, not a filter: it steers the fuzzy resolver and the deps.dev lookup that runs once when nothing is indexed, so rows from every ecosystem are returned. Rows are ordered newest version string first, rows without a version last.\n\nAnswers 404 with an empty page when no row matches. Requests whose package segment is `versions`, `vulns` or `issues` are served by the `/{package}/...` routes instead.",
        "parameters": [
          {
            "name": "ecosystem",
            "in": "path",
            "required": true,
            "description": "Ecosystem hint (case-insensitive), for example npm, pypi or maven. Does not filter.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "npm"
          },
          {
            "name": "package",
            "in": "path",
            "required": true,
            "description": "Package name. Percent-encode reserved characters: a scoped npm name is sent as `%40scope%2Fname`. The value is percent-decoded and lowercased before it is resolved.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "express"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500: a larger value is clamped to 500, and zero, a negative number or a non-number falls back to 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip. Default 0; a negative number or a non-number falls back to 0. The server sets no upper bound today; 100000 is the documented maximum.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "The rows on this page.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetEcosystemPackageResponse"
                },
                "example": {
                  "data": [
                    {
                      "packageName": "express",
                      "version": "5.1.0",
                      "ecosystem": "npm",
                      "sourceTable": "PackageVersion",
                      "sourceId": "c2d4e6f8-1a3b-4c5d-9e7f-0a1b2c3d4e5f"
                    }
                  ],
                  "resolvedNames": [
                    "express"
                  ],
                  "resolvedMode": "exact",
                  "pagination": {
                    "limit": 1,
                    "offset": 0,
                    "hasMore": true,
                    "total": 287
                  },
                  "_links": [
                    {
                      "rel": "versions",
                      "href": "/v2/express/versions"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/product/express"
                    },
                    {
                      "rel": "vulns",
                      "href": "/v2/express/vulns"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "The package is not in the product index, even after one deps.dev lookup (body `EcosystemPackageNotFound`; `resolvedNames` is null when nothing resolved, and can list names that are known only from CVE affected entries), or the caller's organisation was not found (`ErrorBody`).",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/EcosystemPackageNotFound"
                    },
                    {
                      "$ref": "#/components/schemas/ErrorBody"
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "error": "Package not found",
                  "data": [],
                  "resolvedNames": null,
                  "resolvedMode": "empty",
                  "pagination": {
                    "limit": 100,
                    "offset": 0,
                    "hasMore": false,
                    "total": 0
                  }
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "description": "The product-index query failed (`{\"success\": false, \"error\": \"Internal Server Error\"}`), or another unexpected server error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/npm/express?limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ecosystem package npm express"
          }
        ]
      }
    },
    "/{ecosystem}/{package}/versions": {
      "get": {
        "operationId": "getEcosystemPackageVersions",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List known versions of a package (ecosystem path)",
        "description": "Lists the versions of a package, as `/{package}/versions` does, without Safe Harbour. The `ecosystem` segment is a resolver hint, not a filter. Versions are the union of non-empty versions the product index holds for the resolved names and the valid versions listed in CVE affected entries, deduplicated and sorted by reverse string order (not semver: `9.0.0` sorts before `10.0.0`).\n\nA name nothing matches answers 200 with an empty `data` array. The answer is the same for every plan.",
        "parameters": [
          {
            "name": "ecosystem",
            "in": "path",
            "required": true,
            "description": "Ecosystem hint (case-insensitive). Does not filter.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "npm"
          },
          {
            "name": "package",
            "in": "path",
            "required": true,
            "description": "Package name. Percent-encode reserved characters: a scoped npm name is sent as `%40scope%2Fname`. The value is percent-decoded and lowercased before it is resolved.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "express"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500: a larger value is clamped to 500, and zero, a negative number or a non-number falls back to 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip. Default 0; a negative number or a non-number falls back to 0. The server sets no upper bound today; 100000 is the documented maximum.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "The versions on this page.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetEcosystemPackageVersionsResponse"
                },
                "example": {
                  "data": [
                    {
                      "version": "5.1.0",
                      "ecosystem": "",
                      "sources": [
                        "PackageVersion"
                      ]
                    },
                    {
                      "version": "5.0.1",
                      "ecosystem": "",
                      "sources": [
                        "PackageVersion",
                        "cve_affected"
                      ]
                    }
                  ],
                  "resolvedNames": [
                    "express"
                  ],
                  "resolvedMode": "exact",
                  "pagination": {
                    "limit": 2,
                    "offset": 0,
                    "hasMore": true,
                    "total": 283
                  },
                  "_links": [
                    {
                      "rel": "versions",
                      "href": "/v2/express/versions"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/product/express"
                    },
                    {
                      "rel": "vulns",
                      "href": "/v2/express/vulns"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/npm/express/versions'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb ecosystem package npm express --versions"
          }
        ]
      }
    },
    "/{package}/issues": {
      "get": {
        "operationId": "listPackageIssues",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "Get package issues (placeholder)",
        "description": "Placeholder: this route always answers 200 with `status: under_construction` and echoes the package name. It is meant to return CVE records for the package once implemented. It reads no query parameters.",
        "parameters": [
          {
            "name": "package",
            "in": "path",
            "required": true,
            "description": "Package name, echoed as given after percent-decoding (case kept). Percent-encode reserved characters (`%40scope%2Fname`). A package whose name is one of this API's fixed first path segments (`packages`, `product`, `eol`, `malware`, `vuln`, `info`, `search`, `scan`, `kev`, `iocs`, a `cli.` name and the like) cannot be reached here, because those routes match first; use `/product/{name}` for it.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "lodash"
          }
        ],
        "responses": {
          "200": {
            "description": "The placeholder answer.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PackageIssuesResponse"
                },
                "example": {
                  "success": true,
                  "status": "under_construction",
                  "message": "This endpoint is under active development and will be available soon.",
                  "_timestamp": 1762300800,
                  "package": "lodash"
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/lodash/issues'"
          }
        ]
      }
    },
    "/{package}/versions": {
      "get": {
        "operationId": "listPackageVersions",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List known versions of a package",
        "description": "Lists every version the VDB knows for a package, across ecosystems, with the sources that name each version. The name is resolved as on `/packages/search`: an exact match, else up to ten fuzzy matches. Versions are the union of non-empty versions the product index holds for the resolved names and the valid versions listed in CVE affected entries, deduplicated and sorted by reverse string order (not semver: `9.0.0` sorts before `10.0.0`).\n\n`ecosystem` is a hint: it steers the fuzzy resolver and selects the version scheme for the Safe Harbour summary; it does not filter.\n\nWith `withVulnIntel=1` the page size is capped at 100 and each version carries a Safe Harbour score, plus a package-level summary.\n\n**Plans.** Safe Harbour is Pro and above on this route: below Pro, `safeHarbour` and every `versions[].safeHarbour` are null and the answer adds `_pro_data` and `_entitlements` (feature `full-enrichment`). The version list itself is open to every plan. Responses are sent with `Cache-Control: private, no-store`.\n\nA package whose name equals a fixed first path segment of the API (`packages`, `product`, `eol`, `malware`, `vuln`, `kev`, `exploits` and the like) cannot be reached through this path.",
        "parameters": [
          {
            "name": "package",
            "in": "path",
            "required": true,
            "description": "Package name. Percent-encode reserved characters: a scoped npm name is sent as `%40scope%2Fname`. The value is percent-decoded and lowercased before it is resolved. A package whose name is one of this API's fixed first path segments (`packages`, `product`, `eol`, `malware`, `vuln`, `info`, `search`, `scan`, `kev`, `iocs`, a `cli.` name and the like) cannot be reached here, because those routes match first; use `/product/{name}` for it.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "lodash"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Hint for name resolution and for the Safe Harbour version scheme (case-insensitive). It does not filter.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "maven"
          },
          {
            "name": "withVulnIntel",
            "in": "query",
            "required": false,
            "description": "Send `1` to add Safe Harbour scoring: a `safeHarbour` object on every version on the page and a package-level `safeHarbour` summary. Only the exact string `1` turns it on; any other value, or leaving it out, returns no `safeHarbour` keys. With it the page size is capped at 100.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ],
              "maxLength": 1
            },
            "example": "1"
          },
          {
            "name": "currentVersion",
            "in": "query",
            "required": false,
            "description": "The version you run today. With `withVulnIntel=1` the summary's recommendation is computed relative to it; ignored otherwise.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "2.14.1"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500: a larger value is clamped to 500, and zero, a negative number or a non-number falls back to 100. With `withVulnIntel=1` the cap is 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip. Default 0; a negative number or a non-number falls back to 0. The server sets no upper bound today; 100000 is the documented maximum.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "The versions on this page. A name nothing matches answers 200 with an empty `versions` array.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              },
              "Cache-Control": {
                "description": "Always `private, no-store`: the answer depends on the caller's plan.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "private, no-store"
                  ]
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPackageVersionsResponse"
                },
                "example": {
                  "packageName": "lodash",
                  "resolvedNames": [
                    "lodash"
                  ],
                  "resolvedMode": "exact",
                  "timestamp": 1762300800,
                  "total": 114,
                  "limit": 2,
                  "offset": 0,
                  "hasMore": true,
                  "versions": [
                    {
                      "version": "4.17.21",
                      "ecosystem": "",
                      "sources": [
                        "PackageVersion",
                        "cve_affected"
                      ]
                    },
                    {
                      "version": "4.17.20",
                      "ecosystem": "",
                      "sources": [
                        "PackageVersion"
                      ]
                    }
                  ],
                  "_links": [
                    {
                      "rel": "versions",
                      "href": "/v2/lodash/versions"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/product/lodash"
                    },
                    {
                      "rel": "vulns",
                      "href": "/v2/lodash/vulns"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.safeHarbour",
            "$.versions[*].safeHarbour"
          ]
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/lodash/versions?withVulnIntel=1&currentVersion=4.17.20'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb versions lodash"
          }
        ]
      }
    },
    "/{package}/vulns": {
      "get": {
        "operationId": "listPackageVulns",
        "tags": [
          "Packages"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          },
          {
            "BearerAuth": []
          }
        ],
        "summary": "List a package's versions with their CVEs",
        "description": "Lists the versions of a package, as `/{package}/versions` does, and attaches CVE identifiers to each. The name is resolved the same way and `ecosystem` is the same hint. Versions are the union of non-empty versions the product index holds for the resolved names and the valid versions listed in CVE affected entries, deduplicated and sorted by reverse string order (not semver: `9.0.0` sorts before `10.0.0`).\n\n`cveIds` is a worst-case attribution, not a per-version range evaluation: every CVE known for the resolved names (at most 2000) is attached to every version on the page. Use `/packages/safety-matrix` for accurate per-version attribution. `totalCVEs` counts distinct CVEs with metadata for the package.\n\nWith `withVulnIntel=1` each version carries a Safe Harbour score and the answer carries a package-level summary. On this route Safe Harbour is not plan-gated today: every plan receives it.",
        "parameters": [
          {
            "name": "package",
            "in": "path",
            "required": true,
            "description": "Package name. Percent-encode reserved characters: a scoped npm name is sent as `%40scope%2Fname`. The value is percent-decoded and lowercased before it is resolved. A package whose name is one of this API's fixed first path segments (`packages`, `product`, `eol`, `malware`, `vuln`, `info`, `search`, `scan`, `kev`, `iocs`, a `cli.` name and the like) cannot be reached here, because those routes match first; use `/product/{name}` for it.",
            "schema": {
              "$ref": "#/components/schemas/PackageName"
            },
            "example": "lodash"
          },
          {
            "name": "ecosystem",
            "in": "query",
            "required": false,
            "description": "Hint for name resolution and for the Safe Harbour version scheme (case-insensitive). It does not filter.",
            "schema": {
              "$ref": "#/components/schemas/Ecosystem"
            },
            "example": "maven"
          },
          {
            "name": "withVulnIntel",
            "in": "query",
            "required": false,
            "description": "Send `1` to add Safe Harbour scoring: a `safeHarbour` object on every version on the page and a package-level `safeHarbour` summary. Only the exact string `1` turns it on; any other value, or leaving it out, returns no `safeHarbour` keys.",
            "schema": {
              "type": "string",
              "enum": [
                "1"
              ],
              "maxLength": 1
            },
            "example": "1"
          },
          {
            "name": "currentVersion",
            "in": "query",
            "required": false,
            "description": "The version you run today. With `withVulnIntel=1` the summary's recommendation is computed relative to it; ignored otherwise.",
            "schema": {
              "$ref": "#/components/schemas/Version"
            },
            "example": "2.14.1"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. Default 100, at most 500: a larger value is clamped to 500, and zero, a negative number or a non-number falls back to 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip. Default 0; a negative number or a non-number falls back to 0. The server sets no upper bound today; 100000 is the documented maximum.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 100000,
              "default": 0
            },
            "example": 0
          }
        ],
        "responses": {
          "200": {
            "description": "The versions on this page with the package's CVEs.",
            "headers": {
              "X-VDB-Plan": {
                "$ref": "#/components/headers/X-VDB-Plan"
              },
              "RateLimit-DayLimit": {
                "$ref": "#/components/headers/RateLimit-DayLimit"
              },
              "RateLimit-Remaining": {
                "$ref": "#/components/headers/RateLimit-Remaining"
              },
              "RateLimit-Reset": {
                "$ref": "#/components/headers/RateLimit-Reset"
              },
              "X-Softlimits": {
                "$ref": "#/components/headers/X-Softlimits"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPackageVulnsResponse"
                },
                "example": {
                  "packageName": "lodash",
                  "resolvedNames": [
                    "lodash"
                  ],
                  "resolvedMode": "exact",
                  "timestamp": 1762300800,
                  "totalCVEs": 3,
                  "total": 114,
                  "limit": 1,
                  "offset": 0,
                  "hasMore": true,
                  "versions": [
                    {
                      "version": "4.17.21",
                      "ecosystem": "",
                      "sources": [
                        "PackageVersion",
                        "cve_affected"
                      ],
                      "cveIds": [
                        "CVE-2021-23337",
                        "CVE-2020-28500",
                        "CVE-2020-8203"
                      ]
                    }
                  ],
                  "_links": [
                    {
                      "rel": "versions",
                      "href": "/v2/lodash/versions"
                    },
                    {
                      "rel": "product",
                      "href": "/v2/product/lodash"
                    },
                    {
                      "rel": "vulns",
                      "href": "/v2/lodash/vulns"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A parameter breaks a constraint in this document (pattern, length, bound or enum). The request validator answers this only when it runs in enforce mode; in its default log mode the request is served as each parameter describes (a too-large `limit` is clamped, an unknown `withVulnIntel` value is ignored). Body `{error, field}`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": "Query parameter 'limit' failed to validate",
                  "field": "limit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-codeSamples": [
          {
            "lang": "Shell",
            "label": "curl",
            "source": "curl -H \"Authorization: ApiKey $VULNESIS_ORG_ID:$VULNESIS_API_KEY\" 'https://api.vdb.vulnes.is/v2/lodash/vulns?limit=50'"
          },
          {
            "lang": "Shell",
            "label": "vulnetix CLI",
            "source": "vulnetix vdb vulns lodash --limit 50"
          }
        ],
        "x-vulnetix-plan": {
          "mode": "fields",
          "requiredPlan": "pro",
          "feature": "full-enrichment",
          "gatedFields": [
            "$.safeHarbour",
            "$.versions[*].safeHarbour"
          ]
        }
      }
    }
  },
  "tags": [
    {
      "name": "Authentication",
      "x-displayName": "Authentication",
      "description": "Exchange a SigV4-signed request for a session token or the static API key."
    },
    {
      "name": "Service",
      "x-displayName": "Service",
      "description": "This specification and its reference page."
    },
    {
      "name": "Vulnerabilities",
      "x-displayName": "Vulnerabilities",
      "description": "Advisory records, identifiers, timelines, affected products and OpenSSF Scorecards."
    },
    {
      "name": "Inputs",
      "x-displayName": "Inputs",
      "description": "Resolve a purl, CPE, TEI, SWID tag, CEL expression or package to the vulnerabilities it names."
    },
    {
      "name": "Remediation",
      "x-displayName": "Remediation",
      "description": "Fixed versions, distribution patches, source fixes, workarounds, advisories, CWE guidance and remediation plans."
    },
    {
      "name": "Exploit Intelligence",
      "x-displayName": "Exploit intelligence",
      "description": "Public exploits, proof-of-concept code, Nuclei templates and exploit trends."
    },
    {
      "name": "Threat Activity",
      "x-displayName": "IOCs, sightings and triage",
      "description": "In-the-wild sightings, indicators of compromise, threat actors and the score-driven triage feed."
    },
    {
      "name": "KEV",
      "x-displayName": "Known exploited vulnerabilities",
      "description": "CISA, ENISA, VulnCheck and Vulnesis known-exploited catalogues."
    },
    {
      "name": "AI Threat Intelligence",
      "x-displayName": "AI threat intelligence",
      "description": "Vulnerabilities found by AI systems, AI-assisted exploits and AI-generated malware."
    },
    {
      "name": "Detection Rules",
      "x-displayName": "Detection rules",
      "description": "Snort, Suricata and YARA rules and MITRE ATT&CK techniques linked to vulnerabilities."
    },
    {
      "name": "Defences",
      "x-displayName": "Virtual patches and countermeasures",
      "description": "Blocking rules and detection content derived from real exploits, by every input kind."
    },
    {
      "name": "VEX",
      "x-displayName": "VEX",
      "description": "Vulnerability Exploitability eXchange statements."
    },
    {
      "name": "Packages",
      "x-displayName": "Packages and products",
      "description": "Package and product versions, vulnerabilities, Safe Harbour versions and the package catalogue. Safe Harbour data is Pro and above, except for the packages on the free-demo allowlist (`GET /v2/packages/free-demo`), which every plan gets."
    },
    {
      "name": "Malware Intelligence",
      "x-displayName": "Malware intelligence",
      "description": "Malicious packages, campaigns and trends, with threat-actor attribution."
    },
    {
      "name": "SBOM Scanning",
      "x-displayName": "SBOM and manifest scanning",
      "description": "Scan a manifest, SPDX document or CycloneDX BOM for known vulnerabilities."
    },
    {
      "name": "End-of-Life",
      "x-displayName": "End of life",
      "description": "Product release lifecycles and end-of-life dates."
    },
    {
      "name": "MSRC Patch Tuesday",
      "x-displayName": "Microsoft Patch Tuesday",
      "description": "Microsoft Security Response Center Patch Tuesday releases."
    },
    {
      "name": "Vendor Archives",
      "x-displayName": "Vendor advisory archives",
      "description": "Monthly archives of vendor security advisories: Red Hat, Broadcom, AWS, Cisco, Alibaba, Cloudflare, SUSE, Canonical, Alpine, Apple and Google."
    },
    {
      "name": "Raw Archives",
      "x-displayName": "Raw upstream archives",
      "description": "The upstream advisory documents as Vulnesis fetched them. Teams and above."
    },
    {
      "name": "Enumerations",
      "x-displayName": "Enumerations",
      "description": "The values other operations accept: ecosystems, sources, metric and exploit types, fix distributions."
    },
    {
      "name": "Statistics",
      "x-displayName": "Statistics and trends",
      "description": "Database summaries and vendor and NVD trends."
    },
    {
      "name": "Cloud",
      "x-displayName": "Cloud resources",
      "description": "Cloud resource locators and CRIT records for vulnerabilities in cloud services."
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "description": "Static API key derived from your credentials: `Authorization: ApiKey <principalUuid>:<hex>`, where hex is `HMAC-SHA256(key = secret, message = principalUuid)`. Valid until the secret is rotated."
      },
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "A bearer token: either the session token (JWT, 15 minutes) issued by `GET /v2/auth/token` for a SigV4-signed request, or an API token you created in your Vulnesis identity account (Authentik), sent as is. Send `Authorization: Bearer <token>`."
      },
      "SigV4": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "description": "AWS Signature Version 4, HMAC-SHA256 or HMAC-SHA512, signed with your secret: `Authorization: AWS4-HMAC-SHA512 Credential=<principalUuid>/<YYYYMMDD>/us-east-1/vdb/aws4_request, SignedHeaders=x-amz-date, Signature=<hex>` (or `AWS4-HMAC-SHA256`), plus the `X-Amz-Date` header. Accepted only by the two Authentication operations."
      }
    },
    "schemas": {
      "APILink": {
        "type": "object",
        "description": "A link to a related API answer.",
        "required": [
          "rel",
          "href"
        ],
        "additionalProperties": false,
        "properties": {
          "rel": {
            "type": "string",
            "description": "The relation. Vulnerability answers link `info`, `vuln`, `timeline`, `affected`, `attack-techniques`, `exploits-archive`, `iocs`, `sightings`, `vex`, `nuclei`, `kev`, `advisories`, `scorecard`, `remediation-plan`, `cwe-guidance`, `workarounds`, `registry-fixes`, `distribution-patches`, `source-fixes`, `virtual-patches`, `countermeasures`, `snort-rules`, `yara-rules` and `exploits` (`fixes` on v1); package answers `versions`, `product`, `vulns` and `eol-product`; end-of-life answers `product`, `release` and `search`; searches `self`, `search`, `packages` and `identifiers`.",
            "enum": [
              "info",
              "vuln",
              "timeline",
              "affected",
              "attack-techniques",
              "exploits-archive",
              "iocs",
              "sightings",
              "vex",
              "nuclei",
              "kev",
              "advisories",
              "scorecard",
              "remediation-plan",
              "cwe-guidance",
              "workarounds",
              "registry-fixes",
              "distribution-patches",
              "source-fixes",
              "virtual-patches",
              "countermeasures",
              "fixes",
              "snort-rules",
              "yara-rules",
              "exploits",
              "versions",
              "product",
              "vulns",
              "eol-product",
              "release",
              "search",
              "self",
              "packages",
              "identifiers"
            ]
          },
          "href": {
            "type": "string",
            "minLength": 4,
            "maxLength": 4096,
            "description": "The path on this API host, version prefix included, with any query string.",
            "examples": [
              "/v2/vuln/CVE-2021-44228/kev"
            ]
          }
        }
      },
      "AffectedProduct": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vendor",
          "product",
          "packageName",
          "ecosystem",
          "collectionURL",
          "versions"
        ],
        "properties": {
          "vendor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512
          },
          "product": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512
          },
          "packageName": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512
          },
          "ecosystem": {
            "type": "string",
            "enum": [
              "",
              "npm",
              "pypi",
              "rubygems",
              "crates.io",
              "packagist",
              "nuget",
              "maven",
              "go",
              "hex",
              "cocoapods",
              "hackage",
              "cran",
              "generic"
            ],
            "description": "Derived from `collectionURL`; empty when the record has none."
          },
          "collectionURL": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048
          },
          "versions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AffectedVersion"
            }
          }
        }
      },
      "AffectedVersion": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "version",
          "status",
          "lessThan",
          "lessThanOrEqual",
          "versionType"
        ],
        "properties": {
          "version": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32
          },
          "lessThan": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "lessThanOrEqual": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "versionType": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 64
          }
        }
      },
      "AiAggCount": {
        "type": "object",
        "description": "A count for one group key.",
        "required": [
          "key",
          "count"
        ],
        "additionalProperties": false,
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 256,
            "description": "Group key; a null column value reads `(unknown)`."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          }
        }
      },
      "AiAssistedExploitItem": {
        "type": "object",
        "description": "One AI-assisted exploit demonstration, with the affected vendor and product joined from the vulnerability record.",
        "required": [
          "cveId",
          "source",
          "aiSystem",
          "aiPublisher",
          "researcherName",
          "researcherOrg",
          "exploitDate",
          "exploitDateMs",
          "success",
          "failureReason",
          "pocsInVdb",
          "cveOriginNote",
          "classification",
          "sourceUrl",
          "notes",
          "affectedVendor",
          "affectedProduct"
        ],
        "additionalProperties": false,
        "properties": {
          "cveId": {
            "type": "string",
            "description": "Vulnerability id the exploit targets."
          },
          "source": {
            "type": "string",
            "description": "Source of that vulnerability record."
          },
          "aiSystem": {
            "type": "string",
            "description": "AI system that wrote the exploit."
          },
          "aiPublisher": {
            "type": "string",
            "description": "Publisher of the AI system."
          },
          "researcherName": {
            "type": "string"
          },
          "researcherOrg": {
            "type": "string"
          },
          "exploitDate": {
            "type": "string",
            "format": "date",
            "description": "Demonstration date, `YYYY-MM-DD` UTC."
          },
          "exploitDateMs": {
            "type": "integer",
            "format": "int64",
            "description": "Demonstration date, Unix milliseconds."
          },
          "success": {
            "type": "boolean",
            "description": "Whether the AI produced a working exploit."
          },
          "failureReason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Why it failed, or null."
          },
          "pocsInVdb": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0,
            "description": "Proofs of concept for this vulnerability already in the database, or null."
          },
          "cveOriginNote": {
            "type": [
              "string",
              "null"
            ],
            "description": "How the vulnerability was originally found, or null."
          },
          "classification": {
            "type": [
              "string",
              "null"
            ],
            "description": "Exploit classification, or null."
          },
          "sourceUrl": {
            "type": "string",
            "description": "Where the demonstration was published."
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "affectedVendor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Affected vendor, or null."
          },
          "affectedProduct": {
            "type": [
              "string",
              "null"
            ],
            "description": "Affected product, or null."
          }
        }
      },
      "AiAssistedExploitOutcome": {
        "type": "object",
        "description": "One curated AI-assisted exploit demonstration.",
        "required": [
          "cveId",
          "affectedSoftware",
          "affectedVendor",
          "vulnType",
          "exploitDate",
          "aiSystem",
          "aiPublisher",
          "researcherName",
          "researcherOrg",
          "success",
          "sourceUrl"
        ],
        "additionalProperties": false,
        "properties": {
          "cveId": {
            "type": "string",
            "description": "Vulnerability id; a GHSA id, or a name for an academic class with no id."
          },
          "affectedSoftware": {
            "type": "string"
          },
          "affectedVendor": {
            "type": "string"
          },
          "vulnType": {
            "type": "string"
          },
          "exploitDate": {
            "type": "string",
            "format": "date",
            "description": "Publication date, `YYYY-MM-DD`."
          },
          "aiSystem": {
            "type": "string"
          },
          "aiPublisher": {
            "type": "string"
          },
          "researcherName": {
            "type": "string"
          },
          "researcherOrg": {
            "type": "string"
          },
          "success": {
            "type": "boolean"
          },
          "failureReason": {
            "type": "string",
            "description": "Why it failed. Absent on success."
          },
          "sourceUrl": {
            "type": "string",
            "format": "uri"
          },
          "notes": {
            "type": "string",
            "description": "Editorial notes. Absent when none."
          }
        }
      },
      "AiDiscoveredVulnOutcome": {
        "type": "object",
        "description": "A curated AI-discovered vulnerability and its exploitation signals at snapshot time.",
        "required": [
          "id",
          "idType",
          "affectedSoftware",
          "affectedVendor",
          "vulnType",
          "severity",
          "aiSystem",
          "aiOrg",
          "discoveryDate",
          "humanAssisted",
          "isKev",
          "hasExploit",
          "hasWeaponized",
          "exploitCount"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "description": "Vulnerability id as curated."
          },
          "idType": {
            "type": "string",
            "description": "Kind of identifier `id` is."
          },
          "affectedSoftware": {
            "type": "string"
          },
          "affectedVendor": {
            "type": "string"
          },
          "vulnType": {
            "type": "string"
          },
          "cvssAtDiscovery": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "CVSS base score at discovery. Absent when unknown."
          },
          "severity": {
            "type": "string"
          },
          "aiSystem": {
            "type": "string"
          },
          "aiOrg": {
            "type": "string"
          },
          "discoveryDate": {
            "type": "string",
            "description": "Discovery date as curated (normally `YYYY-MM-DD`)."
          },
          "humanAssisted": {
            "type": "boolean"
          },
          "isKev": {
            "type": "boolean",
            "description": "Listed in any known-exploited catalogue."
          },
          "kevSources": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 32,
              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,31}$",
              "description": "A KEV catalogue the vulnerability is in, as the catalogue names itself (CISA, vulnetix, enisa, vulncheck).",
              "examples": [
                "CISA",
                "vulnetix"
              ]
            },
            "maxItems": 4,
            "description": "Catalogues listing it. Absent when none."
          },
          "kevDateAddedMs": {
            "type": "integer",
            "format": "int64",
            "description": "Earliest date it was added to a catalogue, Unix milliseconds. Absent when not listed."
          },
          "hasExploit": {
            "type": "boolean",
            "description": "At least one public exploit is linked."
          },
          "hasWeaponized": {
            "type": "boolean",
            "description": "A weaponised exploit or a detection rule (Snort, Nuclei, Metasploit, NSE) is linked."
          },
          "exploitCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "exploitFirstSeenMs": {
            "type": "integer",
            "format": "int64",
            "description": "Earliest exploit publication, Unix milliseconds. Absent when there is none."
          },
          "weaponizedFirstSeenMs": {
            "type": "integer",
            "format": "int64",
            "description": "Earliest weaponised exploit publication, Unix milliseconds. Absent when there is none."
          },
          "epssScore": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1,
            "description": "Current EPSS probability. Absent when not scored."
          },
          "epssPercentile": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1,
            "description": "Current EPSS percentile. Absent when not scored."
          }
        }
      },
      "AiDiscoveredVulnsOutcomesAggregate": {
        "type": "object",
        "description": "Roll-ups over the curated list. `{}` when the snapshot lacks it; otherwise every key is present.",
        "additionalProperties": false,
        "properties": {
          "total": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "autonomous": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "humanAssisted": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "withKev": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "withExploit": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "withWeaponized": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "withEpss": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "avgEpss": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 1,
            "description": "Mean EPSS over the scored entries, or null when none is scored."
          },
          "bySystem": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiOutcomeNameCount"
            },
            "description": "Count per AI system, largest first."
          },
          "byOrg": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiOutcomeNameCount"
            },
            "description": "Count per AI organisation, largest first."
          },
          "byVendor": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiOutcomeNameCount"
            },
            "description": "Count per affected vendor, largest first."
          },
          "bySeverity": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiOutcomeNameCount"
            },
            "description": "Count per severity, largest first."
          }
        }
      },
      "AiDiscoveryAggregate": {
        "type": "object",
        "description": "Roll-ups over the whole filtered set, not the current page.",
        "required": [
          "total",
          "autonomous",
          "humanAssisted",
          "withCvss",
          "avgCvss",
          "earliestDateMs",
          "latestDateMs",
          "byOrg",
          "byOrgHumanAssisted",
          "byOrgSeverity",
          "bySeverity",
          "byHarness",
          "byAiSystem",
          "timeline"
        ],
        "additionalProperties": false,
        "properties": {
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Discoveries in the filtered set."
          },
          "autonomous": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Discoveries with no human assistance."
          },
          "humanAssisted": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Human-assisted discoveries."
          },
          "withCvss": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Discoveries with a CVSS score."
          },
          "avgCvss": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "Mean CVSS at discovery, or null when none has a score."
          },
          "earliestDateMs": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Earliest discovery date, Unix milliseconds; null when the set is empty."
          },
          "latestDateMs": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Latest discovery date, Unix milliseconds; null when the set is empty."
          },
          "byOrg": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiAggCount"
            },
            "description": "Count per AI organisation, largest first."
          },
          "byOrgHumanAssisted": {
            "type": [
              "array",
              "null"
            ],
            "description": "Autonomous and human-assisted counts per organisation, largest first. Null when the set is empty.",
            "items": {
              "type": "object",
              "required": [
                "aiOrg",
                "autonomous",
                "humanAssisted"
              ],
              "additionalProperties": false,
              "properties": {
                "aiOrg": {
                  "type": "string"
                },
                "autonomous": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0
                },
                "humanAssisted": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0
                }
              }
            }
          },
          "byOrgSeverity": {
            "type": [
              "array",
              "null"
            ],
            "description": "Count per organisation and severity; a missing severity reads `unknown`. Null when the set is empty.",
            "items": {
              "type": "object",
              "required": [
                "aiOrg",
                "severity",
                "count"
              ],
              "additionalProperties": false,
              "properties": {
                "aiOrg": {
                  "type": "string"
                },
                "severity": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0
                }
              }
            }
          },
          "bySeverity": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiAggCount"
            },
            "description": "Count per severity at discovery; a missing severity reads `(unknown)`."
          },
          "byHarness": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiAggCount"
            },
            "description": "Count per harness; a missing harness reads `(unknown)`."
          },
          "byAiSystem": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiAggCount"
            },
            "description": "Count per AI system."
          },
          "timeline": {
            "type": [
              "array",
              "null"
            ],
            "description": "Discoveries per discovery date, oldest first. Null when the set is empty.",
            "items": {
              "type": "object",
              "required": [
                "dateMs",
                "count"
              ],
              "additionalProperties": false,
              "properties": {
                "dateMs": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Discovery date, Unix milliseconds."
                },
                "count": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0
                }
              }
            }
          }
        }
      },
      "AiDiscoveryItem": {
        "type": "object",
        "description": "One AI-discovered vulnerability, with the affected vendor and product joined from the vulnerability record.",
        "required": [
          "displayId",
          "cveId",
          "source",
          "idType",
          "aiSystem",
          "aiOrg",
          "harness",
          "humanAssisted",
          "discoveryDate",
          "discoveryDateMs",
          "vulnType",
          "severity",
          "cvss",
          "sourceUrl",
          "notes",
          "researchers",
          "isNotable",
          "milestoneType",
          "affectedVendor",
          "affectedProduct"
        ],
        "additionalProperties": false,
        "properties": {
          "displayId": {
            "type": "string",
            "description": "Identifier to display for the discovery."
          },
          "cveId": {
            "type": "string",
            "description": "Vulnerability id the discovery is recorded against."
          },
          "source": {
            "type": "string",
            "description": "Source of that vulnerability record."
          },
          "idType": {
            "type": "string",
            "description": "Kind of identifier `displayId` is."
          },
          "aiSystem": {
            "type": "string",
            "description": "AI system credited with the discovery."
          },
          "aiOrg": {
            "type": "string",
            "description": "Organisation behind the AI system."
          },
          "harness": {
            "type": [
              "string",
              "null"
            ],
            "description": "Discovery harness, or null."
          },
          "humanAssisted": {
            "type": "boolean",
            "description": "True when a human assisted; false when fully autonomous."
          },
          "discoveryDate": {
            "type": "string",
            "format": "date",
            "description": "Discovery date, `YYYY-MM-DD` UTC."
          },
          "discoveryDateMs": {
            "type": "integer",
            "format": "int64",
            "description": "Discovery date, Unix milliseconds."
          },
          "vulnType": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vulnerability type, or null."
          },
          "severity": {
            "type": [
              "string",
              "null"
            ],
            "description": "Severity at discovery (lower case), or null."
          },
          "cvss": {
            "type": [
              "number",
              "null"
            ],
            "format": "float",
            "minimum": 0,
            "maximum": 10,
            "description": "CVSS base score at discovery, or null."
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Where the discovery was reported, or null."
          },
          "notes": {
            "type": [
              "string",
              "null"
            ],
            "description": "Editorial notes, or null."
          },
          "researchers": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Named researchers in credit order. `[]` when none."
          },
          "isNotable": {
            "type": "boolean",
            "description": "True when editorially notable."
          },
          "milestoneType": {
            "type": [
              "string",
              "null"
            ],
            "description": "Milestone tag, or null."
          },
          "affectedVendor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Affected vendor, or null when the vulnerability record has none."
          },
          "affectedProduct": {
            "type": [
              "string",
              "null"
            ],
            "description": "Affected product, or null when the vulnerability record has none."
          }
        }
      },
      "AiDiscoveryMarker": {
        "type": "object",
        "description": "A notable or milestone-tagged discovery, for a reference line on the timeline chart.",
        "required": [
          "displayId",
          "cveId",
          "source",
          "idType",
          "aiOrg",
          "aiSystem",
          "vulnType",
          "date",
          "dateMs",
          "markerType",
          "isNotable",
          "affectedVendor",
          "affectedProduct"
        ],
        "additionalProperties": false,
        "properties": {
          "displayId": {
            "type": "string"
          },
          "cveId": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "idType": {
            "type": "string"
          },
          "aiOrg": {
            "type": "string"
          },
          "aiSystem": {
            "type": "string"
          },
          "vulnType": {
            "type": [
              "string",
              "null"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Discovery date, `YYYY-MM-DD` UTC."
          },
          "dateMs": {
            "type": "integer",
            "format": "int64",
            "description": "Discovery date, Unix milliseconds."
          },
          "markerType": {
            "type": [
              "string",
              "null"
            ],
            "description": "The milestone tag, or `notable` for a notable discovery with no milestone tag."
          },
          "isNotable": {
            "type": "boolean"
          },
          "affectedVendor": {
            "type": [
              "string",
              "null"
            ]
          },
          "affectedProduct": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "AiDiscoveryTagValue": {
        "type": "string",
        "description": "An AI organisation, AI system or harness name as stored: starts with a letter or digit, then letters, digits, spaces and `. _ @ + # , / ( ) -`.",
        "minLength": 1,
        "maxLength": 256,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9 ._@+#,/()-]{0,255}$",
        "examples": [
          "Google",
          "Big Sleep (Gemini 1.5 Pro)",
          "Claude / AISLE"
        ]
      },
      "AiFeedBareFailure": {
        "type": "object",
        "description": "The body some AI feed handlers write when the answer cannot be encoded: `success` only, no message.",
        "required": [
          "success"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "AiGeneratedMalwareItem": {
        "type": "object",
        "description": "One AI-generated malware family. Not necessarily tied to a CVE.",
        "required": [
          "name",
          "actor",
          "aiSystem",
          "aiUseMode",
          "publishedBy",
          "publishedDate",
          "publishedDateMs",
          "description",
          "sourceUrl",
          "sourceLabel",
          "associatedIds"
        ],
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "description": "Malware family name."
          },
          "actor": {
            "type": "string",
            "description": "Threat actor."
          },
          "aiSystem": {
            "type": "string",
            "description": "AI system involved."
          },
          "aiUseMode": {
            "type": "string",
            "description": "How the AI is used (for example written with AI, or calling a model at run time)."
          },
          "publishedBy": {
            "type": "string",
            "description": "Who reported it."
          },
          "publishedDate": {
            "type": "string",
            "format": "date",
            "description": "Publication date, `YYYY-MM-DD` UTC."
          },
          "publishedDateMs": {
            "type": "integer",
            "format": "int64",
            "description": "Publication date, Unix milliseconds."
          },
          "description": {
            "type": "string"
          },
          "sourceUrl": {
            "type": "string"
          },
          "sourceLabel": {
            "type": "string"
          },
          "associatedIds": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Related identifiers (vulnerability or IOC ids). Null when there are none or the stored list does not parse."
          }
        }
      },
      "AiInWildExploitationItem": {
        "type": "object",
        "description": "One observed AI-authored exploitation in the wild, with the affected vendor and product joined from the vulnerability record.",
        "required": [
          "cveId",
          "source",
          "observedBy",
          "advisoryDate",
          "advisoryDateMs",
          "timeToExploit",
          "aiFingerprint",
          "aiSystemSuspected",
          "sourceUrl",
          "sourceLabel",
          "notes",
          "affectedVendor",
          "affectedProduct"
        ],
        "additionalProperties": false,
        "properties": {
          "cveId": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "observedBy": {
            "type": "string",
            "description": "Who observed the exploitation."
          },
          "advisoryDate": {
            "type": "string",
            "format": "date",
            "description": "Advisory date, `YYYY-MM-DD` UTC."
          },
          "advisoryDateMs": {
            "type": "integer",
            "format": "int64",
            "description": "Advisory date, Unix milliseconds."
          },
          "timeToExploit": {
            "type": "string",
            "description": "Observed time from disclosure to exploitation."
          },
          "aiFingerprint": {
            "type": "string",
            "description": "The evidence of AI authorship."
          },
          "aiSystemSuspected": {
            "type": [
              "string",
              "null"
            ],
            "description": "Suspected AI system, or null."
          },
          "sourceUrl": {
            "type": "string"
          },
          "sourceLabel": {
            "type": "string"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "affectedVendor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Affected vendor, or null."
          },
          "affectedProduct": {
            "type": [
              "string",
              "null"
            ],
            "description": "Affected product, or null."
          }
        }
      },
      "AiOutcomeNameCount": {
        "type": "object",
        "required": [
          "name",
          "count"
        ],
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string"
          },
          "count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "AlibabaArchiveAdvisory": {
        "type": "object",
        "description": "One Alibaba advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "alinux2"
            ],
            "description": "Which Alibaba advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "AlpineArchiveAdvisory": {
        "type": "object",
        "description": "One Alpine advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "docker-hub-alpine",
              "chainguard-images",
              "wolfi-images",
              "redhat-hardened",
              "aports"
            ],
            "description": "Which Alpine advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "AlpineRegistryStat": {
        "type": "object",
        "description": "One container registry and the advisories attributed to its images.",
        "additionalProperties": false,
        "required": [
          "slug",
          "displayName",
          "advisoryCount",
          "last30Days",
          "last90Days",
          "last365Days"
        ],
        "properties": {
          "slug": {
            "type": "string",
            "maxLength": 128,
            "description": "Registry slug, for example `docker-hub-alpine`, `chainguard-images`, `wolfi-images`, `redhat-hardened`."
          },
          "displayName": {
            "type": "string",
            "maxLength": 256
          },
          "homepageURL": {
            "type": "string",
            "maxLength": 2048,
            "description": "Omitted when none is recorded."
          },
          "hardeningProfile": {
            "type": "string",
            "maxLength": 256,
            "description": "Omitted when none is recorded."
          },
          "description": {
            "type": "string",
            "maxLength": 4096,
            "description": "Omitted when none is recorded."
          },
          "pullReference": {
            "type": "string",
            "maxLength": 1024,
            "description": "Omitted when none is recorded."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Advisory attributions to the registry's images."
          },
          "last30Days": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Attributions last seen in the past 30 days."
          },
          "last90Days": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Attributions last seen in the past 90 days."
          },
          "last365Days": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Attributions last seen in the past 365 days."
          }
        }
      },
      "AppleArchiveAdvisory": {
        "type": "object",
        "description": "One Apple advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "macos",
              "ios",
              "ipados",
              "tvos",
              "watchos",
              "visionos",
              "safari",
              "xcode",
              "other"
            ],
            "description": "Which Apple advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "AttackTechnique": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "subtechnique"
        ],
        "description": "An ATT&CK technique mapped to the vulnerability, merged across sources. Empty optional fields are absent.",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 16,
            "description": "Technique id (`T1190`, or `T1059.001` for a sub-technique)."
          },
          "name": {
            "type": "string",
            "maxLength": 256
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "domain": {
            "type": "string",
            "maxLength": 32,
            "description": "ATT&CK domain (for example `Enterprise`)."
          },
          "subtechnique": {
            "type": "boolean"
          },
          "tactics": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Tactics in kebab-case (`initial-access`)."
          },
          "capecId": {
            "type": "string",
            "maxLength": 16,
            "description": "CAPEC id the mapping came through (`CAPEC-242`)."
          },
          "derivedBy": {
            "type": "string",
            "maxLength": 64,
            "description": "Provenance; `vulnetix` marks an AI-derived mapping."
          },
          "_sources": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "The record sources that carry this mapping, sorted."
          },
          "mitigations": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "$ref": "#/components/schemas/AttackTechniqueMitigation"
            }
          },
          "detections": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "$ref": "#/components/schemas/AttackTechniqueDetection"
            }
          },
          "d3fend": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "$ref": "#/components/schemas/AttackTechniqueD3fend"
            }
          }
        }
      },
      "AttackTechniqueD3fend": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "description": "A D3FEND counter-technique.",
        "properties": {
          "mitigationId": {
            "type": "string",
            "maxLength": 32,
            "description": "The mitigation the counter-technique implements."
          },
          "id": {
            "type": "string",
            "maxLength": 64,
            "description": "D3FEND id (for example `D3-NTA`)."
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "AttackTechniqueDetection": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "description": "A MITRE detection for the technique.",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 64,
            "description": "Detection id (for example `DS0015`)."
          },
          "datasource": {
            "type": "string",
            "maxLength": 256
          },
          "detects": {
            "type": "string",
            "maxLength": 8192
          }
        }
      },
      "AttackTechniqueMitigation": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "description": "A MITRE mitigation for the technique.",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 32,
            "description": "Mitigation id (for example `M1050`)."
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "description": {
            "type": "string",
            "maxLength": 8192
          }
        }
      },
      "AttackTechniqueSearchRow": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "uuid",
          "cveId",
          "source",
          "id",
          "subtechnique"
        ],
        "description": "One stored technique mapping (one row per vulnerability and source, not merged). Child rows always carry every key; a missing value is the empty string.",
        "properties": {
          "uuid": {
            "$ref": "#/components/schemas/Uuid"
          },
          "cveId": {
            "type": "string",
            "maxLength": 226,
            "description": "The vulnerability the mapping is attached to."
          },
          "source": {
            "type": "string",
            "maxLength": 64,
            "description": "The record source the mapping is keyed under."
          },
          "id": {
            "type": "string",
            "maxLength": 16,
            "description": "Technique id."
          },
          "name": {
            "type": "string",
            "maxLength": 256
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "domain": {
            "type": "string",
            "maxLength": 32
          },
          "subtechnique": {
            "type": "boolean"
          },
          "tactics": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "type": "string",
              "maxLength": 64
            }
          },
          "capecId": {
            "type": "string",
            "maxLength": 16
          },
          "derivedBy": {
            "type": "string",
            "maxLength": 64
          },
          "mitigations": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/AttackTechniqueMitigation"
                },
                {
                  "required": [
                    "id",
                    "url",
                    "description"
                  ]
                }
              ]
            },
            "description": "Sorted by id."
          },
          "detections": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/AttackTechniqueDetection"
                },
                {
                  "required": [
                    "id",
                    "datasource",
                    "detects"
                  ]
                }
              ]
            },
            "description": "Sorted by id."
          },
          "d3fend": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/AttackTechniqueD3fend"
                },
                {
                  "required": [
                    "mitigationId",
                    "id",
                    "url"
                  ]
                }
              ]
            },
            "description": "Sorted by id."
          }
        }
      },
      "AwsArchiveAdvisory": {
        "type": "object",
        "description": "One AWS advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "alas-al1",
              "alas-al2",
              "alas-al2023",
              "aws-bulletin",
              "aws-sdk"
            ],
            "description": "Which AWS advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "BroadcomArchiveAdvisory": {
        "type": "object",
        "description": "One Broadcom advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "vmsa",
              "bitnami",
              "cloudfoundry-tanzu"
            ],
            "description": "Which Broadcom advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "csafUrl": {
            "type": "string",
            "maxLength": 2048,
            "description": "VMSA only: link to the raw VMSA document on vulnes.is. Omitted for Bitnami and Cloud Foundry / Tanzu."
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "CVEListV5AdpContainer": {
        "type": "object",
        "description": "An ADP container. The Vulnesis enrichment container carries the `x_` keys below, each present only when there is data for it; containers copied from the stored record carry their own keys.",
        "maxProperties": 64,
        "properties": {
          "providerMetadata": {
            "type": "object",
            "maxProperties": 8,
            "properties": {
              "orgId": {
                "type": "string",
                "maxLength": 64
              },
              "shortName": {
                "type": "string",
                "maxLength": 128
              }
            }
          },
          "title": {
            "type": "string",
            "maxLength": 4096
          },
          "metrics": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 16
            }
          },
          "x_generatorVersion": {
            "type": "string",
            "maxLength": 16
          },
          "x_generatedAt": {
            "type": "string",
            "maxLength": 40,
            "description": "When the record was built, RFC 3339."
          },
          "x_enrichmentSource": {
            "type": "string",
            "maxLength": 128
          },
          "x_dataSource": {
            "type": "string",
            "maxLength": 64,
            "description": "The source this record came from."
          },
          "x_dataCollected": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "type": "string",
              "enum": [
                "descriptions",
                "problem_types",
                "metrics",
                "affected",
                "crit",
                "cloud_locators",
                "purls",
                "references",
                "taxonomy_mappings",
                "attack_paths",
                "impacts",
                "affected_functions",
                "advisory",
                "ai_analyses",
                "affected_routines",
                "treeSitterQueries",
                "adp",
                "epss",
                "cess",
                "kev",
                "aliases",
                "scorecard",
                "ssvc",
                "exploitation_maturity",
                "attack_surface",
                "threat_exposure",
                "remediation_timeline"
              ]
            },
            "description": "Which enrichment kinds this record carries."
          },
          "x_epss": {
            "type": "object",
            "required": [
              "score"
            ],
            "additionalProperties": false,
            "properties": {
              "score": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "percentile": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": 0,
                "maximum": 1
              },
              "date": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 40
              },
              "modelVersion": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              }
            }
          },
          "x_cess": {
            "type": "object",
            "required": [
              "score"
            ],
            "additionalProperties": false,
            "properties": {
              "score": {
                "type": "number",
                "minimum": 0,
                "maximum": 100
              },
              "probabilityExploitUsage": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": 0,
                "maximum": 1
              },
              "date": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 40
              },
              "modelVersion": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              }
            }
          },
          "x_kev": {
            "type": "object",
            "description": "The first known-exploited listing, with every listing source.",
            "additionalProperties": false,
            "properties": {
              "source": {
                "type": "string",
                "maxLength": 64
              },
              "vendorProject": {
                "type": "string",
                "maxLength": 512
              },
              "product": {
                "type": "string",
                "maxLength": 512
              },
              "vulnerabilityName": {
                "type": "string",
                "maxLength": 1024
              },
              "dateAdded": {
                "type": "string",
                "maxLength": 40
              },
              "shortDescription": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 8192
              },
              "requiredAction": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 8192
              },
              "dueDate": {
                "type": "string",
                "maxLength": 40
              },
              "knownRansomwareCampaignUse": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 32
              },
              "notes": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 8192
              },
              "cwes": {
                "description": "The listing's CWE ids as stored (normally an array of strings)."
              },
              "sources": {
                "type": "array",
                "maxItems": 16,
                "items": {
                  "type": "string",
                  "maxLength": 64
                }
              }
            }
          },
          "x_aliases": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "required": [
                "cveId",
                "source"
              ],
              "additionalProperties": false,
              "properties": {
                "cveId": {
                  "type": "string",
                  "maxLength": 226
                },
                "source": {
                  "type": "string",
                  "maxLength": 64
                },
                "state": {
                  "type": "string",
                  "maxLength": 32
                },
                "title": {
                  "type": "string",
                  "maxLength": 4096
                },
                "datePublished": {
                  "type": "string",
                  "maxLength": 40
                }
              }
            }
          },
          "x_scorecard": {
            "type": "object",
            "required": [
              "repository",
              "overallScore"
            ],
            "additionalProperties": false,
            "properties": {
              "repository": {
                "type": "string",
                "maxLength": 512
              },
              "overallScore": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": -1,
                "maximum": 10
              },
              "date": {
                "type": "string",
                "maxLength": 40
              },
              "scorecardVersion": {
                "type": "string",
                "maxLength": 64
              },
              "repositoryCommit": {
                "type": "string",
                "maxLength": 64
              }
            }
          },
          "x_ssvc": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "methodology": {
                "type": "string",
                "enum": [
                  "CISA Coordinator"
                ]
              },
              "version": {
                "type": "string",
                "enum": [
                  "2.0"
                ]
              },
              "decision": {
                "type": "string",
                "enum": [
                  "Act",
                  "Attend",
                  "Track*",
                  "Track"
                ]
              },
              "priority": {
                "type": "string",
                "enum": [
                  "immediate",
                  "high",
                  "medium",
                  "low"
                ]
              },
              "inputs": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "exploitation": {
                    "type": "string",
                    "enum": [
                      "NONE",
                      "POC",
                      "ACTIVE"
                    ]
                  },
                  "automatable": {
                    "type": "string",
                    "enum": [
                      "YES",
                      "NO"
                    ]
                  },
                  "technicalImpact": {
                    "type": "string",
                    "enum": [
                      "PARTIAL",
                      "TOTAL"
                    ]
                  },
                  "missionWellbeingImpact": {
                    "type": "string",
                    "enum": [
                      "LOW",
                      "MEDIUM",
                      "HIGH"
                    ]
                  }
                }
              },
              "evaluatedAt": {
                "type": "string",
                "maxLength": 40
              }
            }
          },
          "x_exploitationMaturity": {
            "type": "object",
            "maxProperties": 8,
            "description": "`score`, `level`, `confidence` and `factors`."
          },
          "x_attackSurface": {
            "type": "object",
            "maxProperties": 8,
            "description": "`score`, `exposureLevel`, `factors` and `reasoning`."
          },
          "x_threatExposure": {
            "type": "object",
            "maxProperties": 16,
            "description": "`score`, `level`, `rules`, `forcedBy`, `amplified`, `amplifierMultiplier` and `malwareOverride`."
          },
          "x_remediationTimeline": {
            "type": "object",
            "maxProperties": 16,
            "description": "`currentAgeDays`, `publicationToKevDays`, `publicationToFirstExploitDays`, `publicationToFirstPatchDays`, `lifecycleStage`, `milestones` and `insights`."
          },
          "x_purls": {
            "type": "array",
            "maxItems": 10000,
            "items": {
              "type": "string",
              "maxLength": 4096
            }
          },
          "x_crit": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 64,
              "description": "A CRIT cloud resource record."
            }
          },
          "x_cloudLocators": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "object",
              "maxProperties": 8
            }
          },
          "x_attackPaths": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 32
            }
          },
          "impacts": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 16
            }
          },
          "x_affectedFunctions": {
            "type": "array",
            "maxItems": 10000,
            "items": {
              "type": "string",
              "maxLength": 1024
            }
          },
          "x_advisory": {
            "type": "string",
            "maxLength": 1048576
          },
          "x_aiAnalyses": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "maxProperties": 32
            }
          },
          "x_affectedRoutines": {
            "type": "array",
            "maxItems": 10000,
            "items": {
              "description": "A routine or file: an object as the CNA record gives it (programRoutines, programFiles), or a bare function name from the Vulnesis affected-functions data.",
              "oneOf": [
                {
                  "type": "object",
                  "maxProperties": 16
                },
                {
                  "type": "string",
                  "maxLength": 1024
                }
              ]
            }
          },
          "x_treeSitterQueries": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 16
            }
          },
          "tags": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 16,
            "items": {
              "type": "string",
              "enum": [
                "x_actively-exploited",
                "disputed",
                "x_rejected",
                "x_ai-analyzed",
                "x_high-epss",
                "x_critical-severity",
                "x_high-severity",
                "x_unsupported"
              ]
            }
          }
        }
      },
      "CVEListV5CnaContainer": {
        "type": "object",
        "description": "The CNA container: the stored record's, with descriptions, problem types, metrics, affected products, references, solutions, credits, taxonomy mappings and a timeline merged in from the database. Keys of the stored record this schema does not list are passed through.",
        "required": [
          "providerMetadata",
          "title",
          "descriptions",
          "affected",
          "references"
        ],
        "maxProperties": 64,
        "properties": {
          "providerMetadata": {
            "type": "object",
            "maxProperties": 8,
            "properties": {
              "orgId": {
                "type": "string",
                "maxLength": 64
              },
              "shortName": {
                "type": "string",
                "maxLength": 128
              },
              "dateUpdated": {
                "type": "string",
                "maxLength": 40
              }
            }
          },
          "title": {
            "type": "string",
            "maxLength": 4096
          },
          "descriptions": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 8,
              "properties": {
                "lang": {
                  "type": "string",
                  "maxLength": 16
                },
                "value": {
                  "type": "string",
                  "maxLength": 1048576
                }
              }
            }
          },
          "problemTypes": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 8,
              "properties": {
                "descriptions": {
                  "type": "array",
                  "maxItems": 100000,
                  "items": {
                    "type": "object",
                    "maxProperties": 16,
                    "properties": {
                      "type": {
                        "type": "string",
                        "maxLength": 32
                      },
                      "lang": {
                        "type": "string",
                        "maxLength": 16
                      },
                      "description": {
                        "type": "string",
                        "maxLength": 4096
                      },
                      "cweId": {
                        "type": "string",
                        "maxLength": 32
                      }
                    }
                  }
                }
              }
            }
          },
          "metrics": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 16,
              "description": "One metric: a `cvssV4_0`, `cvssV3_1`, `cvssV3_0` or `cvssV2_0` object (`version`, `vectorString`, `baseScore`, `baseSeverity`, `source`), optionally `scenarios`, or another metric kind from the stored record."
            }
          },
          "affected": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10000,
            "items": {
              "type": "object",
              "maxProperties": 64,
              "description": "An affected product (vendor, product, packageName, collectionURL, defaultStatus, versions, cpes and the rest of the CVE JSON 5 affected keys)."
            }
          },
          "references": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10000,
            "items": {
              "type": "object",
              "maxProperties": 16,
              "properties": {
                "url": {
                  "type": "string",
                  "maxLength": 4096
                },
                "name": {
                  "type": "string",
                  "maxLength": 4096
                },
                "tags": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "maxItems": 64,
                  "items": {
                    "type": "string",
                    "maxLength": 128
                  }
                }
              }
            }
          },
          "solutions": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 16
            }
          },
          "workarounds": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 16
            }
          },
          "credits": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 16
            }
          },
          "taxonomyMappings": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "object",
              "maxProperties": 16
            }
          },
          "timeline": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "object",
              "required": [
                "time",
                "lang",
                "value"
              ],
              "maxProperties": 8,
              "properties": {
                "time": {
                  "type": "string",
                  "maxLength": 40
                },
                "lang": {
                  "type": "string",
                  "maxLength": 16
                },
                "value": {
                  "type": "string",
                  "maxLength": 4096
                }
              }
            },
            "description": "Reservation, disclosure, KEV listing and last update, in time order."
          }
        }
      },
      "CVEListV5Record": {
        "type": "object",
        "description": "One source's record for a vulnerability as a CVE JSON 5 record, with the Vulnesis enrichment as an extra ADP container. When the source stored a CVE JSON 5 record its top-level keys are copied in verbatim, so keys this schema does not list can appear.",
        "required": [
          "dataType",
          "dataVersion",
          "cveMetadata",
          "containers"
        ],
        "maxProperties": 32,
        "properties": {
          "dataType": {
            "type": "string",
            "enum": [
              "CVE_RECORD"
            ]
          },
          "dataVersion": {
            "type": "string",
            "maxLength": 16,
            "description": "`5.1` for a record built here; the stored record's own value when one was copied in."
          },
          "cveMetadata": {
            "type": "object",
            "required": [
              "cveId",
              "assignerOrgId",
              "state"
            ],
            "maxProperties": 32,
            "properties": {
              "cveId": {
                "type": "string",
                "maxLength": 226
              },
              "assignerOrgId": {
                "type": "string",
                "maxLength": 64,
                "description": "The assigning CNA's org id; the Vulnesis org id when the source names none."
              },
              "assignerShortName": {
                "type": "string",
                "maxLength": 128
              },
              "state": {
                "type": "string",
                "maxLength": 32,
                "description": "PUBLISHED unless the source says otherwise (REJECTED, DISPUTED and the like)."
              },
              "datePublished": {
                "type": "string",
                "maxLength": 40,
                "description": "RFC 3339."
              },
              "dateUpdated": {
                "type": "string",
                "maxLength": 40,
                "description": "RFC 3339."
              },
              "dateReserved": {
                "type": "string",
                "maxLength": 40,
                "description": "RFC 3339."
              }
            }
          },
          "containers": {
            "type": "object",
            "required": [
              "cna",
              "adp"
            ],
            "maxProperties": 8,
            "properties": {
              "cna": {
                "$ref": "#/components/schemas/CVEListV5CnaContainer"
              },
              "adp": {
                "type": "array",
                "maxItems": 64,
                "items": {
                  "$ref": "#/components/schemas/CVEListV5AdpContainer"
                },
                "description": "The source's own ADP containers, then the Vulnesis enrichment container (`providerMetadata.shortName` `VVD`) and any ADP containers built from stored ADP metrics."
              }
            }
          },
          "x_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability. Present on GET /vuln/{identifier}, absent on GET /gcve records."
          }
        }
      },
      "CanonicalArchiveAdvisory": {
        "type": "object",
        "description": "One Canonical advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "usn"
            ],
            "description": "Which Canonical advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "Cel": {
        "type": "string",
        "description": "A TEA Insights predicate over productId, product and component, in the TEA Explorer dialect. At most 4 KiB.",
        "minLength": 1,
        "maxLength": 4096,
        "examples": [
          "component.name == \"lodash\""
        ]
      },
      "CessData": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "score",
          "probabilityExploitUsage",
          "date"
        ],
        "properties": {
          "score": {
            "type": "number",
            "minimum": 0,
            "maximum": 10,
            "description": "Coalition Exploit Scoring System score (0-10)."
          },
          "probabilityExploitUsage": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1
          },
          "date": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The CESS scoring date."
          }
        },
        "description": "The latest CESS score."
      },
      "ChannelAction": {
        "type": "object",
        "description": "A per-channel action: label, command, link, verification and rollback.",
        "required": [
          "label",
          "verification",
          "rollback"
        ],
        "additionalProperties": false,
        "properties": {
          "label": {
            "type": "string"
          },
          "command": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "verification": {
            "type": "string",
            "description": "Shifted by `topology`."
          },
          "rollback": {
            "type": "string"
          }
        }
      },
      "CiscoArchiveAdvisory": {
        "type": "object",
        "description": "One Cisco advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "psirt"
            ],
            "description": "Which Cisco advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "CloudLocatorResult": {
        "type": [
          "object",
          "null"
        ],
        "description": "Cloud-native resource identifier templates for a vendor and product. Null when no cloud service maps to the pair.",
        "required": [
          "matched"
        ],
        "additionalProperties": false,
        "properties": {
          "matched": {
            "type": "boolean",
            "description": "Always true when the object is present."
          },
          "provider": {
            "type": "string",
            "description": "The cloud provider.",
            "enum": [
              "aws",
              "azure",
              "gcp",
              "cloudflare",
              "oracle",
              "salesforce",
              "sap",
              "servicenow"
            ]
          },
          "service": {
            "type": "string",
            "maxLength": 512,
            "description": "The normalised product or service name."
          },
          "templates": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "object",
              "required": [
                "provider",
                "format",
                "template",
                "region"
              ],
              "additionalProperties": false,
              "properties": {
                "provider": {
                  "type": "string",
                  "maxLength": 32
                },
                "format": {
                  "type": "string",
                  "description": "Identifier format. Salesforce, SAP and ServiceNow templates use the CRIT dictionary's format names.",
                  "enum": [
                    "arn",
                    "resource-id",
                    "resource-name",
                    "resource-locator",
                    "ocid",
                    "salesforce_url",
                    "sap_btp_url",
                    "sap_odata_url",
                    "sap_sf_url",
                    "servicenow_table_url"
                  ]
                },
                "template": {
                  "type": "string",
                  "maxLength": 1024,
                  "description": "The identifier with `{placeholders}`."
                },
                "region": {
                  "type": "string",
                  "maxLength": 64,
                  "description": "`*` or `{region}` for a regional service, a fixed region for a global-only one, empty when the identifier has no region."
                },
                "regionNote": {
                  "type": "string",
                  "maxLength": 256
                },
                "servicePrefix": {
                  "type": "string",
                  "maxLength": 128,
                  "description": "AWS service prefix."
                },
                "namespace": {
                  "type": "string",
                  "maxLength": 256,
                  "description": "Azure provider namespace."
                },
                "resourceType": {
                  "type": "string",
                  "maxLength": 256
                }
              }
            }
          }
        }
      },
      "CloudflareArchiveAdvisory": {
        "type": "object",
        "description": "One Cloudflare advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "ghsa",
              "blog",
              "changelog"
            ],
            "description": "Which Cloudflare advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "CountDefencesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "tier",
          "timestamp",
          "total",
          "items"
        ],
        "properties": {
          "schemaVersion": {
            "type": "string",
            "enum": [
              "defence-counts/v1"
            ]
          },
          "tier": {
            "type": "string",
            "enum": [
              "community",
              "pro",
              "teams",
              "business",
              "enterprise"
            ],
            "description": "The caller's plan slug as the subscription records it (`business` ranks with `teams`)."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9999999999,
            "description": "Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 100,
            "description": "Items answered (the number sent)."
          },
          "items": {
            "type": "array",
            "minItems": 1,
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/DefenceCountsResult"
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "CountermeasureKind": {
        "type": "string",
        "enum": [
          "SIGMA",
          "YARA",
          "STIX",
          "OPENIOC"
        ],
        "description": "The output format of a countermeasure."
      },
      "CountermeasureKindList": {
        "type": "string",
        "maxLength": 256,
        "pattern": "^(?:SIGMA|YARA|STIX|OPENIOC|sigma|yara|stix|openioc)(?:, ?(?:SIGMA|YARA|STIX|OPENIOC|sigma|yara|stix|openioc)){0,15}$",
        "description": "One kind, or several separated by commas. Matched case-insensitively; upper and lower case are both accepted here."
      },
      "CountermeasureRecord": {
        "type": "object",
        "description": "One countermeasure. Optional keys are left out when the record has no value for them.",
        "additionalProperties": false,
        "required": [
          "uuid",
          "artifactId",
          "kind",
          "title",
          "rawText",
          "exploitUuid",
          "archiveUrl",
          "consoleUrl",
          "createdAt"
        ],
        "properties": {
          "uuid": {
            "type": "string",
            "maxLength": 64,
            "description": "The defence's id; use it with the archive route."
          },
          "artifactId": {
            "type": "string",
            "maxLength": 256,
            "description": "Deterministic natural key, `vulnetix-vp-<exploitUuid>-<kind>` or `vulnetix-cm-<exploitUuid>-<kind>`."
          },
          "kind": {
            "$ref": "#/components/schemas/CountermeasureKind"
          },
          "title": {
            "type": "string",
            "maxLength": 1024
          },
          "description": {
            "type": "string",
            "maxLength": 65536
          },
          "confidence": {
            "type": "string",
            "maxLength": 16,
            "description": "HIGH, MEDIUM or LOW."
          },
          "deployMode": {
            "type": "string",
            "maxLength": 16,
            "description": "The mode this artifact is safe to start in (`log` or `block`). A recommendation about the artifact, never a record of what was deployed."
          },
          "falsePositiveRisk": {
            "type": "string",
            "maxLength": 16,
            "description": "HIGH, MEDIUM or LOW."
          },
          "coverageNotes": {
            "type": "string",
            "maxLength": 65536,
            "description": "What the rule catches and, explicitly, what it does not."
          },
          "mitreTechIds": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 32
            },
            "description": "MITRE ATT&CK technique ids."
          },
          "rawText": {
            "type": "string",
            "maxLength": 1048576,
            "description": "The rule body, verbatim. The whole list this record sits in is null below Pro, so a record that is present always carries its body."
          },
          "bodyContentHash": {
            "type": "string",
            "maxLength": 128,
            "description": "sha256 of the body, hex."
          },
          "fileSize": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 1073741824,
            "description": "Body size in bytes."
          },
          "exploitUuid": {
            "type": "string",
            "maxLength": 64,
            "description": "The ingested PoC exploit this defence was derived from."
          },
          "exploitId": {
            "type": "string",
            "maxLength": 256
          },
          "exploitSource": {
            "type": "string",
            "maxLength": 64,
            "description": "Source slug of the originating exploit, for example `exploit-db` or `github-poc`."
          },
          "exploitUrl": {
            "type": "string",
            "maxLength": 2048
          },
          "matchedCve": {
            "type": "string",
            "maxLength": 226,
            "description": "The lowest advisory id, among those the inputs resolved to, that this defence is linked to. Absent without inputs, and for a defence reached only through the software its exploit names."
          },
          "archiveUrl": {
            "type": "string",
            "maxLength": 128,
            "description": "Path to the rule body served as its own file: `/v2/countermeasures/{uuid}/archive`."
          },
          "consoleUrl": {
            "type": "string",
            "format": "uri",
            "maxLength": 256,
            "description": "Opens the defence in the console: `https://www.vulnes.is/resolve/countermeasures?dc=<uuid>#catalogue`."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "maxLength": 32
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "maxLength": 32
          }
        }
      },
      "Cpe": {
        "type": "string",
        "description": "A CPE 2.3 formatted string or a CPE 2.2 URI. Part must be a, o or h; vendor and product must be concrete.",
        "minLength": 6,
        "maxLength": 512,
        "pattern": "^cpe:(?:2\\.3:|/)[!-~]{1,500}$",
        "examples": [
          "cpe:2.3:a:apache:log4j:2.14.1:*:*:*:*:*:*:*"
        ]
      },
      "CritLookupMatch": {
        "type": "object",
        "description": "One vulnerability that affects the resource type. Keys without a value are absent; `view=slim` leaves out `exploit_references`, `exploit_summary`, `snort_rules`, `affected_products` and `malware`.",
        "required": [
          "vuln_id",
          "match_evidence",
          "crit",
          "crit_generated"
        ],
        "additionalProperties": false,
        "properties": {
          "vuln_id": {
            "type": "string",
            "maxLength": 226
          },
          "aliases": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "match_evidence": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "strategies",
              "crit_pre_exists",
              "confidence"
            ],
            "properties": {
              "strategies": {
                "type": "array",
                "maxItems": 2,
                "items": {
                  "type": "string",
                  "enum": [
                    "crit_record",
                    "alias_expansion"
                  ]
                }
              },
              "crit_pre_exists": {
                "type": "boolean"
              },
              "affected_matches": {
                "type": "array",
                "maxItems": 1000,
                "items": {
                  "type": "string",
                  "maxLength": 512
                }
              },
              "text_match_fields": {
                "type": "array",
                "maxItems": 16,
                "items": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "alias_of": {
                "type": "string",
                "maxLength": 226,
                "description": "The id whose alias carried the record, for `alias_expansion`."
              },
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium"
                ]
              }
            }
          },
          "crit": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/CritLookupRecord"
              },
              {
                "type": "null"
              }
            ],
            "description": "The CRIT record; null when the stored record could not be decoded."
          },
          "crit_generated": {
            "type": "boolean",
            "enum": [
              false
            ],
            "description": "Always false: records are no longer generated here."
          },
          "cve_metadata": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "state"
            ],
            "properties": {
              "state": {
                "type": "string",
                "maxLength": 32
              },
              "title": {
                "type": "string",
                "maxLength": 4096
              },
              "date_published": {
                "type": "string",
                "maxLength": 10,
                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
              },
              "vector_string": {
                "type": "string",
                "maxLength": 512
              }
            }
          },
          "kev": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "dateAdded"
            ],
            "properties": {
              "dateAdded": {
                "type": "string",
                "maxLength": 35
              },
              "dueDate": {
                "type": "string",
                "maxLength": 35
              },
              "knownRansomwareCampaignUse": {
                "type": "string",
                "maxLength": 32
              },
              "requiredAction": {
                "type": "string",
                "maxLength": 4096
              }
            }
          },
          "epss": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "score"
            ],
            "properties": {
              "score": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1
              },
              "percentile": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1
              },
              "date": {
                "type": "string",
                "maxLength": 35
              }
            }
          },
          "cvss_metrics": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "metric_type",
                "base_score"
              ],
              "properties": {
                "metric_type": {
                  "type": "string",
                  "maxLength": 32
                },
                "vector_string": {
                  "type": "string",
                  "maxLength": 512
                },
                "base_score": {
                  "type": "number",
                  "format": "double",
                  "minimum": 0,
                  "maximum": 10
                },
                "base_severity": {
                  "type": "string",
                  "maxLength": 16
                }
              }
            }
          },
          "description": {
            "type": "string",
            "maxLength": 65536
          },
          "exploit_summary": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "count"
            ],
            "properties": {
              "count": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 2147483647
              },
              "sources": {
                "type": "array",
                "maxItems": 6,
                "items": {
                  "type": "string",
                  "enum": [
                    "crowdsec",
                    "exploitdb",
                    "metasploit",
                    "nuclei",
                    "vulncheck-xdb",
                    "vulnerabilitylab"
                  ]
                },
                "description": "Where the exploit references come from, sorted."
              }
            }
          },
          "exploit_references": {
            "type": "array",
            "maxItems": 100000,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "maxLength": 4096
                },
                "reference_source": {
                  "type": "string",
                  "maxLength": 64
                },
                "exploit_db_id": {
                  "type": "string",
                  "maxLength": 32
                },
                "nuclei_path": {
                  "type": "string",
                  "maxLength": 1024
                },
                "vl_id": {
                  "type": "string",
                  "maxLength": 128
                }
              }
            }
          },
          "malware": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "totalSightings",
              "uniqueIPs",
              "isActive"
            ],
            "description": "CrowdSec sighting summary (despite the name, not malware).",
            "properties": {
              "totalSightings": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 2147483647
              },
              "uniqueIPs": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "firstSeen": {
                "type": "string",
                "maxLength": 35
              },
              "lastSeen": {
                "type": "string",
                "maxLength": 35
              },
              "isActive": {
                "type": "boolean",
                "description": "Last sighting within 30 days."
              },
              "topSourceCountries": {
                "type": "array",
                "maxItems": 300,
                "items": {
                  "type": "string",
                  "maxLength": 8
                }
              },
              "topTargetCountries": {
                "type": "array",
                "maxItems": 300,
                "items": {
                  "type": "string",
                  "maxLength": 8
                }
              },
              "mitreTechniques": {
                "type": "array",
                "maxItems": 1000,
                "items": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "behaviors": {
                "type": "array",
                "maxItems": 1000,
                "items": {
                  "type": "string",
                  "maxLength": 256
                }
              }
            }
          },
          "snort_rules": {
            "type": "array",
            "maxItems": 10,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "snortId",
                "msg"
              ],
              "properties": {
                "snortId": {
                  "type": "string",
                  "maxLength": 32
                },
                "msg": {
                  "type": "string",
                  "maxLength": 1024
                },
                "signatureSeverity": {
                  "type": "string",
                  "maxLength": 32
                }
              }
            }
          },
          "affected_products": {
            "type": "array",
            "maxItems": 10000,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "vendor",
                "product"
              ],
              "properties": {
                "vendor": {
                  "type": "string",
                  "maxLength": 512
                },
                "product": {
                  "type": "string",
                  "maxLength": 512
                },
                "default_status": {
                  "type": "string",
                  "maxLength": 32
                }
              }
            }
          },
          "problem_types": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "cwe_id"
              ],
              "properties": {
                "cwe_id": {
                  "type": "string",
                  "maxLength": 128
                },
                "description": {
                  "type": "string",
                  "maxLength": 1024
                }
              }
            }
          }
        }
      },
      "CritLookupRecord": {
        "type": "object",
        "description": "A CRIT record as vdb-manager minted it.",
        "required": [
          "vectorString",
          "vuln_id",
          "provider",
          "service",
          "resource_type",
          "template",
          "template_format",
          "resource_lifecycle",
          "shared_responsibility",
          "vex_status",
          "fix_propagation",
          "existing_deployments_remain_vulnerable",
          "remediation_actions"
        ],
        "additionalProperties": false,
        "properties": {
          "vectorString": {
            "type": "string",
            "maxLength": 512
          },
          "vuln_id": {
            "type": "string",
            "maxLength": 226
          },
          "provider": {
            "type": "string",
            "maxLength": 64
          },
          "service": {
            "type": "string",
            "maxLength": 64
          },
          "resource_type": {
            "type": "string",
            "maxLength": 129
          },
          "template": {
            "type": "string",
            "maxLength": 1024
          },
          "template_format": {
            "type": "string",
            "maxLength": 64
          },
          "resource_lifecycle": {
            "type": "string",
            "maxLength": 64
          },
          "shared_responsibility": {
            "type": "string",
            "maxLength": 64
          },
          "vex_status": {
            "type": "string",
            "maxLength": 64
          },
          "fix_propagation": {
            "type": "string",
            "maxLength": 64
          },
          "existing_deployments_remain_vulnerable": {
            "type": "boolean"
          },
          "temporal": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "service_available_date"
            ],
            "properties": {
              "service_available_date": {
                "type": "string",
                "maxLength": 35
              },
              "vulnerability_introduced_date": {
                "type": "string",
                "maxLength": 35
              },
              "vulnerability_introduced_date_estimated": {
                "type": "boolean"
              },
              "vuln_published_date": {
                "type": "string",
                "maxLength": 35
              },
              "provider_acknowledged_date": {
                "type": "string",
                "maxLength": 35
              },
              "provider_fix_date": {
                "type": "string",
                "maxLength": 35
              },
              "customer_deadline_date": {
                "type": "string",
                "maxLength": 35
              },
              "customer_deadline_source": {
                "type": "string",
                "maxLength": 128
              }
            }
          },
          "remediation_actions": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 64,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "sequence",
                "type",
                "title",
                "description",
                "auto_remediable",
                "requires_downtime",
                "compensating_control"
              ],
              "properties": {
                "sequence": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0,
                  "maximum": 1000
                },
                "type": {
                  "type": "string",
                  "maxLength": 64
                },
                "title": {
                  "type": "string",
                  "maxLength": 512
                },
                "description": {
                  "type": "string",
                  "maxLength": 8192
                },
                "provider_guidance_url": {
                  "type": "string",
                  "maxLength": 2048
                },
                "auto_remediable": {
                  "type": "boolean"
                },
                "requires_downtime": {
                  "type": "boolean"
                },
                "stateful_impact": {
                  "type": "string",
                  "maxLength": 64
                },
                "estimated_downtime_range_seconds": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "min",
                    "max"
                  ],
                  "properties": {
                    "min": {
                      "type": "integer",
                      "format": "int32",
                      "minimum": 0,
                      "maximum": 2147483647
                    },
                    "max": {
                      "type": "integer",
                      "format": "int32",
                      "minimum": 0,
                      "maximum": 2147483647
                    }
                  }
                },
                "compensating_control": {
                  "type": "boolean"
                }
              }
            }
          },
          "provider_fix_version": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "version_type",
              "comparison"
            ],
            "properties": {
              "version_type": {
                "type": "string",
                "maxLength": 64
              },
              "comparison": {
                "type": "string",
                "maxLength": 32
              },
              "version": {
                "type": "string",
                "maxLength": 128
              },
              "channel": {
                "type": "string",
                "maxLength": 128
              },
              "build_date": {
                "type": "string",
                "maxLength": 35
              },
              "image_digest": {
                "type": "string",
                "maxLength": 256
              },
              "image_tag": {
                "type": "string",
                "maxLength": 256
              },
              "engine": {
                "type": "string",
                "maxLength": 64
              },
              "auto_upgrade": {
                "type": "boolean"
              },
              "note": {
                "type": "string",
                "maxLength": 2048
              }
            }
          },
          "detections": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "provider",
                "service",
                "query_language",
                "query",
                "detection_phase",
                "description"
              ],
              "properties": {
                "provider": {
                  "type": "string",
                  "maxLength": 64
                },
                "service": {
                  "type": "string",
                  "maxLength": 64
                },
                "query_language": {
                  "type": "string",
                  "maxLength": 64
                },
                "query": {
                  "type": "string",
                  "maxLength": 16384
                },
                "detection_phase": {
                  "type": "string",
                  "maxLength": 64
                },
                "description": {
                  "type": "string",
                  "maxLength": 8192
                },
                "pending_reason": {
                  "type": "string",
                  "maxLength": 2048
                }
              }
            }
          },
          "provider_advisory": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "advisory_id": {
                "type": "string",
                "maxLength": 256
              },
              "advisory_url": {
                "type": "string",
                "maxLength": 2048
              },
              "provider_severity": {
                "type": "string",
                "maxLength": 64
              },
              "provider_cvss_score": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 10
              },
              "provider_cvss_vector": {
                "type": "string",
                "maxLength": 256
              }
            }
          }
        }
      },
      "CritLookupRequest": {
        "type": "object",
        "description": "A cloud resource type. Values are trimmed and lower-cased. Unknown keys are ignored.",
        "required": [
          "provider",
          "service",
          "resource_type"
        ],
        "maxProperties": 16,
        "properties": {
          "provider": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "pattern": "^[A-Za-z0-9_-]{1,64}$",
            "description": "Cloud provider slug, such as `aws`, `azure` or `gcp`."
          },
          "service": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "pattern": "^[A-Za-z0-9_-]{1,64}$",
            "description": "Service slug as the CRIT dictionary names it."
          },
          "resource_type": {
            "type": "string",
            "minLength": 1,
            "maxLength": 129,
            "pattern": "^[A-Za-z0-9_-]{1,64}(/[A-Za-z0-9_-]{1,64})?$",
            "description": "Resource type as the CRIT dictionary names it."
          }
        }
      },
      "CritLookupResponse": {
        "type": "object",
        "description": "The vulnerabilities that affect a cloud resource type.",
        "required": [
          "provider",
          "service",
          "resource_type",
          "timestamp",
          "count",
          "dictionary_entry",
          "match_strategies_applied",
          "matches"
        ],
        "additionalProperties": false,
        "properties": {
          "provider": {
            "type": "string",
            "maxLength": 64
          },
          "service": {
            "type": "string",
            "maxLength": 64
          },
          "resource_type": {
            "type": "string",
            "maxLength": 129,
            "description": "In the dictionary's own spelling when the type is in the dictionary."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds; on the GET form with matches, rounded down to the hour."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 500,
            "description": "Matches returned."
          },
          "dictionary_entry": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "valid"
            ],
            "description": "Whether the type is in the CRIT dictionary, and its template when it is.",
            "properties": {
              "valid": {
                "type": "boolean"
              },
              "template": {
                "type": "string",
                "maxLength": 1024
              },
              "template_format": {
                "type": "string",
                "maxLength": 64
              },
              "region_behavior": {
                "type": "string",
                "maxLength": 32
              },
              "note": {
                "type": "string",
                "maxLength": 128
              }
            }
          },
          "match_strategies_applied": {
            "type": "array",
            "maxItems": 2,
            "items": {
              "type": "string",
              "enum": [
                "crit_record",
                "alias_expansion"
              ]
            },
            "description": "The strategies that found at least one match."
          },
          "matches": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/CritLookupMatch"
            },
            "description": "In id order."
          },
          "truncated": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Present when more than 500 matched and the riskiest 500 were kept."
          },
          "view": {
            "type": "string",
            "enum": [
              "slim"
            ],
            "description": "Present for `view=slim` when there was at least one match."
          }
        }
      },
      "CrowdSecIocSighting": {
        "type": "object",
        "description": "One CrowdSec sighting: an IP seen exploiting the vulnerability. Optional keys are absent, not null, when unknown. The same row is spelled `latitude`/`longitude` on `/v2/exploits/{identifier}`.",
        "required": [
          "uuid",
          "cveId",
          "source",
          "ip",
          "falsePositivesCount"
        ],
        "additionalProperties": false,
        "properties": {
          "uuid": {
            "type": "string",
            "maxLength": 64
          },
          "cveId": {
            "type": "string",
            "maxLength": 226
          },
          "source": {
            "type": "string",
            "maxLength": 64
          },
          "ip": {
            "type": "string",
            "maxLength": 45,
            "description": "Source IP address."
          },
          "reputation": {
            "type": "string",
            "maxLength": 64,
            "description": "e.g. malicious, suspicious."
          },
          "confidence": {
            "type": "string",
            "maxLength": 64
          },
          "backgroundNoiseScore": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 100
          },
          "asNum": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Autonomous system number."
          },
          "asName": {
            "type": "string",
            "maxLength": 256
          },
          "country": {
            "type": "string",
            "maxLength": 8,
            "description": "ISO 3166-1 alpha-2 source country."
          },
          "city": {
            "type": "string",
            "maxLength": 256
          },
          "lat": {
            "type": "number",
            "format": "double",
            "minimum": -90,
            "maximum": 90
          },
          "lon": {
            "type": "number",
            "format": "double",
            "minimum": -180,
            "maximum": 180
          },
          "reverseDns": {
            "type": "string",
            "maxLength": 512
          },
          "behaviors": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 256
            }
          },
          "attackDetails": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 512
            }
          },
          "classifications": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 256
            }
          },
          "mitreTechniques": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 64
            }
          },
          "targetCountries": {
            "description": "Target-country distribution as CrowdSec stored it (any JSON).",
            "type": [
              "object",
              "array",
              "string",
              "number",
              "boolean"
            ],
            "maxProperties": 300,
            "maxItems": 300
          },
          "firstSeen": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35
          },
          "lastSeen": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35
          },
          "falsePositivesCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          }
        }
      },
      "CrowdSecSummary": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "totalSightings",
          "uniqueIPs",
          "isActive"
        ],
        "properties": {
          "totalSightings": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "uniqueIPs": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "isActive": {
            "type": "boolean",
            "description": "Meant to say the last sighting was within 30 days. The handler parses `lastSeen` as RFC 3339, which it never is, so today this is always false."
          },
          "firstSeen": {
            "type": "string",
            "maxLength": 20,
            "pattern": "^[0-9]{1,20}$",
            "description": "Earliest sighting, as Unix milliseconds written as a decimal string (the stored integer is read into a string, not formatted as a date). Absent when unknown.",
            "examples": [
              "1639180800000"
            ]
          },
          "lastSeen": {
            "type": "string",
            "maxLength": 20,
            "pattern": "^[0-9]{1,20}$",
            "description": "Latest sighting, as Unix milliseconds written as a decimal string. Absent when unknown.",
            "examples": [
              "1762204440000"
            ]
          },
          "topSourceCountries": {
            "type": "array",
            "maxItems": 300,
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Countries attacks came from. Absent when none."
          },
          "topTargetCountries": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Countries targeted, at most 20. Absent when none."
          },
          "mitreTechniques": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 128
            },
            "description": "Absent when none."
          },
          "behaviors": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Absent when none."
          }
        },
        "description": "CrowdSec honeypot sightings, summarised."
      },
      "CvssScore": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "baseScore",
          "baseSeverity",
          "vectorString",
          "source"
        ],
        "properties": {
          "baseScore": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 10
          },
          "baseSeverity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 16
          },
          "vectorString": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "source": {
            "type": "string",
            "maxLength": 128,
            "description": "Who published the metric."
          }
        },
        "description": "One CVSS metric."
      },
      "CweEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "cweId",
          "description"
        ],
        "properties": {
          "cweId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048
          }
        }
      },
      "CweGuidanceEntry": {
        "type": "object",
        "description": "A weakness the vulnerability is classified under, with remediation guidance.",
        "required": [
          "cweId",
          "name",
          "guidance"
        ],
        "additionalProperties": false,
        "properties": {
          "cweId": {
            "type": "string",
            "description": "As the record states it (usually `CWE-<n>`)."
          },
          "name": {
            "type": "string",
            "description": "The record's description of the weakness; empty when it has none."
          },
          "source": {
            "type": "string",
            "description": "The source that classified it. Absent when empty."
          },
          "guidance": {
            "type": "string",
            "description": "Markdown remediation guidance for the weakness, or the general template when there is none for it."
          },
          "capecEntries": {
            "type": "array",
            "description": "The record's CAPEC patterns (same list on each weakness).",
            "items": {
              "type": "object",
              "required": [
                "capecId",
                "description",
                "source"
              ],
              "additionalProperties": false,
              "properties": {
                "capecId": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                }
              }
            }
          },
          "attackTechniques": {
            "type": "array",
            "description": "Inferred ATT&CK techniques (same list on each weakness).",
            "items": {
              "type": "object",
              "required": [
                "techniqueId",
                "relationship"
              ],
              "additionalProperties": false,
              "properties": {
                "techniqueId": {
                  "type": "string",
                  "description": "ATT&CK technique id (for example `T1190`)."
                },
                "relationship": {
                  "type": "string",
                  "description": "How the technique relates (for example `RELATED_TO`)."
                }
              }
            }
          }
        }
      },
      "CycloneDxBom": {
        "type": "object",
        "description": "A CycloneDX JSON BOM. Only `components` is read; every other key (`bomFormat`, `specVersion`, `metadata`, `dependencies` and so on) is accepted and ignored. Nested `components[].components` are not read.",
        "additionalProperties": true,
        "maxProperties": 64,
        "required": [
          "components"
        ],
        "properties": {
          "components": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "description": "Components of other types (`file`, `operating-system` and so on) are skipped and do not count toward the cap; more than 5000 scanned components (type `library`, `framework` or absent) is 400. The handler bounds the whole array only by the 10 MiB body limit; this document bounds it at 50000.",
            "items": {
              "type": "object",
              "description": "A CycloneDX component. Keys other than those listed are accepted and ignored.",
              "additionalProperties": true,
              "maxProperties": 64,
              "required": [
                "name"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "application",
                    "framework",
                    "library",
                    "container",
                    "platform",
                    "operating-system",
                    "device",
                    "device-driver",
                    "firmware",
                    "file",
                    "machine-learning-model",
                    "data",
                    "cryptographic-asset"
                  ],
                  "description": "Only `library`, `framework` or an absent type is scanned; other types are skipped.",
                  "examples": [
                    "library"
                  ]
                },
                "name": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/PackageName"
                    }
                  ],
                  "description": "Component name (required by CycloneDX; the handler does not check it).",
                  "example": "log4j-core"
                },
                "version": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Version"
                    }
                  ],
                  "example": "2.14.1"
                },
                "group": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 512,
                  "pattern": "^@?[A-Za-z0-9][A-Za-z0-9._~:@/+-]{0,510}$",
                  "description": "Group or namespace; the scanned package is recorded as `group:name`. Matching uses the purl only.",
                  "examples": [
                    "org.apache.logging.log4j"
                  ]
                },
                "purl": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Purl"
                    }
                  ],
                  "description": "The component's purl. A component without one is skipped.",
                  "example": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
                }
              }
            }
          }
        },
        "examples": [
          {
            "bomFormat": "CycloneDX",
            "specVersion": "1.6",
            "components": [
              {
                "type": "library",
                "group": "org.apache.logging.log4j",
                "name": "log4j-core",
                "version": "2.14.1",
                "purl": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
              }
            ]
          }
        ]
      },
      "Date": {
        "type": "string",
        "format": "date",
        "minLength": 10,
        "maxLength": 10,
        "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
        "examples": [
          "2024-06-11"
        ]
      },
      "DefenceBrief": {
        "type": "object",
        "description": "One defence as the counts answer lists it. Optional keys are left out when the record has no value.",
        "additionalProperties": false,
        "required": [
          "uuid",
          "kind",
          "title",
          "consoleUrl"
        ],
        "properties": {
          "uuid": {
            "type": "string",
            "maxLength": 64
          },
          "kind": {
            "type": "string",
            "maxLength": 32,
            "description": "SNORT, SURICATA, MODSECURITY, NGINX, AWS_WAF, CLOUDFLARE_WAF or REGEX_L7 for a virtual patch; SIGMA, YARA, STIX or OPENIOC for a countermeasure."
          },
          "title": {
            "type": "string",
            "maxLength": 1024
          },
          "deployMode": {
            "type": "string",
            "maxLength": 16
          },
          "confidence": {
            "type": "string",
            "maxLength": 16
          },
          "falsePositiveRisk": {
            "type": "string",
            "maxLength": 16
          },
          "matchedCve": {
            "type": "string",
            "maxLength": 226
          },
          "consoleUrl": {
            "type": "string",
            "format": "uri",
            "maxLength": 256,
            "description": "Opens the defence in the console, e.g. `https://www.vulnes.is/resolve/virtual-patching?dc=<uuid>#catalogue`."
          }
        }
      },
      "DefenceCountsItem": {
        "type": "object",
        "description": "One item: any input kinds (as in `Inputs`) plus an optional `key` echoed on its result. An item needs at least one input.",
        "additionalProperties": false,
        "maxProperties": 24,
        "properties": {
          "vulnIds": {
            "description": "Advisory ids, as one string or a list; at most 100.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "vulnId": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "cveId": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "identifier": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "package": {
            "$ref": "#/components/schemas/PackageName"
          },
          "packageName": {
            "deprecated": true,
            "description": "Alias of `package`.",
            "$ref": "#/components/schemas/PackageName"
          },
          "ecosystem": {
            "$ref": "#/components/schemas/Ecosystem"
          },
          "version": {
            "$ref": "#/components/schemas/Version"
          },
          "packageVersion": {
            "deprecated": true,
            "description": "Alias of `version`.",
            "$ref": "#/components/schemas/Version"
          },
          "currentVersion": {
            "deprecated": true,
            "description": "Alias of `version`.",
            "$ref": "#/components/schemas/Version"
          },
          "vendor": {
            "$ref": "#/components/schemas/VendorName"
          },
          "product": {
            "$ref": "#/components/schemas/ProductName"
          },
          "cpe": {
            "$ref": "#/components/schemas/Cpe"
          },
          "purl": {
            "$ref": "#/components/schemas/Purl"
          },
          "swid": {
            "$ref": "#/components/schemas/Swid"
          },
          "tei": {
            "$ref": "#/components/schemas/Tei"
          },
          "cel": {
            "$ref": "#/components/schemas/Cel"
          },
          "key": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "pattern": "^(?:[A-Za-z0-9][A-Za-z0-9 ._:@+#,/~!*?-]{0,511}|pkg:[!-~]{1,508}|cpe:[!-~]{1,508}|urn(?::|%3[Aa])tei(?::|%3[Aa])[!-~]{1,500}|cel: [ -~]{1,507})$",
            "description": "Your label for the item, echoed on its result verbatim. The handler takes any string; this pattern admits what clients send: a vulnerability id or a plain label, a purl, CPE or TEI as given (with `%`, `?`, `&` or `=`), or `cel: <expression>` as the CLI labels a CEL item."
          }
        }
      },
      "DefenceCountsItemError": {
        "type": "object",
        "description": "Why one item could not be answered. The status is what the single-input routes would answer for the same input.",
        "additionalProperties": false,
        "required": [
          "field",
          "message",
          "status"
        ],
        "properties": {
          "field": {
            "type": "string",
            "maxLength": 64,
            "description": "The input at fault, or `item`."
          },
          "message": {
            "type": "string",
            "maxLength": 2048
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "enum": [
              400,
              401,
              413,
              422,
              503
            ],
            "description": "400 malformed or empty item, 401 a uuid TEI or CEL input without an organisation, 413 over a limit, 422 not resolvable here, 503 the transparency log or the count query failed (retry)."
          }
        }
      },
      "DefenceCountsRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "minItems": 1,
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/DefenceCountsItem"
            },
            "description": "1 to 100 items."
          }
        }
      },
      "DefenceCountsResult": {
        "type": "object",
        "description": "The answer for one item, in request order. An item whose inputs were invalid or did not resolve carries `error` alone (with `key`). An item whose count query failed carries `resolved` and `error`, plus `virtualPatches` when only the countermeasures count failed.",
        "additionalProperties": false,
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 512,
            "description": "The item's key; absent when it sent none."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "virtualPatches": {
            "$ref": "#/components/schemas/DefenceLaneCounts"
          },
          "countermeasures": {
            "$ref": "#/components/schemas/DefenceLaneCounts"
          },
          "error": {
            "$ref": "#/components/schemas/DefenceCountsItemError"
          }
        }
      },
      "DefenceIdentifierError": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "error",
          "examples"
        ],
        "description": "The identifier is none of the accepted kinds.",
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 2048
          },
          "examples": {
            "type": "string",
            "maxLength": 2048,
            "description": "Example identifiers, comma separated."
          }
        }
      },
      "DefenceKindList": {
        "type": "string",
        "maxLength": 256,
        "pattern": "^(?:SNORT|SURICATA|MODSECURITY|NGINX|AWS_WAF|CLOUDFLARE_WAF|REGEX_L7|SIGMA|YARA|STIX|OPENIOC|snort|suricata|modsecurity|nginx|aws_waf|cloudflare_waf|regex_l7|sigma|yara|stix|openioc)(?:, ?(?:SNORT|SURICATA|MODSECURITY|NGINX|AWS_WAF|CLOUDFLARE_WAF|REGEX_L7|SIGMA|YARA|STIX|OPENIOC|snort|suricata|modsecurity|nginx|aws_waf|cloudflare_waf|regex_l7|sigma|yara|stix|openioc)){0,15}$",
        "description": "One kind, or several separated by commas. Matched case-insensitively; upper and lower case are both accepted here."
      },
      "DefenceLaneCounts": {
        "type": "object",
        "description": "One lane's answer for one item.",
        "additionalProperties": false,
        "required": [
          "total",
          "byKind",
          "hasMore",
          "defences"
        ],
        "properties": {
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Every matching defence. Every plan."
          },
          "byKind": {
            "type": "object",
            "maxProperties": 16,
            "additionalProperties": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 2147483647
            },
            "description": "Count per kind. Every plan."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More defences match than `defences` lists (it lists 50 at most)."
          },
          "defences": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/DefenceBrief"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature virtual-patches for `virtualPatches`, countermeasures for `countermeasures`). At most 50, ordered by kind then newest first."
          }
        }
      },
      "DefenceSearchBody": {
        "type": "object",
        "description": "The search as a JSON body: every input kind (as in `Inputs`) plus the catalogue's own filters. Send `{}` for the whole catalogue.",
        "additionalProperties": false,
        "maxProperties": 24,
        "properties": {
          "vulnIds": {
            "description": "Advisory ids, as one string or a list; at most 100.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "vulnId": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "cveId": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "identifier": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "package": {
            "$ref": "#/components/schemas/PackageName"
          },
          "packageName": {
            "deprecated": true,
            "description": "Alias of `package`.",
            "$ref": "#/components/schemas/PackageName"
          },
          "ecosystem": {
            "$ref": "#/components/schemas/Ecosystem"
          },
          "version": {
            "$ref": "#/components/schemas/Version"
          },
          "packageVersion": {
            "deprecated": true,
            "description": "Alias of `version`.",
            "$ref": "#/components/schemas/Version"
          },
          "currentVersion": {
            "deprecated": true,
            "description": "Alias of `version`.",
            "$ref": "#/components/schemas/Version"
          },
          "vendor": {
            "$ref": "#/components/schemas/VendorName"
          },
          "product": {
            "$ref": "#/components/schemas/ProductName"
          },
          "cpe": {
            "$ref": "#/components/schemas/Cpe"
          },
          "purl": {
            "$ref": "#/components/schemas/Purl"
          },
          "swid": {
            "$ref": "#/components/schemas/Swid"
          },
          "tei": {
            "$ref": "#/components/schemas/Tei"
          },
          "cel": {
            "$ref": "#/components/schemas/Cel"
          },
          "kind": {
            "description": "Kinds to keep, as one string or a list (OR). A string may hold several kinds separated by commas; a kind of the other lane matches nothing.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/DefenceKindList"
              },
              {
                "type": "array",
                "maxItems": 16,
                "items": {
                  "$ref": "#/components/schemas/DefenceKindList"
                }
              }
            ]
          },
          "confidence": {
            "type": "string",
            "enum": [
              "HIGH",
              "MEDIUM",
              "LOW",
              "high",
              "medium",
              "low"
            ],
            "description": "Matched case-insensitively."
          },
          "deployMode": {
            "type": "string",
            "enum": [
              "log",
              "block",
              "LOG",
              "BLOCK"
            ],
            "description": "Matched case-insensitively."
          },
          "exploitSource": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
            "description": "Source slug of the originating exploit, matched exactly."
          },
          "q": {
            "$ref": "#/components/schemas/SafeText",
            "description": "Free text. Each whitespace-separated token must appear (case-insensitively) in the title, the description or the rule body."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200,
            "description": "Defences per page; overrides `?limit=` when above 0. Values above 200 are clamped to 200."
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 100000,
            "description": "Defences to skip; overrides `?offset=` when above 0."
          }
        }
      },
      "DetectionRuleIdentifierError": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "error",
          "examples"
        ],
        "description": "The identifier is an advisory id of a family the detection-rule routes do not take.",
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 256
          },
          "examples": {
            "type": "string",
            "maxLength": 256,
            "description": "Example ids the route takes, comma separated."
          }
        }
      },
      "DetectionVexLooseTime": {
        "type": "string",
        "minLength": 1,
        "maxLength": 35,
        "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}(?:[T ][0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{1,9})?(?:Z|[+-][0-9]{2}:[0-9]{2})?)?$",
        "description": "A time: RFC 3339 (`2026-01-01T00:00:00Z`), `YYYY-MM-DDTHH:MM:SS`, `YYYY-MM-DD HH:MM:SS` or `YYYY-MM-DD`; a time without a zone is UTC. The handler ignores a value that does not parse rather than rejecting it.",
        "examples": [
          "2026-01-01T00:00:00Z",
          "2026-01-01"
        ]
      },
      "Ecosystem": {
        "type": "string",
        "description": "An ecosystem: a purl type or one of its aliases (pip, go, crates.io, rubygems, packagist, debian, alpine, node, java and others), or an OSV ecosystem name with one space such as `Arch Linux`. Canonicalised to the purl type.",
        "minLength": 1,
        "maxLength": 32,
        "pattern": "^[A-Za-z][A-Za-z0-9.+-]{0,30}(?: [A-Za-z][A-Za-z0-9.+-]{0,30})?$",
        "examples": [
          "npm",
          "pypi",
          "maven"
        ]
      },
      "EcosystemPackageEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packageName",
          "version",
          "ecosystem",
          "sourceTable",
          "sourceId"
        ],
        "description": "One product-index row.",
        "properties": {
          "packageName": {
            "type": "string",
            "maxLength": 512,
            "description": "The resolved name this row is stored under."
          },
          "version": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "The version, or null when the row carries none."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "The ecosystem label the product index stores for the row. Not necessarily the path ecosystem: the path segment does not filter."
          },
          "sourceTable": {
            "type": "string",
            "maxLength": 128,
            "description": "The source the row comes from."
          },
          "sourceId": {
            "type": "string",
            "maxLength": 1024,
            "description": "The row's id in that source."
          }
        }
      },
      "EcosystemPackageNotFound": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error",
          "data",
          "resolvedNames",
          "resolvedMode",
          "pagination"
        ],
        "description": "No product-index row matched the resolved names.",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "enum": [
              "Package not found"
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 0,
            "items": {
              "$ref": "#/components/schemas/EcosystemPackageEntry"
            },
            "description": "Always empty."
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Canonical package names the path name resolved to: up to three exact matches (the name, and the name with `_` or `-` read as a space), otherwise up to ten fuzzy matches. Null when nothing matched (`resolvedMode` is `empty`)."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name was resolved: `exact` match, `fuzzy` (trigram) fallback, or `empty` when nothing matched."
          },
          "pagination": {
            "$ref": "#/components/schemas/EcosystemPackagePagination"
          }
        }
      },
      "EcosystemPackagePagination": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "limit",
          "offset",
          "hasMore",
          "total"
        ],
        "properties": {
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "Page size, as applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9223372036854775807,
            "description": "Items skipped, as applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit` is less than `total`."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Matching items before paging."
          }
        }
      },
      "EcosystemPackageVersion": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "version",
          "ecosystem",
          "sources"
        ],
        "description": "One known version of a package.",
        "properties": {
          "version": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "The ecosystem the product index stores this version under: the path ecosystem when the version is stored under it, else the one ecosystem it is stored under. Empty when only CVE affected entries list the version or when it is stored under several ecosystems, none of them the path one."
          },
          "sources": {
            "type": "array",
            "minItems": 1,
            "maxItems": 32,
            "items": {
              "type": "string",
              "maxLength": 128
            },
            "description": "Sources that list the version: product-index source names, and `cve_affected` for CVE affected entries. Order is not stable."
          }
        }
      },
      "Entitlements": {
        "type": "object",
        "description": "Present when part of the answer was withheld for the caller's plan.",
        "required": [
          "plan",
          "gated"
        ],
        "properties": {
          "plan": {
            "type": "string",
            "enum": [
              "community",
              "pro",
              "teams",
              "enterprise"
            ]
          },
          "gated": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "$ref": "#/components/schemas/GatedFeature"
            }
          }
        }
      },
      "EnumNameCount": {
        "type": "object",
        "required": [
          "name",
          "count"
        ],
        "additionalProperties": false,
        "description": "One observed value and how many records hold it.",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 256,
            "description": "The value as stored."
          },
          "count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Number of records (or, for ecosystems, distinct packages) with this value."
          }
        }
      },
      "EolCalendarEntry": {
        "type": "object",
        "description": "One lifecycle event of one release.",
        "additionalProperties": false,
        "required": [
          "product",
          "productLabel",
          "category",
          "releaseName",
          "releaseLabel",
          "isLts",
          "eolType",
          "eolDate",
          "isMicrosoft"
        ],
        "properties": {
          "product": {
            "type": "string",
            "maxLength": 128,
            "description": "Product slug."
          },
          "productLabel": {
            "type": "string",
            "maxLength": 256
          },
          "category": {
            "type": "string",
            "maxLength": 64
          },
          "linkIcon": {
            "type": "string",
            "maxLength": 256,
            "description": "Absent when unknown."
          },
          "linkHtml": {
            "type": "string",
            "maxLength": 2048,
            "description": "The source page. Absent when unknown."
          },
          "releaseName": {
            "type": "string",
            "maxLength": 128
          },
          "releaseLabel": {
            "type": "string",
            "maxLength": 512,
            "description": "The release label, or product label plus release name when the release has none."
          },
          "releaseDate": {
            "type": "string",
            "maxLength": 32,
            "description": "Absent when unknown."
          },
          "isLts": {
            "type": "boolean"
          },
          "latestVersion": {
            "type": "string",
            "maxLength": 128,
            "description": "Absent when unknown."
          },
          "eolType": {
            "type": "string",
            "enum": [
              "eol",
              "eoas",
              "eoes",
              "discontinued"
            ],
            "description": "`eoas` end of active support, `eol` end of security support, `eoes` end of extended support, `discontinued`."
          },
          "eolDate": {
            "type": "string",
            "maxLength": 32,
            "description": "The event date, within the requested month."
          },
          "isMicrosoft": {
            "type": "boolean"
          }
        }
      },
      "EolEntitlements": {
        "description": "Below Pro, when `withheld` is above 0: names `eol-vendor-lifecycle` (requiredPlan `pro`).",
        "allOf": [
          {
            "$ref": "#/components/schemas/Entitlements"
          }
        ]
      },
      "EolPlanLocked": {
        "description": "Below Pro, for a product sourced from vendor lifecycle data: the `planLocked` marker for `eol-vendor-lifecycle`.",
        "allOf": [
          {
            "$ref": "#/components/schemas/PlanLocked"
          },
          {
            "type": "object",
            "required": [
              "timestamp",
              "productName"
            ],
            "properties": {
              "timestamp": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 99999999999,
                "description": "Unix seconds."
              },
              "productName": {
                "type": "string",
                "maxLength": 128,
                "description": "The product slug."
              }
            }
          }
        ]
      },
      "EolProductDetail": {
        "type": "object",
        "description": "A product's full lifecycle record.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "product",
          "_links"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds."
          },
          "product": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "name",
              "label",
              "category",
              "tags",
              "aliases",
              "versionCommand",
              "labels",
              "links",
              "identifiers",
              "releases"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 128,
                "examples": [
                  "nodejs"
                ]
              },
              "label": {
                "type": "string",
                "maxLength": 256,
                "examples": [
                  "Node.js"
                ]
              },
              "category": {
                "type": "string",
                "maxLength": 64,
                "examples": [
                  "framework"
                ]
              },
              "tags": {
                "type": "array",
                "maxItems": 64,
                "items": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "aliases": {
                "type": "array",
                "maxItems": 256,
                "items": {
                  "type": "string",
                  "maxLength": 128
                }
              },
              "versionCommand": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 512,
                "description": "Shell command that prints the installed version."
              },
              "labels": {
                "type": "object",
                "description": "The source's names for each support phase.",
                "additionalProperties": false,
                "required": [
                  "eoas",
                  "eol",
                  "eoes",
                  "discontinued"
                ],
                "properties": {
                  "eoas": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 128
                  },
                  "eol": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 128
                  },
                  "eoes": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 128
                  },
                  "discontinued": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 128
                  }
                }
              },
              "links": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "icon",
                  "html",
                  "releasePolicy"
                ],
                "properties": {
                  "icon": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 256,
                    "description": "Icon name (Simple Icons slug)."
                  },
                  "html": {
                    "type": "string",
                    "maxLength": 2048,
                    "description": "The source page: an endoflife.date page or the vendor lifecycle page."
                  },
                  "releasePolicy": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 2048
                  }
                }
              },
              "identifiers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "type",
                    "id"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "maxLength": 32,
                      "description": "`purl`, `cpe` or `repology`."
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 1024
                    }
                  }
                }
              },
              "releases": {
                "type": "array",
                "description": "Newest release date first; undated releases last.",
                "items": {
                  "$ref": "#/components/schemas/EolRelease"
                }
              }
            }
          },
          "_links": {
            "type": "array",
            "description": "A `search` link, then one `release` link per release cycle.",
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "minItems": 1
          }
        }
      },
      "EolProductListItem": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "label",
          "category",
          "tags",
          "icon",
          "releaseCount",
          "maintainedCount"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 128,
            "description": "Product slug, used in `/eol/products/{product}`.",
            "examples": [
              "nodejs"
            ]
          },
          "label": {
            "type": "string",
            "maxLength": 256,
            "examples": [
              "Node.js"
            ]
          },
          "category": {
            "type": "string",
            "maxLength": 64,
            "examples": [
              "framework"
            ]
          },
          "tags": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 64,
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Null when the product has no tags."
          },
          "icon": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Icon name (Simple Icons slug) when known."
          },
          "releaseCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "maintainedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          }
        }
      },
      "EolRelease": {
        "type": "object",
        "description": "One release cycle and its support phases. Dates are `YYYY-MM-DD` strings as the source gives them.",
        "additionalProperties": false,
        "required": [
          "name",
          "codename",
          "label",
          "releaseDate",
          "isLts",
          "ltsFrom",
          "isEoas",
          "eoasFrom",
          "isEol",
          "eolFrom",
          "isEoes",
          "eoesFrom",
          "isDiscontinued",
          "discontinuedFrom",
          "isMaintained"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 128,
            "examples": [
              "3.12"
            ]
          },
          "codename": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128
          },
          "label": {
            "type": "string",
            "maxLength": 256,
            "examples": [
              "3.12"
            ]
          },
          "releaseDate": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "examples": [
              "2023-10-02"
            ]
          },
          "isLts": {
            "type": "boolean"
          },
          "ltsFrom": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32
          },
          "isEoas": {
            "type": "boolean",
            "description": "Active support has ended."
          },
          "eoasFrom": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32
          },
          "isEol": {
            "type": "boolean",
            "description": "Security support has ended."
          },
          "eolFrom": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "examples": [
              "2028-10-31"
            ]
          },
          "isEoes": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Extended support has ended; null when the product has no extended support."
          },
          "eoesFrom": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32
          },
          "isDiscontinued": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "discontinuedFrom": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32
          },
          "isMaintained": {
            "type": "boolean"
          },
          "latest": {
            "type": "object",
            "description": "The latest patch release. Absent when nothing is known about it.",
            "additionalProperties": false,
            "required": [
              "name",
              "date",
              "link"
            ],
            "properties": {
              "name": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 128,
                "examples": [
                  "3.12.12"
                ]
              },
              "date": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 32
              },
              "link": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 2048
              }
            }
          },
          "custom": {
            "type": "object",
            "additionalProperties": true,
            "maxProperties": 64,
            "description": "Product-specific fields from the source. Absent when there are none."
          }
        }
      },
      "EolStatus": {
        "type": "object",
        "description": "The end-of-life product a package maps to.",
        "additionalProperties": false,
        "required": [
          "productName",
          "isEol"
        ],
        "properties": {
          "productName": {
            "type": "string",
            "maxLength": 256,
            "description": "Product name in the end-of-life database."
          },
          "isEol": {
            "type": "boolean",
            "description": "Whether any release cycle of the product has reached end of life."
          }
        }
      },
      "EpssData": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "score",
          "percentile",
          "date"
        ],
        "properties": {
          "score": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "percentile": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1
          },
          "date": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The EPSS scoring date (`YYYY-MM-DD`)."
          }
        },
        "description": "The latest EPSS score."
      },
      "ErrorBody": {
        "type": "object",
        "description": "An error. `error` says what went wrong; `field` names the input at fault when there is one.",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 2048
          },
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "details": {
            "type": "string",
            "maxLength": 2048
          },
          "field": {
            "type": "string",
            "maxLength": 64
          }
        }
      },
      "ExploitArchiveEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "uuid",
          "exploitId",
          "source",
          "title",
          "isArchive",
          "filename",
          "hasArchive",
          "archiveUrl",
          "archiveMetaUrl"
        ],
        "properties": {
          "uuid": {
            "$ref": "#/components/schemas/Uuid"
          },
          "exploitId": {
            "type": "string",
            "maxLength": 256
          },
          "source": {
            "type": "string",
            "maxLength": 64
          },
          "title": {
            "type": "string",
            "maxLength": 2048
          },
          "isArchive": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "filename": {
            "type": "string",
            "maxLength": 1024,
            "description": "Base name of the stored file."
          },
          "fileSize": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Bytes. Absent when unknown."
          },
          "bodyContentHash": {
            "type": "string",
            "maxLength": 128,
            "description": "Absent when unknown."
          },
          "originalUrl": {
            "type": "string",
            "maxLength": 2048,
            "description": "Absent when unknown."
          },
          "datePublished": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35,
            "description": "Absent when unknown."
          },
          "platform": {
            "type": "string",
            "maxLength": 128,
            "description": "Absent when unknown."
          },
          "category": {
            "type": "string",
            "maxLength": 128,
            "description": "Absent when unknown."
          },
          "hasArchive": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "archiveUrl": {
            "type": "string",
            "maxLength": 256,
            "description": "`/v2/exploits/{uuid}/archive`."
          },
          "archiveMetaUrl": {
            "type": "string",
            "maxLength": 256,
            "description": "`/v2/exploits/{uuid}/archive/meta`."
          },
          "createdAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000000,
            "description": "Absent when unknown."
          }
        },
        "description": "One archived exploit file."
      },
      "ExploitArchiveGone": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "error",
          "originalUrl",
          "r2Key"
        ],
        "properties": {
          "error": {
            "type": "string",
            "enum": [
              "Archive is no longer available"
            ]
          },
          "originalUrl": {
            "type": "string",
            "maxLength": 2048
          },
          "r2Key": {
            "type": "string",
            "maxLength": 1024
          }
        }
      },
      "ExploitArchiveNotFound": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "enum": [
              "Exploit not found",
              "No archive on file for this exploit"
            ]
          },
          "originalUrl": {
            "type": "string",
            "maxLength": 2048,
            "description": "Download route: the upstream URL when no archive is held (may be empty)."
          },
          "exploit": {
            "$ref": "#/components/schemas/ExploitArchiveRecord",
            "description": "Metadata route: the record when no archive is held."
          },
          "s3": {
            "$ref": "#/components/schemas/ExploitArchiveS3Info",
            "description": "Metadata route: `{\"exists\": false}` when no archive is held."
          }
        }
      },
      "ExploitArchivePlanLocked": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PlanLocked"
          },
          {
            "type": "object",
            "required": [
              "error",
              "_pro_data"
            ],
            "properties": {
              "error": {
                "type": "string",
                "maxLength": 512
              },
              "_pro_data": {
                "type": "array",
                "maxItems": 1,
                "items": {
                  "type": "string",
                  "maxLength": 64
                }
              }
            }
          }
        ],
        "description": "The answer below Pro: HTTP 200 with `planLocked`, feature `exploit-archive`."
      },
      "ExploitArchiveRecord": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "uuid",
          "exploitId",
          "source",
          "title",
          "author",
          "platform",
          "category",
          "originalUrl",
          "sourceArchiveUrl",
          "bodyContentHash",
          "fileSize",
          "createdAt",
          "datePublished"
        ],
        "properties": {
          "uuid": {
            "type": "string",
            "maxLength": 64
          },
          "exploitId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 64
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048
          },
          "author": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "platform": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128
          },
          "originalUrl": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048
          },
          "sourceArchiveUrl": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048
          },
          "bodyContentHash": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128
          },
          "fileSize": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "createdAt": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000000
          },
          "datePublished": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35
          }
        },
        "description": "The exploit's database record."
      },
      "ExploitArchiveS3Info": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "exists"
        ],
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 1024,
            "description": "The storage key. Absent on the 404 answer."
          },
          "exists": {
            "type": "boolean",
            "description": "The stored object was found. False when it is missing or storage is not configured."
          },
          "contentType": {
            "type": "string",
            "maxLength": 256,
            "description": "Present when `exists`."
          },
          "fileSize": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Bytes. Present when `exists`."
          },
          "lastModified": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35,
            "description": "Present when `exists`."
          },
          "etag": {
            "type": "string",
            "maxLength": 256,
            "description": "Present when `exists`."
          },
          "error": {
            "type": "string",
            "maxLength": 2048,
            "description": "The storage error, when the lookup failed for a reason other than not found."
          }
        },
        "description": "What object storage holds for the archive."
      },
      "ExploitCvssMetrics": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "cvssV2",
          "cvssV3_0",
          "cvssV3_1",
          "cvssV4_0",
          "highestSeverity",
          "highestScore"
        ],
        "properties": {
          "cvssV2": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CvssScore"
              }
            ]
          },
          "cvssV3_0": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CvssScore"
              }
            ]
          },
          "cvssV3_1": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CvssScore"
              }
            ]
          },
          "cvssV4_0": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CvssScore"
              }
            ]
          },
          "highestSeverity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 16,
            "description": "Severity of the highest-scoring metric, or null when no metric has a score."
          },
          "highestScore": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 10
          }
        },
        "description": "CVSS metrics by version, de-duplicated by vector. A version with no metric is null."
      },
      "ExploitIntelKevEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vendorProject",
          "product",
          "vulnerabilityName",
          "requiredAction",
          "dateAdded",
          "dueDate",
          "knownRansomwareCampaignUse",
          "notes"
        ],
        "properties": {
          "vendorProject": {
            "type": "string",
            "maxLength": 512
          },
          "product": {
            "type": "string",
            "maxLength": 512
          },
          "vulnerabilityName": {
            "type": "string",
            "maxLength": 1024
          },
          "requiredAction": {
            "type": "string",
            "maxLength": 2048
          },
          "dateAdded": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000000
          },
          "dueDate": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000000,
            "description": "Unix milliseconds; 0 when the catalogue set no deadline."
          },
          "knownRansomwareCampaignUse": {
            "type": "string",
            "maxLength": 32
          },
          "notes": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 65536
          }
        }
      },
      "ExploitIntelRecord": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "uuid",
          "cveId",
          "source",
          "type"
        ],
        "properties": {
          "uuid": {
            "type": "string",
            "maxLength": 256,
            "description": "Record id. KEV entries use `<vulnId>:enisa-kev` or `<vulnId>:vulnetix-kev`."
          },
          "cveId": {
            "type": "string",
            "maxLength": 226
          },
          "source": {
            "type": "string",
            "maxLength": 64,
            "description": "Where the record came from: a reference source, `vulncheck-xdb`, `crowdsec`, an Exploit-table source (`github`, `nmap-nse`, `exploitdb`, ...), `vulncheck-reported-exploitation`, `hackerone`/`bugcrowd`/`intigriti`, `shadowserver`, `enisa-kev`, `vulnetix-kev`."
          },
          "type": {
            "type": "string",
            "maxLength": 32,
            "description": "`exploit`, `poc`, `sighting`, `reported-exploitation`, `bugbounty`, or a reference's own type."
          },
          "url": {
            "type": "string",
            "maxLength": 2048,
            "description": "Reference records only."
          },
          "referenceSource": {
            "type": "string",
            "maxLength": 128,
            "description": "Reference records only."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048
          },
          "httpStatus": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0,
            "maximum": 999,
            "description": "Reference records only: the last HTTP status seen for the URL."
          },
          "deadLink": {
            "type": "boolean",
            "description": "Reference records only."
          },
          "createdAt": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000000,
            "description": "Unix milliseconds when the record was stored (for KEV entries, the date added)."
          },
          "isArchive": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Archived exploit files only."
          },
          "hasArchive": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Archived exploit files only."
          },
          "filename": {
            "type": "string",
            "maxLength": 1024
          },
          "fileSize": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "bodyContentHash": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128
          },
          "originalUrl": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048
          },
          "datePublished": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35,
            "description": "Archived exploit files only."
          },
          "platform": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128
          },
          "archiveUrl": {
            "type": "string",
            "maxLength": 256,
            "description": "Archived exploit files only: GET it for the bytes (Pro)."
          },
          "archiveMetaUrl": {
            "type": "string",
            "maxLength": 256,
            "description": "Archived exploit files only: GET it for the metadata (Pro)."
          },
          "exploitDb": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "author",
              "platform",
              "type",
              "port",
              "verified",
              "rawUrl",
              "date"
            ],
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 32
              },
              "author": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "platform": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 128
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "port": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": 0,
                "maximum": 65535
              },
              "verified": {
                "type": "boolean"
              },
              "rawUrl": {
                "type": "string",
                "maxLength": 256
              },
              "date": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000,
                "description": "Unix epoch time as stored."
              },
              "rawContent": {
                "type": "string",
                "maxLength": 10485760,
                "description": "Present with `include_content=true` when the stored copy could be read."
              },
              "r2Path": {
                "type": "string",
                "maxLength": 512,
                "description": "Present with `rawContent`."
              }
            }
          },
          "metasploit": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "modulePath",
              "moduleUrl",
              "rawUrl"
            ],
            "properties": {
              "modulePath": {
                "type": "string",
                "maxLength": 1024
              },
              "moduleUrl": {
                "type": "string",
                "maxLength": 2048
              },
              "rawUrl": {
                "type": "string",
                "maxLength": 2048
              },
              "moduleContent": {
                "type": "string",
                "maxLength": 10485760,
                "description": "Present with `include_content=true` when the stored copy could be read."
              },
              "r2Path": {
                "type": "string",
                "maxLength": 1024,
                "description": "Present with `moduleContent`."
              }
            }
          },
          "nuclei": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "path",
              "commitSha",
              "commitAuthorName",
              "commitCommitterName",
              "commitCommitterEmail",
              "commitMessage",
              "commentCount",
              "templateUrl",
              "rawUrl"
            ],
            "properties": {
              "path": {
                "type": "string",
                "maxLength": 1024
              },
              "commitSha": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "commitAuthorName": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "commitCommitterName": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "commitCommitterEmail": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 320
              },
              "commitMessage": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 65536
              },
              "commentCount": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "templateUrl": {
                "type": "string",
                "maxLength": 2048
              },
              "rawUrl": {
                "type": "string",
                "maxLength": 2048
              }
            }
          },
          "vulnerabilityLab": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "title",
              "exploitationTechnique",
              "authenticationType",
              "userInteraction",
              "author",
              "url",
              "createdAt",
              "updatedAt"
            ],
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 32
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 2048
              },
              "exploitationTechnique": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "authenticationType": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "userInteraction": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "author": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "url": {
                "type": "string",
                "maxLength": 256
              },
              "createdAt": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              },
              "updatedAt": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              }
            }
          },
          "githubPR": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "diffUrl",
              "state",
              "author",
              "labels",
              "mergeCommitSha",
              "health",
              "mergedAt"
            ],
            "properties": {
              "diffUrl": {
                "type": "string",
                "maxLength": 2048
              },
              "state": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 32
              },
              "author": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "labels": {
                "description": "Labels as stored (a JSON value or text), or null."
              },
              "mergeCommitSha": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "health": {
                "description": "Repository health as stored (a JSON value or text), or null."
              },
              "mergedAt": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              }
            }
          },
          "githubCommit": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "authorEmail",
              "authorLogin",
              "verified",
              "health"
            ],
            "properties": {
              "authorEmail": {
                "type": "string",
                "maxLength": 320
              },
              "authorLogin": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "verified": {
                "type": "boolean"
              },
              "health": {
                "description": "Repository health as stored (a JSON value or text), or null."
              }
            }
          },
          "githubGist": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "public",
              "filesCount",
              "files",
              "comments",
              "url",
              "updatedAt"
            ],
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 64
              },
              "public": {
                "type": "boolean"
              },
              "filesCount": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": 0,
                "maximum": 100000
              },
              "files": {
                "description": "The gist's files as stored (a JSON value or text), or null."
              },
              "comments": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "url": {
                "type": "string",
                "maxLength": 256
              },
              "updatedAt": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              }
            }
          },
          "vulnCheckXDB": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "url",
              "dateAdded",
              "exploitType",
              "cloneSshUrl",
              "kevId",
              "createdAt"
            ],
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 128
              },
              "url": {
                "type": "string",
                "maxLength": 2048
              },
              "dateAdded": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              },
              "exploitType": {
                "type": "string",
                "maxLength": 64
              },
              "cloneSshUrl": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 2048
              },
              "kevId": {
                "type": "string",
                "maxLength": 64
              },
              "createdAt": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              }
            }
          },
          "crowdSec": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "ip",
              "reputation",
              "confidence",
              "backgroundNoiseScore",
              "firstSeen",
              "lastSeen",
              "asName",
              "asNum",
              "country",
              "city",
              "latitude",
              "longitude",
              "behaviors",
              "attackDetails",
              "mitreTechniques",
              "reverseDns",
              "targetCountries"
            ],
            "properties": {
              "ip": {
                "type": "string",
                "maxLength": 45
              },
              "reputation": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "confidence": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "backgroundNoiseScore": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": 0,
                "maximum": 100
              },
              "firstSeen": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              },
              "lastSeen": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              },
              "asName": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "asNum": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "country": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "city": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "latitude": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": -90,
                "maximum": 90
              },
              "longitude": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": -180,
                "maximum": 180
              },
              "behaviors": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "type": "string",
                  "maxLength": 256
                }
              },
              "attackDetails": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "type": "string",
                  "maxLength": 256
                }
              },
              "mitreTechniques": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "type": "string",
                  "maxLength": 128
                }
              },
              "reverseDns": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 512
              },
              "targetCountries": {
                "description": "Targeted countries as stored (a JSON array or text), or null."
              }
            }
          },
          "poc": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "exploitId",
              "source",
              "title",
              "author",
              "platform",
              "category",
              "originalUrl",
              "sourceArchiveUrl",
              "bodyContentHash",
              "fileSize",
              "cveIds",
              "affectedProducts",
              "datePublished"
            ],
            "properties": {
              "exploitId": {
                "type": "string",
                "maxLength": 256
              },
              "source": {
                "type": "string",
                "maxLength": 64
              },
              "title": {
                "type": "string",
                "maxLength": 2048
              },
              "author": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "platform": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 128
              },
              "category": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 128
              },
              "originalUrl": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 2048
              },
              "sourceArchiveUrl": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 2048
              },
              "bodyContentHash": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 128
              },
              "fileSize": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "cveIds": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "type": "string",
                  "maxLength": 226
                }
              },
              "affectedProducts": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "vendor",
                    "product",
                    "version",
                    "homepage"
                  ],
                  "properties": {
                    "vendor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 512
                    },
                    "product": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 512
                    },
                    "version": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 256
                    },
                    "homepage": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 2048
                    }
                  }
                }
              },
              "datePublished": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              }
            }
          },
          "vulnCheckReportedExploitation": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "url",
              "dateAdded",
              "kevId",
              "createdAt"
            ],
            "properties": {
              "url": {
                "type": "string",
                "maxLength": 2048
              },
              "dateAdded": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              },
              "kevId": {
                "type": "string",
                "maxLength": 64
              },
              "createdAt": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              }
            }
          },
          "bugBounty": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "reportId",
              "reportUrl",
              "substate",
              "teamHandle",
              "teamName",
              "reporterUsername",
              "reporterName",
              "bountyAmount",
              "bonusAmount",
              "assetIdentifier",
              "assetType",
              "weaknessCweId",
              "weaknessName",
              "severityRating",
              "severityScore",
              "cveIds",
              "createdAtSource",
              "disclosedAt",
              "closedAt"
            ],
            "properties": {
              "reportId": {
                "type": "string",
                "maxLength": 128
              },
              "reportUrl": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 2048
              },
              "substate": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "teamHandle": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "teamName": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "reporterUsername": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "reporterName": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256
              },
              "bountyAmount": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "bonusAmount": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "assetIdentifier": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 2048
              },
              "assetType": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "weaknessCweId": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 32
              },
              "weaknessName": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 512
              },
              "severityRating": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 32
              },
              "severityScore": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": 0,
                "maximum": 10
              },
              "cveIds": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "type": "string",
                  "maxLength": 226
                }
              },
              "createdAtSource": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              },
              "disclosedAt": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              },
              "closedAt": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              }
            }
          },
          "shadowserver": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "vendor",
              "product",
              "vulnerabilitySeverity",
              "hostType",
              "statistic",
              "observationCount",
              "observationDate",
              "cisaKev",
              "knownRansomwareCampaignUse"
            ],
            "properties": {
              "vendor": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 512
              },
              "product": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 512
              },
              "vulnerabilitySeverity": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 32
              },
              "hostType": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "statistic": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 64
              },
              "observationCount": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "observationDate": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int64",
                "minimum": 0,
                "maximum": 32503680000000
              },
              "cisaKev": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "knownRansomwareCampaignUse": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 32
              }
            }
          },
          "enisaKev": {
            "$ref": "#/components/schemas/ExploitIntelKevEntry"
          },
          "vulnetixKev": {
            "$ref": "#/components/schemas/ExploitIntelKevEntry"
          }
        },
        "description": "One exploit, sighting, bounty or KEV record. `uuid`, `cveId`, `source` and `type` are always present; the rest depends on the kind of record, and each source-specific object is present only on records of that source."
      },
      "ExploitIntelSummary": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "exploitDb",
          "metasploit",
          "nuclei",
          "nmapNse",
          "vulnerabilityLab",
          "vulnCheckXDB",
          "vulnCheckReportedExploitation",
          "crowdSec",
          "shadowserver",
          "circl",
          "misp",
          "enisaKev",
          "vulnetixKev",
          "hackerone",
          "bugcrowd",
          "intigriti",
          "bugBounty",
          "github",
          "poc",
          "other"
        ],
        "properties": {
          "exploitDb": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "metasploit": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "nuclei": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "nmapNse": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "vulnerabilityLab": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "vulnCheckXDB": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "vulnCheckReportedExploitation": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "crowdSec": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "shadowserver": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "circl": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "misp": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "enisaKev": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "vulnetixKev": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hackerone": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "bugcrowd": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "intigriti": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "bugBounty": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "github": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "poc": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "other": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          }
        },
        "description": "Records per source over the whole set, not the page. Visible on every plan."
      },
      "ExploitKevStatus": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "inCisaKev",
          "inVulnCheckKev"
        ],
        "properties": {
          "inCisaKev": {
            "type": "boolean",
            "description": "True when any row of the KEV table names the CVE. That table holds the CISA, ENISA and Vulnesis catalogues, so this is also true for a CVE only ENISA or Vulnesis KEV lists."
          },
          "inVulnCheckKev": {
            "type": "boolean"
          },
          "cisaDateAdded": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35,
            "description": "Present when `inCisaKev` is true and the row has a date added."
          },
          "cisaDueDate": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35,
            "description": "Present when `inCisaKev` is true and the row has a due date."
          },
          "cisaOverdue": {
            "type": "boolean",
            "description": "Present with `cisaDueDate`: true once the due date has passed."
          },
          "knownRansomwareCampaignUse": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Present when `inCisaKev` is true."
          }
        }
      },
      "ExploitProvenance": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "dataOrigin"
        ],
        "properties": {
          "source": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 64,
            "description": "The CVE record's source slug."
          },
          "dataOrigin": {
            "type": "string",
            "enum": [
              "CVE.org",
              "NVD",
              "GitHub Security Advisories",
              "OSV"
            ]
          }
        }
      },
      "ExploitSearchFilters": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "ecosystem",
          "source",
          "severity",
          "inKev",
          "minEpss",
          "q",
          "sort"
        ],
        "properties": {
          "ecosystem": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 64,
            "description": "The `ecosystem` filter as given, or null."
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The `source` filter as given, or null. A value outside the documented set is echoed but filters by the default exploit predicate."
          },
          "severity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The `severity` filter, upper-cased, or null."
          },
          "inKev": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "True for `inKev=true` or `inKev=1`, false for any other non-empty value, null when absent."
          },
          "minEpss": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 1,
            "description": "The `minEpss` floor applied, or null when absent or outside 0-1."
          },
          "q": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "The free-text filter as given, or null."
          },
          "sort": {
            "type": "string",
            "maxLength": 32,
            "description": "The sort as given (default `recent`). A value outside `recent`, `epss`, `severity`, `maturity` is echoed but sorts as `recent`."
          }
        },
        "description": "The filters this page was selected with."
      },
      "ExploitSearchResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "limit",
          "offset",
          "hasMore",
          "position",
          "take",
          "step",
          "filters",
          "results"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "Unix seconds when the answer was built."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean",
            "description": "A further page exists. There is no total: counting the matches would need a pass over every CVE record."
          },
          "position": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Same as `offset`."
          },
          "take": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 100,
            "description": "Same as `limit`."
          },
          "step": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 100,
            "description": "Same as `limit`."
          },
          "filters": {
            "$ref": "#/components/schemas/ExploitSearchFilters"
          },
          "results": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/ExploitSearchResult"
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        },
        "description": "One page of CVEs carrying exploit intelligence."
      },
      "ExploitSearchResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "cveId",
          "state",
          "title",
          "description",
          "aliases",
          "metrics",
          "epss",
          "cess",
          "cwes",
          "affectedProducts",
          "fixAvailability",
          "kev",
          "ecosystems",
          "provenance",
          "timeline",
          "exploitSources",
          "exploitationMaturity",
          "exploitTriviality",
          "sightings",
          "_links"
        ],
        "properties": {
          "cveId": {
            "type": "string",
            "maxLength": 226,
            "description": "The CVE record's id."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 65536,
            "description": "Null when no description is held."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "At most 20."
          },
          "metrics": {
            "$ref": "#/components/schemas/ExploitCvssMetrics"
          },
          "epss": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/EpssData"
              }
            ]
          },
          "cess": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CessData"
              }
            ]
          },
          "cwes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CweEntry"
            }
          },
          "affectedProducts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AffectedProduct"
            }
          },
          "fixAvailability": {
            "$ref": "#/components/schemas/FixAvailability"
          },
          "kev": {
            "$ref": "#/components/schemas/ExploitKevStatus"
          },
          "ecosystems": {
            "type": "array",
            "maxItems": 16,
            "items": {
              "type": "string",
              "maxLength": 32
            },
            "description": "Distinct ecosystems derived from the affected records."
          },
          "provenance": {
            "$ref": "#/components/schemas/ExploitProvenance"
          },
          "timeline": {
            "$ref": "#/components/schemas/ExploitTimeline"
          },
          "exploitSources": {
            "$ref": "#/components/schemas/ExploitSourceCounts"
          },
          "exploitationMaturity": {
            "$ref": "#/components/schemas/ExploitationMaturity"
          },
          "exploitTriviality": {
            "$ref": "#/components/schemas/ExploitTriviality"
          },
          "sightings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/SightingsData"
              }
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). The CrowdSec summary, VulnCheck XDB and reported-exploitation entries, and other sightings."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other views of this vulnerability."
          }
        },
        "description": "One CVE with exploit intelligence."
      },
      "ExploitSourceCounts": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "exploitDb",
          "metasploit",
          "nuclei",
          "nmapNse",
          "vulnerabilityLab",
          "vulnCheckXDB",
          "vulnCheckReportedExploitation",
          "crowdSec",
          "github",
          "poc",
          "total"
        ],
        "properties": {
          "exploitDb": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "metasploit": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "nuclei": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "nmapNse": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "vulnerabilityLab": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "vulnCheckXDB": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "vulnCheckReportedExploitation": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "crowdSec": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "github": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "poc": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Sum of the other counts."
          }
        },
        "description": "Exploit artefacts per source. Visible on every plan."
      },
      "ExploitTimeline": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "datePublished",
          "dateUpdated",
          "currentAgeDays",
          "lifecycleStage",
          "publicationToKevDays",
          "publicationToFirstExploitDays",
          "firstExploitDate"
        ],
        "properties": {
          "datePublished": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35
          },
          "dateUpdated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35
          },
          "currentAgeDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0,
            "maximum": 100000
          },
          "lifecycleStage": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "EMERGING",
              "ACTIVE",
              "ESTABLISHED",
              "MATURE",
              null
            ],
            "description": "Under 7 days EMERGING, under 90 ACTIVE, under 365 ESTABLISHED, else MATURE."
          },
          "publicationToKevDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": -100000,
            "maximum": 100000
          },
          "publicationToFirstExploitDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": -100000,
            "maximum": 100000,
            "description": "Negative when an exploit predates publication."
          },
          "firstExploitDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35
          }
        }
      },
      "ExploitTrendsBucket": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "period",
          "mention",
          "bounty",
          "sighting",
          "theoretical",
          "weaponised",
          "knownExploits",
          "total"
        ],
        "properties": {
          "period": {
            "type": "string",
            "maxLength": 7,
            "description": "`YYYY-MM` (monthly) or `YYYY` (yearly)."
          },
          "mention": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "bounty": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "sighting": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "theoretical": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "weaponised": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "knownExploits": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          }
        }
      },
      "ExploitTrendsOrphan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "cveId"
        ],
        "properties": {
          "cveId": {
            "type": "string",
            "maxLength": 226
          },
          "epss": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Absent when the CVE is not in the current EPSS snapshot."
          },
          "cess": {
            "type": "number",
            "minimum": 0,
            "maximum": 10,
            "description": "Absent when the CVE is not in the current CESS snapshot."
          }
        }
      },
      "ExploitTrendsSourceCount": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "count"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 256
          },
          "count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          }
        }
      },
      "ExploitTrendsTopCve": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "cveId",
          "total"
        ],
        "properties": {
          "cveId": {
            "type": "string",
            "maxLength": 226
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "score": {
            "type": "number",
            "minimum": 0,
            "maximum": 10,
            "description": "Predicted tier only: the EPSS or CESS score."
          }
        }
      },
      "ExploitTrendsTopCves": {
        "type": "object",
        "additionalProperties": false,
        "required": [],
        "properties": {
          "mention": {
            "type": [
              "object",
              "null"
            ],
            "maxProperties": 128,
            "additionalProperties": {
              "type": [
                "array",
                "null"
              ],
              "maxItems": 10,
              "items": {
                "$ref": "#/components/schemas/ExploitTrendsTopCve"
              }
            },
            "description": "Source name to its top 10 CVEs. Null when the top-CVE query failed for this run."
          },
          "bounty": {
            "type": [
              "object",
              "null"
            ],
            "maxProperties": 128,
            "additionalProperties": {
              "type": [
                "array",
                "null"
              ],
              "maxItems": 10,
              "items": {
                "$ref": "#/components/schemas/ExploitTrendsTopCve"
              }
            },
            "description": "Source name to its top 10 CVEs. Null when the top-CVE query failed for this run."
          },
          "sighting": {
            "type": [
              "object",
              "null"
            ],
            "maxProperties": 128,
            "additionalProperties": {
              "type": [
                "array",
                "null"
              ],
              "maxItems": 10,
              "items": {
                "$ref": "#/components/schemas/ExploitTrendsTopCve"
              }
            },
            "description": "Source name to its top 10 CVEs. Null when the top-CVE query failed for this run."
          },
          "theoretical": {
            "type": [
              "object",
              "null"
            ],
            "maxProperties": 128,
            "additionalProperties": {
              "type": [
                "array",
                "null"
              ],
              "maxItems": 10,
              "items": {
                "$ref": "#/components/schemas/ExploitTrendsTopCve"
              }
            },
            "description": "Source name to its top 10 CVEs. Null when the top-CVE query failed for this run."
          },
          "weaponised": {
            "type": [
              "object",
              "null"
            ],
            "maxProperties": 128,
            "additionalProperties": {
              "type": [
                "array",
                "null"
              ],
              "maxItems": 10,
              "items": {
                "$ref": "#/components/schemas/ExploitTrendsTopCve"
              }
            },
            "description": "Source name to its top 10 CVEs. Null when the top-CVE query failed for this run."
          },
          "knownExploits": {
            "type": [
              "object",
              "null"
            ],
            "maxProperties": 128,
            "additionalProperties": {
              "type": [
                "array",
                "null"
              ],
              "maxItems": 10,
              "items": {
                "$ref": "#/components/schemas/ExploitTrendsTopCve"
              }
            },
            "description": "Source name to its top 10 CVEs. Null when the top-CVE query failed for this run."
          },
          "predicted": {
            "type": [
              "object",
              "null"
            ],
            "maxProperties": 128,
            "additionalProperties": {
              "type": [
                "array",
                "null"
              ],
              "maxItems": 10,
              "items": {
                "$ref": "#/components/schemas/ExploitTrendsTopCve"
              }
            },
            "description": "Source name to its top 10 CVEs. Null when the top-CVE query failed for this run."
          }
        },
        "description": "Top CVEs per tier, then per source (CISA, EU, VulnCheck under knownExploits; Snort, NSE, Nuclei, Metasploit under weaponised; one key per bounty platform; each exploit source under theoretical; EPSS and CESS under predicted). `{}` when the stored payload has none."
      },
      "ExploitTrendsTotals": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "mention",
          "bounty",
          "sighting",
          "theoretical",
          "weaponised",
          "knownExploits",
          "predicted"
        ],
        "properties": {
          "mention": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "records",
              "distinctCves"
            ],
            "properties": {
              "records": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "distinctCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            }
          },
          "bounty": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "records",
              "distinctCves",
              "resolvedCount",
              "criticalCount",
              "highCount",
              "topPrograms",
              "bySource"
            ],
            "properties": {
              "records": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "distinctCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "resolvedCount": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "criticalCount": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "highCount": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "topPrograms": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "$ref": "#/components/schemas/ExploitTrendsSourceCount"
                }
              },
              "bySource": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "$ref": "#/components/schemas/ExploitTrendsSourceCount"
                }
              }
            }
          },
          "sighting": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "crowdsec",
              "circlSightings",
              "shadowserver",
              "shadowserverCves",
              "shadowserverAnomalies",
              "shadowserverSurges",
              "shadowserverMassExploit",
              "shadowserverRansomware",
              "shadowserverUniqueIps",
              "shadowserverCountries",
              "distinctIps",
              "distinctCountries",
              "distinctCves",
              "records"
            ],
            "properties": {
              "crowdsec": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "circlSightings": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "shadowserver": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "shadowserverCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "shadowserverAnomalies": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "shadowserverSurges": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "shadowserverMassExploit": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "shadowserverRansomware": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "shadowserverUniqueIps": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "shadowserverCountries": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "distinctIps": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "distinctCountries": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "distinctCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "records": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            }
          },
          "theoretical": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "records",
              "distinctCves",
              "s3Stored",
              "vulncheckXdb",
              "circlExploited",
              "publicPocRecords",
              "bySource",
              "byPlatform"
            ],
            "properties": {
              "records": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "distinctCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "s3Stored": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "vulncheckXdb": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "circlExploited": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "publicPocRecords": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "bySource": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "$ref": "#/components/schemas/ExploitTrendsSourceCount"
                }
              },
              "byPlatform": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 1000,
                "items": {
                  "$ref": "#/components/schemas/ExploitTrendsSourceCount"
                }
              }
            }
          },
          "weaponised": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "snort",
              "nse",
              "nuclei",
              "metasploit",
              "distinctCves",
              "records"
            ],
            "properties": {
              "snort": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "nse": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "nuclei": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "metasploit": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "distinctCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "records": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            }
          },
          "knownExploits": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "cisaKev",
              "euKev",
              "vulncheckKev",
              "vulnetixKev",
              "ransomwareKnown",
              "distinctCves",
              "records",
              "vulnetixReasons"
            ],
            "properties": {
              "cisaKev": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "euKev": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "vulncheckKev": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "vulnetixKev": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "ransomwareKnown": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "distinctCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "records": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "vulnetixReasons": {
                "type": [
                  "object",
                  "null"
                ],
                "maxProperties": 64,
                "additionalProperties": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                "description": "Vulnesis KEV entries per qualifying reason."
              }
            }
          },
          "predicted": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "epssScoredCves",
              "epssHighCves",
              "epssMediumCves",
              "cessScoredCves",
              "cessHighCves",
              "avgEpss"
            ],
            "properties": {
              "epssScoredCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "epssHighCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "epssMediumCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "cessScoredCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "cessHighCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "avgEpss": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              }
            }
          }
        },
        "description": "Catalogue-wide totals per tier: mention (MISP social mentions), bounty, sighting, theoretical (PoCs and VulnCheck XDB), weaponised (Snort, Nmap NSE, Nuclei, Metasploit), knownExploits (CISA, EU, VulnCheck and Vulnesis KEV) and predicted (EPSS, CESS)."
      },
      "ExploitTriviality": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "level",
          "reasoning"
        ],
        "properties": {
          "level": {
            "type": "string",
            "enum": [
              "TURNKEY",
              "WEAPONIZED",
              "FUNCTIONAL",
              "POC",
              "THEORETICAL"
            ]
          },
          "reasoning": {
            "type": "string",
            "maxLength": 128
          }
        },
        "description": "How ready-to-use the best available exploit is."
      },
      "ExploitationMaturity": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "score",
          "level",
          "confidence"
        ],
        "properties": {
          "score": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 100
          },
          "level": {
            "type": "string",
            "enum": [
              "NONE",
              "POC",
              "WEAPONIZED",
              "ACTIVE",
              "WIDESPREAD"
            ]
          },
          "confidence": {
            "type": "string",
            "enum": [
              "LOW",
              "MEDIUM",
              "HIGH",
              "VERY_HIGH"
            ]
          }
        },
        "description": "A 0-100 score from EPSS, CESS, KEV listing, public exploits, CrowdSec sightings and VulnCheck XDB."
      },
      "ExploitationSignals": {
        "type": "object",
        "description": "Exploitation evidence across every CVE that affects the package.",
        "additionalProperties": false,
        "required": [
          "inCisaKev",
          "inVulnCheckKev",
          "exploitCount",
          "xdbCount",
          "crowdSecSightings"
        ],
        "properties": {
          "inCisaKev": {
            "type": "boolean",
            "description": "Any CVE is in the CISA KEV catalog."
          },
          "inVulnCheckKev": {
            "type": "boolean",
            "description": "Any CVE is in the VulnCheck KEV catalog."
          },
          "exploitCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Known exploits."
          },
          "xdbCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Exploit-DB entries."
          },
          "crowdSecSightings": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "CrowdSec in-the-wild sightings."
          }
        }
      },
      "FixAvailability": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "hasFixedVersion",
          "fixedVersionCount"
        ],
        "properties": {
          "hasFixedVersion": {
            "type": "boolean"
          },
          "fixedVersionCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Affected-version rows that are unaffected or carry an upper bound."
          }
        }
      },
      "FixDistribution": {
        "type": "object",
        "required": [
          "name",
          "displayName",
          "advisoryPrefix",
          "count"
        ],
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "enum": [
              "ubuntu",
              "debian",
              "redhat",
              "almalinux",
              "alpine",
              "suse",
              "rockylinux"
            ]
          },
          "displayName": {
            "type": "string",
            "enum": [
              "Ubuntu",
              "Debian",
              "Red Hat",
              "AlmaLinux",
              "Alpine Linux",
              "openSUSE / SUSE",
              "Rocky Linux"
            ]
          },
          "advisoryPrefix": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "USN",
              "DSA",
              "RHSA",
              "ALSA",
              "openSUSE-SU",
              "RLSA",
              null
            ],
            "description": "Advisory id prefix; null for Alpine."
          },
          "count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "References whose URL points at this distribution's advisories."
          }
        }
      },
      "GatedFeature": {
        "type": "object",
        "required": [
          "feature",
          "requiredPlan"
        ],
        "properties": {
          "feature": {
            "type": "string",
            "description": "The plan feature that unlocks the gated data, as the pricing page names it.",
            "maxLength": 64,
            "examples": [
              "full-enrichment",
              "virtual-patches",
              "detection-rules-catalog"
            ]
          },
          "requiredPlan": {
            "type": "string",
            "enum": [
              "pro",
              "teams",
              "enterprise"
            ]
          },
          "paths": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "JSONPath of each field nulled for this feature."
          }
        }
      },
      "GcveIssuancesResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "year",
          "month",
          "total",
          "limit",
          "offset",
          "hasMore",
          "identifiers"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800000,
            "description": "Unix milliseconds."
          },
          "year": {
            "type": "integer",
            "format": "int32",
            "minimum": 2020,
            "maximum": 2100
          },
          "month": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 12
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Issuances in the month. Reads 0 when the count query fails."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean"
          },
          "identifiers": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "type": "object",
              "required": [
                "gcveId",
                "cveId",
                "datePublished"
              ],
              "additionalProperties": false,
              "properties": {
                "gcveId": {
                  "type": "string",
                  "maxLength": 226,
                  "description": "The GCVE id as issued (for example `GCVE-VVD-2025-42`)."
                },
                "cveId": {
                  "type": "string",
                  "maxLength": 226,
                  "description": "The advisory id the GCVE id was issued for."
                },
                "datePublished": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 4102444800000,
                  "description": "Issuance time, Unix milliseconds. Reads 0 when the page is served from the server's query cache (for up to an hour, a day for a past month): the cached value is not carried over."
                }
              }
            }
          }
        }
      },
      "GcveSearchResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "total",
          "limit",
          "offset",
          "hasMore",
          "dateRange",
          "records"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Source records published in the range. Reads 0 when the count query fails."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean"
          },
          "dateRange": {
            "type": "object",
            "required": [
              "start",
              "end"
            ],
            "additionalProperties": false,
            "properties": {
              "start": {
                "$ref": "#/components/schemas/Date"
              },
              "end": {
                "$ref": "#/components/schemas/Date"
              }
            }
          },
          "records": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/CVEListV5Record"
            },
            "description": "One CVE JSON 5 record per source record, newest publication first. These records carry no `x_links`."
          }
        }
      },
      "GetAiAssistedExploitsOutcomesResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "exploits",
          "aggregate"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the snapshot was computed, Unix seconds. Present when the snapshot carries it."
          },
          "version": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000,
            "description": "Snapshot format version. Present when the snapshot carries it."
          },
          "sourceTimestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Timestamp of the snapshot row, Unix milliseconds. Present when the row has one."
          },
          "exploits": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiAssistedExploitOutcome"
            },
            "description": "The curated demonstrations, in list order. `[]` when the snapshot lacks it."
          },
          "aggregate": {
            "type": "object",
            "description": "Success roll-up. `{}` when the snapshot lacks it; otherwise every key is present.",
            "additionalProperties": false,
            "properties": {
              "total": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              "succeeded": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              "failed": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              "successRate": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1,
                "description": "succeeded / total."
              },
              "leaderboard": {
                "type": "array",
                "description": "One entry per researcher organisation, ordered by `succeeded` (highest first), then `org`.",
                "items": {
                  "type": "object",
                  "required": [
                    "org",
                    "authors",
                    "aiSystem",
                    "total",
                    "succeeded",
                    "failed",
                    "successRate"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "org": {
                      "type": "string"
                    },
                    "authors": {
                      "type": "string",
                      "description": "Researcher names of the organisation's first entry."
                    },
                    "aiSystem": {
                      "type": "string",
                      "description": "AI system of the organisation's first entry."
                    },
                    "total": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 0
                    },
                    "succeeded": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 0
                    },
                    "failed": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 0
                    },
                    "successRate": {
                      "type": "number",
                      "format": "double",
                      "minimum": 0,
                      "maximum": 1
                    }
                  }
                }
              }
            }
          }
        }
      },
      "GetAiDiscoveredVulnsOutcomesResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "outcomes",
          "aggregate"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the snapshot was computed, Unix seconds. Present when the snapshot carries it."
          },
          "version": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000,
            "description": "Snapshot format version. Present when the snapshot carries it."
          },
          "sourceTimestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Timestamp of the snapshot row, Unix milliseconds. Present when the row has one."
          },
          "outcomes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiDiscoveredVulnOutcome"
            },
            "description": "One entry per vulnerability on the curated list, in list order. `[]` when the snapshot lacks it."
          },
          "aggregate": {
            "$ref": "#/components/schemas/AiDiscoveredVulnsOutcomesAggregate"
          }
        }
      },
      "GetAlibabaArchiveResponse": {
        "type": "object",
        "description": "One month of Alibaba advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Alibaba Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present. `sourceBreakdown.alibaba-product` is always 0 in this answer.",
            "additionalProperties": false,
            "required": [
              "alinux2",
              "alibaba-product"
            ],
            "properties": {
              "alinux2": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "alibaba-product": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 0,
                "description": "Always 0: the month endpoint does not return these entries."
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/AlibabaArchiveAdvisory"
            }
          }
        }
      },
      "GetAlpineArchiveResponse": {
        "type": "object",
        "description": "One month of Alpine advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Alpine Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present.",
            "additionalProperties": false,
            "required": [
              "docker-hub-alpine",
              "chainguard-images",
              "wolfi-images",
              "redhat-hardened",
              "aports"
            ],
            "properties": {
              "docker-hub-alpine": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "chainguard-images": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "wolfi-images": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "redhat-hardened": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "aports": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/AlpineArchiveAdvisory"
            }
          }
        }
      },
      "GetAppleArchiveResponse": {
        "type": "object",
        "description": "One month of Apple advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Apple Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`; only the kinds present in the month are listed.",
            "additionalProperties": false,
            "properties": {
              "macos": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "ios": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "ipados": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "tvos": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "watchos": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "visionos": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "safari": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "xcode": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "other": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/AppleArchiveAdvisory"
            }
          }
        }
      },
      "GetAwsArchiveResponse": {
        "type": "object",
        "description": "One month of AWS advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — AWS Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present.",
            "additionalProperties": false,
            "required": [
              "alas-al1",
              "alas-al2",
              "alas-al2023",
              "aws-bulletin",
              "aws-sdk"
            ],
            "properties": {
              "alas-al1": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "alas-al2": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "alas-al2023": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "aws-bulletin": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "aws-sdk": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/AwsArchiveAdvisory"
            }
          }
        }
      },
      "GetBroadcomArchiveResponse": {
        "type": "object",
        "description": "One month of Broadcom advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Broadcom Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present.",
            "additionalProperties": false,
            "required": [
              "vmsa",
              "bitnami",
              "cloudfoundry-tanzu"
            ],
            "properties": {
              "vmsa": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "bitnami": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "cloudfoundry-tanzu": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/BroadcomArchiveAdvisory"
            }
          }
        }
      },
      "GetCanonicalArchiveResponse": {
        "type": "object",
        "description": "One month of Canonical advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Canonical Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present.",
            "additionalProperties": false,
            "required": [
              "usn"
            ],
            "properties": {
              "usn": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/CanonicalArchiveAdvisory"
            }
          }
        }
      },
      "GetCiscoArchiveResponse": {
        "type": "object",
        "description": "One month of Cisco advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Cisco Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present. `sourceBreakdown.cisco-product` is always 0 in this answer.",
            "additionalProperties": false,
            "required": [
              "psirt",
              "cisco-product"
            ],
            "properties": {
              "psirt": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "cisco-product": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 0,
                "description": "Always 0: the month endpoint does not return these entries."
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/CiscoArchiveAdvisory"
            }
          }
        }
      },
      "GetCloudLocatorsResponse": {
        "type": "object",
        "description": "Cloud resource locator templates for a vendor and product.",
        "required": [
          "vendor",
          "product",
          "timestamp",
          "cloudLocators"
        ],
        "additionalProperties": false,
        "properties": {
          "vendor": {
            "type": "string",
            "maxLength": 512,
            "description": "As given, trimmed; empty when not given."
          },
          "product": {
            "type": "string",
            "maxLength": 512,
            "description": "As given, trimmed; empty when not given."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was built."
          },
          "cloudLocators": {
            "$ref": "#/components/schemas/CloudLocatorResult",
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when no cloud service maps to the pair."
          },
          "generatedCpe": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1100,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). A CPE 2.3 string for the pair; present only when both `vendor` and `product` were given."
          },
          "_links": {
            "type": "array",
            "maxItems": 1,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "A `search` link to the package search for the product; present when `product` was given."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetCloudflareArchiveResponse": {
        "type": "object",
        "description": "One month of Cloudflare advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Cloudflare Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present.",
            "additionalProperties": false,
            "required": [
              "ghsa",
              "blog",
              "changelog"
            ],
            "properties": {
              "ghsa": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "blog": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "changelog": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/CloudflareArchiveAdvisory"
            }
          }
        }
      },
      "GetEcosystemGroupPackageResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "data",
          "resolvedNames",
          "resolvedMode",
          "pagination",
          "_links"
        ],
        "description": "Product-index rows for a group/artifact package.",
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/EcosystemPackageEntry"
            }
          },
          "resolvedNames": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Union of the names `group:artifact` and `group/artifact` resolved to (each: up to three exact matches, otherwise up to ten fuzzy matches).",
            "minItems": 1
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy"
            ],
            "description": "`exact` when either form matched exactly, otherwise `fuzzy`."
          },
          "pagination": {
            "$ref": "#/components/schemas/EcosystemPackagePagination"
          },
          "_links": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Always three links, in this order: rel `versions` (`/v2/{name}/versions`), rel `product` (`/v2/product/{name}`) and rel `vulns` (`/v2/{name}/vulns`), where {name} is the lowercased `group:artifact`, path-escaped."
          }
        }
      },
      "GetEcosystemPackageResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "data",
          "resolvedNames",
          "resolvedMode",
          "pagination",
          "_links"
        ],
        "description": "Product-index rows for a package.",
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/EcosystemPackageEntry"
            }
          },
          "resolvedNames": {
            "type": "array",
            "maxItems": 10,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Canonical package names the path name resolved to: up to three exact matches (the name, and the name with `_` or `-` read as a space), otherwise up to ten fuzzy matches.",
            "minItems": 1
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy"
            ],
            "description": "How the name was resolved: `exact` match or `fuzzy` (trigram) fallback."
          },
          "pagination": {
            "$ref": "#/components/schemas/EcosystemPackagePagination"
          },
          "_links": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Always three links, in this order: rel `versions` (`/v2/{name}/versions`), rel `product` (`/v2/product/{name}`) and rel `vulns` (`/v2/{name}/vulns`), where {name} is the lowercased package segment, path-escaped."
          }
        }
      },
      "GetEcosystemPackageVersionsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "data",
          "resolvedNames",
          "resolvedMode",
          "pagination",
          "_links"
        ],
        "description": "Known versions of a package.",
        "properties": {
          "data": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/EcosystemPackageVersion"
            }
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Canonical package names the path name resolved to: up to three exact matches (the name, and the name with `_` or `-` read as a space), otherwise up to ten fuzzy matches. Null when nothing matched (`resolvedMode` is `empty`)."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name was resolved: `exact` match, `fuzzy` (trigram) fallback, or `empty` when nothing matched."
          },
          "pagination": {
            "$ref": "#/components/schemas/EcosystemPackagePagination"
          },
          "_links": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Always three links, in this order: rel `versions` (`/v2/{name}/versions`), rel `product` (`/v2/product/{name}`) and rel `vulns` (`/v2/{name}/vulns`), where {name} is the lowercased package segment, path-escaped."
          }
        }
      },
      "GetEolCalendarResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "windowStart",
          "windowEnd",
          "microsoft",
          "other"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds."
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "windowStart": {
            "type": "integer",
            "format": "int64",
            "minimum": -62167219200000,
            "maximum": 253402300799999,
            "description": "First millisecond of the month, Unix milliseconds UTC."
          },
          "windowEnd": {
            "type": "integer",
            "format": "int64",
            "minimum": -62167219200000,
            "maximum": 253402300799999,
            "description": "Last millisecond of the month, Unix milliseconds UTC."
          },
          "microsoft": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EolCalendarEntry"
            }
          },
          "other": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EolCalendarEntry"
            }
          },
          "withheld": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Below Pro only: vendor-lifecycle events left out (0 when none). Absent for Pro and above."
          },
          "_entitlements": {
            "$ref": "#/components/schemas/EolEntitlements"
          }
        }
      },
      "GetEolReleaseResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "productName",
          "release",
          "_links"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds."
          },
          "productName": {
            "type": "string",
            "maxLength": 128,
            "description": "The product slug as requested (percent-decoded)."
          },
          "release": {
            "$ref": "#/components/schemas/EolRelease"
          },
          "_links": {
            "type": "array",
            "maxItems": 1,
            "description": "One `product` link.",
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "minItems": 1
          }
        }
      },
      "GetExploitArchiveMetaResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "exploit",
          "s3",
          "filename",
          "archiveUrl"
        ],
        "properties": {
          "exploit": {
            "$ref": "#/components/schemas/ExploitArchiveRecord"
          },
          "s3": {
            "$ref": "#/components/schemas/ExploitArchiveS3Info"
          },
          "filename": {
            "type": "string",
            "maxLength": 1024
          },
          "archiveUrl": {
            "type": "string",
            "maxLength": 256
          }
        },
        "description": "An archived exploit's record and storage metadata."
      },
      "GetExploitTrendsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "totals",
          "monthly",
          "yearly",
          "topCvesByTier",
          "orphanedPredictions"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "Unix seconds when this answer was built. The answer is held for 24 hours, so this can be up to a day old."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "Unix seconds when the rollup was computed. Absent when the stored payload lacks it."
          },
          "totals": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ExploitTrendsTotals"
              },
              {
                "type": "object",
                "additionalProperties": false,
                "required": [],
                "properties": {}
              }
            ],
            "description": "`{}` when the stored payload has none."
          },
          "monthly": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 18,
            "items": {
              "$ref": "#/components/schemas/ExploitTrendsBucket"
            },
            "description": "The last 18 months, newest first."
          },
          "yearly": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "$ref": "#/components/schemas/ExploitTrendsBucket"
            },
            "description": "The last 10 years, newest first."
          },
          "topCvesByTier": {
            "$ref": "#/components/schemas/ExploitTrendsTopCves"
          },
          "orphanedPredictions": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ExploitTrendsOrphan"
            },
            "description": "Up to 50 CVEs with the highest EPSS or CESS score and no evidence in any other tier. Null when that query failed for this run."
          }
        },
        "description": "The global exploit-trends rollup."
      },
      "GetGoogleArchiveResponse": {
        "type": "object",
        "description": "One month of Google advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Google Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present.",
            "additionalProperties": false,
            "required": [
              "gcve",
              "google-cloud",
              "chrome",
              "android",
              "project-zero",
              "google-oss",
              "google-vendor"
            ],
            "properties": {
              "gcve": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "google-cloud": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "chrome": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "android": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "project-zero": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "google-oss": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "google-vendor": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/GoogleArchiveAdvisory"
            }
          }
        }
      },
      "GetMalwareTrendsResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "totals",
          "sources",
          "ecosystems",
          "monthly",
          "iocTypesBySource",
          "exposure"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the snapshot was computed, Unix seconds. Present when the snapshot carries it."
          },
          "windowMonths": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 120,
            "description": "Months covered. Present when the snapshot carries it."
          },
          "note": {
            "type": "string",
            "description": "How to read the counts. Present when the snapshot carries it."
          },
          "totals": {
            "type": "object",
            "description": "Grand totals over the window. `{}` when the snapshot lacks it.",
            "additionalProperties": false,
            "properties": {
              "advisories": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              "packages": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              "iocSamples": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              "actionableIocs": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              "actors": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              }
            }
          },
          "sources": {
            "type": "array",
            "maxItems": 4,
            "description": "One entry per feed (`ossf`, `osm`, `malscan`, `vulnetix-vdb`).",
            "items": {
              "type": "object",
              "required": [
                "key",
                "name",
                "advisories",
                "packages",
                "iocSamples",
                "actionableIocs",
                "actors"
              ],
              "additionalProperties": false,
              "properties": {
                "key": {
                  "type": "string",
                  "enum": [
                    "ossf",
                    "osm",
                    "malscan",
                    "vulnetix-vdb"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "advisories": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "packages": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "iocSamples": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "actionableIocs": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "actors": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              }
            }
          },
          "ecosystems": {
            "type": "array",
            "description": "One entry per ecosystem, most advisories first.",
            "items": {
              "type": "object",
              "required": [
                "ecosystem",
                "advisories",
                "packages",
                "iocSamples",
                "actionableIocs",
                "actors"
              ],
              "additionalProperties": false,
              "properties": {
                "ecosystem": {
                  "type": "string"
                },
                "advisories": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "packages": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "iocSamples": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "actionableIocs": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "actors": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              }
            }
          },
          "monthly": {
            "type": "array",
            "description": "One entry per month, feed and ecosystem.",
            "items": {
              "type": "object",
              "required": [
                "month",
                "source",
                "ecosystem",
                "advisories",
                "packages",
                "iocSamples",
                "actionableIocs",
                "actors"
              ],
              "additionalProperties": false,
              "properties": {
                "month": {
                  "type": "string",
                  "description": "`YYYY-MM`."
                },
                "source": {
                  "type": "string"
                },
                "ecosystem": {
                  "type": "string"
                },
                "advisories": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "packages": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "iocSamples": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "actionableIocs": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "actors": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              }
            }
          },
          "iocTypesBySource": {
            "type": "object",
            "description": "IOC samples per type for each feed, keyed feed then IOC type.",
            "maxProperties": 16,
            "additionalProperties": {
              "type": "object",
              "maxProperties": 256,
              "additionalProperties": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              }
            }
          },
          "exposure": {
            "type": "object",
            "description": "How long malicious packages stayed installable before their advisory, keyed feed then ecosystem (`_all` is the feed roll-up). Empty until packages have been checked against their registry.",
            "maxProperties": 16,
            "additionalProperties": {
              "type": "object",
              "maxProperties": 256,
              "additionalProperties": {
                "$ref": "#/components/schemas/MalwareExposureStats"
              }
            }
          }
        }
      },
      "GetMsrcPatchTuesdayPreparationResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "preparation"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "preparation": {
            "description": "The pending release, or null when no advisory is pending.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/MsrcPatchTuesdayPreparation"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "GetMsrcPatchTuesdayResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "id",
          "releaseDate",
          "dateSlug",
          "title",
          "cveCount",
          "exploitedCount",
          "kbCount",
          "patchedCount",
          "noPatchCount",
          "manifestUrl",
          "status",
          "isPreparation",
          "advisories"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "id": {
            "type": "string",
            "description": "Release id."
          },
          "releaseDate": {
            "type": "integer",
            "format": "int64",
            "description": "Release time, Unix milliseconds."
          },
          "dateSlug": {
            "type": "string",
            "format": "date",
            "description": "The requested date."
          },
          "title": {
            "type": "string"
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Advisories returned (one per CVE)."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Advisories flagged as exploited."
          },
          "kbCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Distinct KB articles across the advisories."
          },
          "patchedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Advisories with a vendor fix, a fixed build or a KB article."
          },
          "noPatchCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Advisories with none of those."
          },
          "manifestUrl": {
            "type": "string",
            "format": "uri",
            "description": "The release's manifest in the public MSRC archive."
          },
          "status": {
            "type": "string",
            "enum": [
              "Published"
            ]
          },
          "isPreparation": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "advisories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MsrcAdvisory"
            },
            "description": "Every advisory, ordered by CVE id."
          }
        }
      },
      "GetNvdDeepDiveResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "allTime",
          "yearly",
          "monthly"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this answer was assembled; it is held for up to 24 hours."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799999,
            "description": "Unix milliseconds when the background job ran. Absent if the job did not record it."
          },
          "allTime": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NvdDeepDiveBucket"
              },
              {
                "type": "object",
                "maxProperties": 0
              }
            ],
            "description": "All-time counts; `{}` only if the job did not record them."
          },
          "yearly": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 100,
            "description": "One bucket per publication year, oldest first; `null` when the job recorded none.",
            "items": {
              "$ref": "#/components/schemas/NvdDeepDiveBucket"
            }
          },
          "monthly": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 36,
            "description": "One bucket per month for the last 36 months, oldest first; `null` when the job recorded none.",
            "items": {
              "$ref": "#/components/schemas/NvdDeepDiveBucket"
            }
          }
        }
      },
      "GetOrgPackageStatsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "totalPackages",
          "totalVersions",
          "totalMalicious",
          "ecosystems",
          "publishHistogram"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Unix seconds when the answer was built (it may be up to 5 minutes old)."
          },
          "totalPackages": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Distinct package names."
          },
          "totalVersions": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Distinct name and version pairs."
          },
          "totalMalicious": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 20000,
            "description": "Malicious packages among at most 20,000 distinct names."
          },
          "ecosystems": {
            "type": "array",
            "maxItems": 50,
            "description": "Counts per ecosystem, largest first; `unknown` for packages with no recorded ecosystem.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "ecosystem",
                "packages",
                "versions"
              ],
              "properties": {
                "ecosystem": {
                  "type": "string",
                  "maxLength": 64
                },
                "packages": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "versions": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              }
            }
          },
          "publishHistogram": {
            "type": "array",
            "maxItems": 53,
            "description": "Distinct packages recorded per week over the last 52 weeks, oldest first.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "week",
                "count"
              ],
              "properties": {
                "week": {
                  "type": "string",
                  "format": "date",
                  "maxLength": 10,
                  "description": "Week start date (YYYY-MM-DD)."
                },
                "count": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              }
            }
          }
        }
      },
      "GetPackageEnrichmentResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packageName",
          "ecosystem",
          "requestedVersion",
          "purl",
          "resolvedNames",
          "resolvedMode",
          "timestamp",
          "total",
          "scorecard",
          "eol",
          "hasMalware",
          "versions",
          "pagination"
        ],
        "properties": {
          "packageName": {
            "type": "string",
            "maxLength": 512,
            "description": "Lowercased package name (from `purl` when it parsed)."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "Lowercased ecosystem; empty when none was given."
          },
          "requestedVersion": {
            "type": "string",
            "maxLength": 256,
            "description": "The version in use, from `version` or the purl; empty when none."
          },
          "purl": {
            "type": "string",
            "maxLength": 512,
            "description": "The `purl` as given; empty when addressed by name."
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Package names the VDB resolved the name to; null when none matched."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name resolved: exactly, by a fuzzy match (at most 10 names), or not at all."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Every known version, before the 500-version enrichment cap, filter and paging."
          },
          "scorecard": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "Highest OpenSSF Scorecard overall score, null when none."
          },
          "eol": {
            "description": "End-of-life status, null when the package maps to no product (below Pro, to no endoflife.date product).",
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/EolStatus"
              }
            ]
          },
          "hasMalware": {
            "type": "boolean",
            "description": "Whether any enriched version is flagged as malware."
          },
          "versions": {
            "type": "array",
            "maxItems": 100,
            "description": "One page of the enriched versions after `q`.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "version",
                "sources",
                "safeHarbour"
              ],
              "properties": {
                "version": {
                  "type": "string",
                  "maxLength": 256
                },
                "ecosystem": {
                  "type": "string",
                  "maxLength": 64,
                  "description": "The request's ecosystem; absent when none was given."
                },
                "sources": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "maxLength": 64
                  },
                  "description": "Where the version was found (`cve_affected` or a product-index source table)."
                },
                "safeHarbour": {
                  "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment).",
                  "oneOf": [
                    {
                      "type": "null"
                    },
                    {
                      "$ref": "#/components/schemas/SafeHarbourVersion"
                    }
                  ]
                }
              }
            }
          },
          "pagination": {
            "type": "object",
            "description": "Paging over the enriched versions after `q`; `totalRows` is at most 500.",
            "additionalProperties": false,
            "required": [
              "page",
              "perPage",
              "totalRows",
              "totalPages"
            ],
            "properties": {
              "page": {
                "type": "integer",
                "format": "int32",
                "minimum": 1
              },
              "perPage": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 100
              },
              "totalRows": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 500
              },
              "totalPages": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 500
              }
            }
          },
          "safeHarbour": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). The recommendation across every enriched version, aimed at the version in use; absent when no version is known.",
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/SafeHarbourSummary"
              }
            ]
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetPackageSafetyMatrixBulkResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "tier",
          "total",
          "packages"
        ],
        "properties": {
          "schemaVersion": {
            "type": "string",
            "enum": [
              "safety-matrix-bulk/v1"
            ]
          },
          "tier": {
            "type": "string",
            "enum": [
              "community"
            ]
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Unix seconds. Absent when the batch had no valid entry."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 100
          },
          "packages": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/SafetyMatrixBulkRow"
            },
            "description": "One row per distinct package, in request order."
          },
          "distro": {
            "$ref": "#/components/schemas/PackageDistroScope"
          }
        }
      },
      "GetPackageSafetyMatrixResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "packageName",
          "ecosystem",
          "selectedVersion",
          "resolvedNames",
          "resolvedMode",
          "tier",
          "timestamp",
          "total",
          "scorecard",
          "eolProduct",
          "live",
          "picks",
          "versions"
        ],
        "properties": {
          "schemaVersion": {
            "type": "string",
            "enum": [
              "safety-matrix/v1"
            ]
          },
          "packageName": {
            "type": "string",
            "maxLength": 512,
            "description": "The requested name, lowercased."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 32,
            "description": "The requested ecosystem, lowercased; empty when none."
          },
          "selectedVersion": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128,
            "description": "The `version` parameter; null when none."
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Package names the VDB resolved the name to; null when none matched."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name resolved."
          },
          "tier": {
            "type": "string",
            "enum": [
              "community"
            ],
            "description": "The rows carry only aggregates (no exploit, sighting or IOC detail) on every plan."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Version rows."
          },
          "scorecard": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "Highest OpenSSF Scorecard overall score, null when none."
          },
          "eolProduct": {
            "description": "The end-of-life product the package maps to (below Pro, only an endoflife.date product); null when none.",
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/EolStatus"
              }
            ]
          },
          "live": {
            "type": "object",
            "description": "Where the versions came from beyond the VDB inventory.",
            "additionalProperties": false,
            "required": [
              "merged",
              "source",
              "addedVersions",
              "versionSource",
              "sourceRepo",
              "releasesRead"
            ],
            "properties": {
              "merged": {
                "type": "boolean",
                "description": "True when the registry was read successfully."
              },
              "source": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 32,
                "description": "The registry read (the ecosystem); null when none."
              },
              "addedVersions": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "description": "Versions the registry added beyond the inventory."
              },
              "versionSource": {
                "type": "string",
                "enum": [
                  "registry",
                  "github-releases",
                  "github-tags"
                ],
                "description": "`github-releases` or `github-tags` when nothing else knew a version and the GitHub repository was read; `registry` otherwise."
              },
              "sourceRepo": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256,
                "description": "`owner/name` of the GitHub repository read; null otherwise."
              },
              "releasesRead": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 200,
                "description": "GitHub releases or tags read before filtering; 0 when GitHub was not read."
              }
            }
          },
          "picks": {
            "$ref": "#/components/schemas/SafeHarbourPicks"
          },
          "versions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PackageSafetyMatrixRow"
            },
            "description": "Newest first under the ecosystem's version order."
          },
          "distro": {
            "$ref": "#/components/schemas/PackageDistroScope"
          }
        }
      },
      "GetPackageStatsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "totalPackages",
          "totalVersions",
          "totalMalicious",
          "ecosystems",
          "publishHistogram",
          "malware"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Unix seconds when the answer was built (it may be up to 10 minutes old)."
          },
          "totalPackages": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "totalVersions": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "totalMalicious": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "ecosystems": {
            "type": [
              "array",
              "null"
            ],
            "description": "Dependency records per ecosystem, the 50 largest (nightly row `package_ecosystem_counts`; `packages` and `versions` are both the record count). Null when the nightly query returned no rows.",
            "items": {
              "type": "object",
              "maxProperties": 16,
              "properties": {
                "ecosystem": {
                  "type": "string",
                  "maxLength": 64
                },
                "packages": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "versions": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              }
            },
            "maxItems": 50
          },
          "publishHistogram": {
            "type": [
              "array",
              "null"
            ],
            "description": "Package versions discovered per week over the last 52 weeks, oldest first (nightly row `package_publish_histogram_12m`). Null when the nightly query returned no rows.",
            "items": {
              "type": "object",
              "maxProperties": 16,
              "properties": {
                "week": {
                  "type": "string",
                  "format": "date-time",
                  "maxLength": 32,
                  "description": "Week start (Monday, 00:00 UTC) as RFC 3339."
                },
                "count": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              }
            },
            "maxItems": 54
          },
          "malware": {
            "type": "object",
            "description": "Malware IOC rollup.",
            "additionalProperties": false,
            "required": [
              "ecosystems",
              "monthlyHistogram"
            ],
            "properties": {
              "ecosystems": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "Malware IOCs per ecosystem, the 50 largest (nightly row `malware_ioc_ecosystem_counts`). Null when the nightly query returned no rows.",
                "items": {
                  "type": "object",
                  "maxProperties": 16,
                  "properties": {
                    "ecosystem": {
                      "type": "string",
                      "maxLength": 64
                    },
                    "iocs": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 0
                    }
                  }
                },
                "maxItems": 50
              },
              "monthlyHistogram": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "Malware IOCs per month and ecosystem over 24 months, by advisory publish date, ordered by month then ecosystem (nightly row `malware_ioc_monthly_24m`). Null when the nightly query returned no rows.",
                "items": {
                  "type": "object",
                  "maxProperties": 16,
                  "properties": {
                    "month": {
                      "type": "string",
                      "maxLength": 7,
                      "pattern": "^[0-9]{4}-[0-9]{2}$",
                      "description": "YYYY-MM."
                    },
                    "ecosystem": {
                      "type": "string",
                      "maxLength": 64
                    },
                    "count": {
                      "type": "integer",
                      "format": "int64",
                      "minimum": 0
                    }
                  }
                }
              }
            }
          }
        }
      },
      "GetProductResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packageName",
          "resolvedNames",
          "resolvedMode",
          "timestamp",
          "total",
          "limit",
          "offset",
          "hasMore",
          "versions",
          "_links"
        ],
        "description": "Versions of a package or product from the product index.",
        "properties": {
          "packageName": {
            "type": "string",
            "maxLength": 1024,
            "description": "The path name, percent-decoded and lowercased."
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Canonical package names the path name resolved to: up to three exact matches (the name, and the name with `_` or `-` read as a space), otherwise up to ten fuzzy matches. Null when nothing matched (`resolvedMode` is `empty`)."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name was resolved: `exact` match, `fuzzy` (trigram) fallback, or `empty` when nothing matched."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix time in seconds when the answer was built."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Distinct (version, ecosystem) pairs that match."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "Page size, as applied (index rows)."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9223372036854775807,
            "description": "Items skipped, as applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit` is less than `total`."
          },
          "versions": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/ProductVersionRecord"
            },
            "description": "The (version, ecosystem) pairs on this page. Null when the name resolved to nothing or the index query failed; an empty array when names resolved but no index row is on this page."
          },
          "safeHarbour": {
            "$ref": "#/components/schemas/SafeHarbourSummary"
          },
          "_links": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Always three links, in this order: rel `versions` (`/v2/{name}/versions`), rel `product` (`/v2/product/{name}`) and rel `vulns` (`/v2/{name}/vulns`), where {name} is the lowercased path name, path-escaped."
          }
        }
      },
      "GetProductVersionEcosystemResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packageName",
          "resolvedNames",
          "resolvedMode",
          "timestamp",
          "total",
          "limit",
          "offset",
          "hasMore",
          "versions",
          "_links",
          "version",
          "ecosystem"
        ],
        "description": "One version of a package in one ecosystem from the product index.",
        "properties": {
          "packageName": {
            "type": "string",
            "maxLength": 1024,
            "description": "The path name, percent-decoded and lowercased."
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Canonical package names the path name resolved to: up to three exact matches (the name, and the name with `_` or `-` read as a space), otherwise up to ten fuzzy matches. Null when nothing matched (`resolvedMode` is `empty`)."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name was resolved: `exact` match, `fuzzy` (trigram) fallback, or `empty` when nothing matched."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix time in seconds when the answer was built."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Distinct (version, ecosystem) pairs for this version and ecosystem (0 or 1)."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "Page size, as applied (index rows)."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9223372036854775807,
            "description": "Items skipped, as applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit` is less than `total`."
          },
          "versions": {
            "type": "array",
            "maxItems": 1,
            "items": {
              "$ref": "#/components/schemas/ProductVersionRecord"
            },
            "description": "At most one entry: the path version in the path ecosystem, when the index holds it."
          },
          "safeHarbour": {
            "$ref": "#/components/schemas/SafeHarbourSummary"
          },
          "_links": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Always three links, in this order: rel `versions` (`/v2/{name}/versions`), rel `product` (`/v2/product/{name}`) and rel `vulns` (`/v2/{name}/vulns`), where {name} is the lowercased path name, path-escaped."
          },
          "version": {
            "type": "string",
            "maxLength": 1024,
            "description": "The path version, percent-decoded."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "The path ecosystem, lowercased."
          }
        }
      },
      "GetRedhatArchiveResponse": {
        "type": "object",
        "description": "One month of Red Hat advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "rhsaCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — Red Hat Security Advisories`."
          },
          "rhsaCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct ids in the advisories' `cveAliases`."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "type": "object",
            "description": "Distinct RHSAs per Red Hat severity, from Red Hat's own scores. Only buckets with RHSAs are present.",
            "maxProperties": 5,
            "additionalProperties": false,
            "properties": {
              "Critical": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "Important": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "Moderate": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "Low": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              },
              "Unrated": {
                "type": "integer",
                "format": "int32",
                "minimum": 1,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/RedHatArchiveAdvisory"
            }
          }
        }
      },
      "GetSummaryResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "database",
          "severity",
          "coverage",
          "topCWEs",
          "topVendors",
          "enrichment"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this answer was assembled; it is held for up to 24 hours."
          },
          "database": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "totalRows",
              "distinctCveIds",
              "totalExploits",
              "maliciousPackages",
              "cvesWithExploits",
              "totalReferences",
              "distinctReferenceUrls",
              "totalKev",
              "ghsaTotal",
              "ghsaNoCve",
              "nonCveTotal",
              "vulnetixEnriched"
            ],
            "properties": {
              "totalRows": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Advisory records across all sources (one vulnerability can have several)."
              },
              "distinctCveIds": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Distinct vulnerability identifiers."
              },
              "totalExploits": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Exploit records."
              },
              "maliciousPackages": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Exploit records that are malicious packages."
              },
              "cvesWithExploits": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Vulnerabilities with at least one exploit record."
              },
              "totalReferences": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Reference records."
              },
              "distinctReferenceUrls": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Distinct reference URLs."
              },
              "totalKev": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Vulnerabilities in the CISA KEV catalogue."
              },
              "ghsaTotal": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "GHSA identifiers."
              },
              "ghsaNoCve": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "GHSA identifiers with no CVE."
              },
              "nonCveTotal": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Identifiers that are not CVE ids."
              },
              "vulnetixEnriched": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Vulnerabilities enriched by Vulnetix."
              }
            }
          },
          "severity": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "critical",
              "high",
              "medium",
              "low",
              "none"
            ],
            "description": "Distinct vulnerabilities per CVSS base severity.",
            "properties": {
              "critical": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Critical."
              },
              "high": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "High."
              },
              "medium": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Medium."
              },
              "low": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Low."
              },
              "none": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "None."
              }
            }
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "withCvss",
              "cvssV2Count",
              "cvssV3Count",
              "cvssV4Count",
              "withEpss",
              "withCess",
              "withCwe",
              "withCapec",
              "withSsvc",
              "noReferences",
              "averageEpss",
              "highEpss",
              "epssCves"
            ],
            "description": "How many vulnerabilities carry each kind of data.",
            "properties": {
              "withCvss": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With at least one CVSS score."
              },
              "cvssV2Count": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With a CVSS v2.0 score."
              },
              "cvssV3Count": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With a CVSS v3.x score."
              },
              "cvssV4Count": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With a CVSS v4.0 score."
              },
              "withEpss": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With an EPSS score."
              },
              "withCess": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With a CESS score."
              },
              "withCwe": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With a CWE."
              },
              "withCapec": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With a CAPEC attack pattern."
              },
              "withSsvc": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With an SSVC decision."
              },
              "noReferences": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With no reference URL (distinct identifiers minus those with references, floored at 0)."
              },
              "averageEpss": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1,
                "description": "Mean of each vulnerability's latest EPSS score (six decimal places)."
              },
              "highEpss": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With a latest EPSS score of 0.7 or more."
              },
              "epssCves": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "With an EPSS score (same figure as `withEpss`)."
              }
            }
          },
          "topCWEs": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "description": "The ten CWEs with the most records, descending. `[]` before the job has produced it; `null` when the job ran but stored an empty result.",
            "items": {
              "$ref": "#/components/schemas/SummaryTopCwe"
            }
          },
          "topVendors": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "description": "The ten vendors with the most affected-product records, descending (vendor names normalised: lower-cased, `csaf_` prefix and release suffixes removed, then a display name applied). `[]` before the job has produced it; `null` when the job ran but stored an empty result.",
            "items": {
              "$ref": "#/components/schemas/SummaryTopVendor"
            }
          },
          "enrichment": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "snortRules",
              "enrichedIDS",
              "patchableAll",
              "patchableCve",
              "enrichedCPE",
              "enrichedPURL",
              "enrichedPatchable",
              "enrichedCRIT"
            ],
            "properties": {
              "snortRules": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Snort rules (an estimate from table statistics)."
              },
              "enrichedIDS": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Vulnerabilities with at least one Snort rule."
              },
              "patchableAll": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Patchable vulnerabilities, all identifier kinds."
              },
              "patchableCve": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Patchable CVE ids."
              },
              "enrichedCPE": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Vulnerabilities enriched with CPEs."
              },
              "enrichedPURL": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Vulnerabilities enriched with package URLs."
              },
              "enrichedPatchable": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Enriched patchable vulnerabilities."
              },
              "enrichedCRIT": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Vulnerabilities with CRIT cloud-resource records."
              }
            }
          }
        }
      },
      "GetSuseArchiveResponse": {
        "type": "object",
        "description": "One month of SUSE advisories. Not paginated: the whole month is returned.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "severityCounts",
          "sourceBreakdown",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/VendorArchiveBuiltAt"
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "`<Month YYYY> — SUSE Security Advisories`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Entries in `advisories`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Entries with `isExploited` true."
          },
          "severityCounts": {
            "$ref": "#/components/schemas/VendorArchiveSeverityCounts"
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Entries per `kind`. Every key is always present.",
            "additionalProperties": false,
            "required": [
              "sles",
              "opensuse",
              "rancher"
            ],
            "properties": {
              "sles": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "opensuse": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              },
              "rancher": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 1000000
              }
            }
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50000,
            "items": {
              "$ref": "#/components/schemas/SuseArchiveAdvisory"
            }
          }
        }
      },
      "GetTriageFeedResponse": {
        "type": "object",
        "description": "A page of the triage feed. There is no total.",
        "required": [
          "timestamp",
          "count",
          "limit",
          "offset",
          "items"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "items": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/TriageFeedItem"
            }
          }
        }
      },
      "GetVendorTrendsResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "monthly",
          "yearly"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this answer was assembled; it is held for up to 24 hours."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the background job computed the series. Absent if the job did not record it."
          },
          "monthly": {
            "type": "array",
            "maxItems": 18,
            "description": "Last 18 months, newest first.",
            "items": {
              "$ref": "#/components/schemas/VendorTrendPeriod"
            }
          },
          "yearly": {
            "type": "array",
            "maxItems": 10,
            "description": "Last 10 calendar years, newest first.",
            "items": {
              "$ref": "#/components/schemas/VendorTrendPeriod"
            }
          }
        }
      },
      "GetVulnAdvisoriesResponse": {
        "type": "object",
        "description": "Vendor advisories, solutions and statements for one vulnerability.",
        "required": [
          "identifier",
          "timestamp",
          "state",
          "title",
          "aliases",
          "vendorComments",
          "solutions",
          "aiAdvisory",
          "descriptions",
          "references",
          "msrcPatches",
          "redhatAdvisories",
          "vendorPatches"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "vendorComments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationVendorComment"
            }
          },
          "solutions": {
            "type": "array",
            "description": "`solutions` from each source's CNA and ADP containers, and NVD's evaluator solution.",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "aiAdvisory": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vulnesis's AI analysis (the triage analysis when there is one); null when none."
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "references": {
            "type": "array",
            "maxItems": 20,
            "description": "Advisory references (ADVISORY / Vendor Advisory type, or `advisory` in the URL), at most 20.",
            "items": {
              "$ref": "#/components/schemas/RemediationReference"
            }
          },
          "msrcPatches": {
            "type": "array",
            "maxItems": 100,
            "description": "Microsoft products and their KB updates, at most 100.",
            "items": {
              "$ref": "#/components/schemas/RemediationMsrcKbPatch"
            }
          },
          "redhatAdvisories": {
            "type": "array",
            "description": "Newest first, at most 50 from Red Hat records; with none, one per Red Hat product on affected rows.",
            "items": {
              "$ref": "#/components/schemas/RemediationRedHatAdvisory"
            }
          },
          "vendorPatches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationVendorPatch"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          }
        }
      },
      "GetVulnAdvisoriesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnAdvisoriesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnAdvisoriesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnAdvisoriesResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `GetVulnAdvisoriesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "vendorComments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationVendorComment"
            }
          },
          "solutions": {
            "type": "array",
            "description": "`solutions` from each source's CNA and ADP containers, and NVD's evaluator solution.",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "aiAdvisory": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vulnesis's AI analysis (the triage analysis when there is one); null when none."
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "references": {
            "type": "array",
            "maxItems": 20,
            "description": "Advisory references (ADVISORY / Vendor Advisory type, or `advisory` in the URL), at most 20.",
            "items": {
              "$ref": "#/components/schemas/RemediationReference"
            }
          },
          "msrcPatches": {
            "type": "array",
            "maxItems": 100,
            "description": "Microsoft products and their KB updates, at most 100.",
            "items": {
              "$ref": "#/components/schemas/RemediationMsrcKbPatch"
            }
          },
          "redhatAdvisories": {
            "type": "array",
            "description": "Newest first, at most 50 from Red Hat records; with none, one per Red Hat product on affected rows.",
            "items": {
              "$ref": "#/components/schemas/RemediationRedHatAdvisory"
            }
          },
          "vendorPatches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationVendorPatch"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "GetVulnCweGuidanceResponse": {
        "type": "object",
        "description": "Weakness-based remediation guidance for one vulnerability.",
        "required": [
          "identifier",
          "timestamp",
          "state",
          "title",
          "aliases",
          "cwes"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "cwes": {
            "type": "array",
            "description": "One per distinct weakness row; empty when none.",
            "items": {
              "$ref": "#/components/schemas/CweGuidanceEntry"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          }
        }
      },
      "GetVulnCweGuidanceResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnCweGuidanceResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnCweGuidanceResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnCweGuidanceResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `GetVulnCweGuidanceResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "cwes": {
            "type": "array",
            "description": "One per distinct weakness row; empty when none.",
            "items": {
              "$ref": "#/components/schemas/CweGuidanceEntry"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "GetVulnExploitIntelligenceResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "exploitCount",
          "sightingCount",
          "summary",
          "exploits",
          "_links"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The vulnerability id, normalised and alias-resolved."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Records in this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Records in the whole set."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean"
          },
          "exploitCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Exploit, PoC and bounty records in the whole set."
          },
          "sightingCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Sighting and KEV records in the whole set."
          },
          "summary": {
            "$ref": "#/components/schemas/ExploitIntelSummary"
          },
          "exploits": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 1000,
            "items": {
              "$ref": "#/components/schemas/ExploitIntelRecord"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). One page of records, newest first."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other views of this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        },
        "description": "Every exploit, sighting, bounty and KEV record held for one vulnerability."
      },
      "GetVulnInfoResponse": {
        "type": "object",
        "description": "Which sources hold a vulnerability, how much each kind of data they hold, and where the source files are.",
        "required": [
          "_identifier",
          "_timestamp",
          "cache_hit",
          "matched",
          "gcve",
          "lastFetchedAt",
          "lastEnrichedAt",
          "sources",
          "aliases",
          "references",
          "problemTypes",
          "metrics",
          "affected",
          "impacts",
          "descriptions",
          "scorecards",
          "links",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "_identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier looked up: the path value with its family prefix upper-cased, then resolved through the alias table to its primary id."
          },
          "_timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "When the answer was built, Unix seconds."
          },
          "cache_hit": {
            "type": "boolean",
            "enum": [
              false
            ],
            "description": "Always false; kept for compatibility."
          },
          "matched": {
            "type": "boolean",
            "description": "Whether any source has a metadata row for the id. An unknown id answers 200 with `matched: false`, zero counts and null arrays."
          },
          "gcve": {
            "type": "boolean",
            "description": "Whether a GCVE issuance names the id."
          },
          "lastFetchedAt": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800000,
            "description": "Latest time any source row was fetched, Unix milliseconds; null when none records one."
          },
          "lastEnrichedAt": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800000,
            "description": "Latest time any source row was enriched, Unix milliseconds; null when none records one."
          },
          "sources": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 64,
            "items": {
              "type": "object",
              "required": [
                "name",
                "processing"
              ],
              "additionalProperties": false,
              "properties": {
                "name": {
                  "type": "string",
                  "maxLength": 64,
                  "description": "The source as stored (for example `nist-nvd`, `github`, `osv`, `redhat`, `msrc`, `cisa-kev`)."
                },
                "processing": {
                  "type": "boolean",
                  "description": "True when the source's file is stored but its metadata row is not loaded yet."
                }
              }
            },
            "description": "Sources that hold the id. Null when none does."
          },
          "aliases": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other advisory ids for the same vulnerability, both directions. Null when there are none."
          },
          "references": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Reference rows across sources."
          },
          "problemTypes": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Problem type (CWE) rows across sources."
          },
          "metrics": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Metric rows (CVSS, SSVC and others) across sources."
          },
          "affected": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Affected-product rows across sources."
          },
          "impacts": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Impact (CAPEC) rows across sources."
          },
          "descriptions": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Description rows across sources."
          },
          "scorecards": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Source rows linked to an OpenSSF Scorecard."
          },
          "links": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 9,
            "items": {
              "type": "object",
              "required": [
                "type",
                "format",
                "url"
              ],
              "additionalProperties": false,
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "page",
                    "mitre",
                    "nist-nvd",
                    "vulncheck-nvd",
                    "vulncheck-kev",
                    "cisa-kev",
                    "ghsa",
                    "osv",
                    "euvd"
                  ],
                  "description": "`page` for the vulnerability's web page, otherwise the source whose stored file this is."
                },
                "format": {
                  "type": "string",
                  "enum": [
                    "http",
                    "cvelistV5",
                    "nvd-json-2.0",
                    "vulncheck-kev",
                    "cisa-kev",
                    "osv",
                    "euvd"
                  ]
                },
                "url": {
                  "type": "string",
                  "maxLength": 2048,
                  "format": "uri"
                }
              }
            },
            "description": "The web page (when matched) and the stored source files. For every source except MITRE the file is that source's latest bulk file, not a per-vulnerability file. Null when there are none."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          }
        }
      },
      "GetVulnIocsResponse": {
        "type": "object",
        "description": "CrowdSec sightings and the Shadowserver summary for one vulnerability.",
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "sightings",
          "shadowserver",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The id answered for, after alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Sightings returned (at most 200)."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Equals `count`; the sightings are not paged."
          },
          "sightings": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/CrowdSecIocSighting"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). The sightings, newest first."
          },
          "shadowserver": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": false,
            "required": [
              "count1d",
              "count7dAvg",
              "count30dAvg",
              "count90dAvg",
              "topCountries"
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when Shadowserver has nothing for the id.",
            "properties": {
              "count1d": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1E+12,
                "description": "Hosts in the last day."
              },
              "count7dAvg": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1E+12
              },
              "count30dAvg": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1E+12
              },
              "count90dAvg": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1E+12
              },
              "topCountries": {
                "type": "array",
                "maxItems": 10,
                "items": {
                  "type": "object",
                  "required": [
                    "country",
                    "countryName",
                    "count"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "country": {
                      "type": "string",
                      "maxLength": 8
                    },
                    "countryName": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 128
                    },
                    "count": {
                      "type": "number",
                      "format": "double",
                      "minimum": 0,
                      "maximum": 1E+12
                    }
                  }
                }
              },
              "lastObservationDate": {
                "type": "string",
                "format": "date-time",
                "maxLength": 35
              }
            }
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, ...); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The record title from the most authoritative source; null when none has one."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Aliases of the id, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnIocsResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnIocsResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnIocsResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnIocsResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `GetVulnIocsResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The id answered for, after alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Sightings returned (at most 200)."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Equals `count`; the sightings are not paged."
          },
          "sightings": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/CrowdSecIocSighting"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). The sightings, newest first."
          },
          "shadowserver": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": false,
            "required": [
              "count1d",
              "count7dAvg",
              "count30dAvg",
              "count90dAvg",
              "topCountries"
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when Shadowserver has nothing for the id.",
            "properties": {
              "count1d": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1E+12,
                "description": "Hosts in the last day."
              },
              "count7dAvg": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1E+12
              },
              "count30dAvg": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1E+12
              },
              "count90dAvg": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1E+12
              },
              "topCountries": {
                "type": "array",
                "maxItems": 10,
                "items": {
                  "type": "object",
                  "required": [
                    "country",
                    "countryName",
                    "count"
                  ],
                  "additionalProperties": false,
                  "properties": {
                    "country": {
                      "type": "string",
                      "maxLength": 8
                    },
                    "countryName": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 128
                    },
                    "count": {
                      "type": "number",
                      "format": "double",
                      "minimum": 0,
                      "maximum": 1E+12
                    }
                  }
                }
              },
              "lastObservationDate": {
                "type": "string",
                "format": "date-time",
                "maxLength": 35
              }
            }
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, ...); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The record title from the most authoritative source; null when none has one."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Aliases of the id, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "GetVulnKevResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "inKev",
          "entries",
          "vulnCheckKev",
          "crowdSecSummary",
          "exploitationSignals",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000
          },
          "inKev": {
            "type": "boolean",
            "description": "Listed in any KEV catalogue held, VulnCheck included."
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VulnKevEntry"
            },
            "description": "CISA, ENISA and Vulnesis KEV entries, newest first. Visible on every plan."
          },
          "vulnCheckKev": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/VulnCheckKevEntry"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). VulnCheck KEV entries with their reported exploitations and XDB exploits."
          },
          "crowdSecSummary": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CrowdSecSummary"
              }
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when CrowdSec has no sighting."
          },
          "exploitationSignals": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/VulnKevExploitationSignals"
              }
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). A summary of the exploitation signals."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other views of this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (PUBLISHED, REJECTED, ...). Null when no record is held."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one. Null when none."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other ids for this vulnerability, both directions, at most 20."
          }
        },
        "description": "KEV listings and exploitation signals for one vulnerability."
      },
      "GetVulnKevResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnKevResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnKevResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnKevResponseWithVulnId": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vulnId"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000
          },
          "inKev": {
            "type": "boolean",
            "description": "Listed in any KEV catalogue held, VulnCheck included."
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VulnKevEntry"
            },
            "description": "CISA, ENISA and Vulnesis KEV entries, newest first. Visible on every plan."
          },
          "vulnCheckKev": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/VulnCheckKevEntry"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). VulnCheck KEV entries with their reported exploitations and XDB exploits."
          },
          "crowdSecSummary": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CrowdSecSummary"
              }
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when CrowdSec has no sighting."
          },
          "exploitationSignals": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/VulnKevExploitationSignals"
              }
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). A summary of the exploitation signals."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other views of this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (PUBLISHED, REJECTED, ...). Null when no record is held."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one. Null when none."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other ids for this vulnerability, both directions, at most 20."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `GetVulnKevResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "GetVulnRemediationPlanResponse": {
        "type": "object",
        "description": "A remediation plan for one vulnerability, with the data it was built from.",
        "required": [
          "identifier",
          "timestamp",
          "state",
          "title",
          "aliases",
          "context",
          "severity",
          "ssvc",
          "fixAvailability",
          "actions",
          "guidance",
          "timeline",
          "references",
          "relatedCves",
          "registryFixes",
          "sourceFixes",
          "distributionPatches",
          "workarounds",
          "configurations",
          "solutions",
          "vendorComments",
          "aiAdvisory",
          "advisoryReferences",
          "cwes",
          "kevEntries",
          "vulnCheckKev",
          "exploitationSignals",
          "msrcAdvisory",
          "redhatAdvisories",
          "snortRules",
          "snortRuleCount",
          "description",
          "descriptions",
          "crowdSecSummary",
          "channelActions"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the plan was built (Unix seconds); a cached plan keeps it."
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "description": {
            "type": "string",
            "description": "The first English description (else the first of any language); empty when none."
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "context": {
            "$ref": "#/components/schemas/RemediationPlanContext"
          },
          "severity": {
            "$ref": "#/components/schemas/RemediationPlanSeverity"
          },
          "ssvc": {
            "$ref": "#/components/schemas/RemediationPlanSsvc"
          },
          "fixAvailability": {
            "type": "string",
            "enum": [
              "no_fix",
              "multiple",
              "registry_available",
              "distribution_patch",
              "source_only"
            ],
            "description": "Which kinds of fix exist: `multiple` when more than one of registry, source and distribution."
          },
          "actions": {
            "type": "array",
            "minItems": 1,
            "description": "The plan in priority order (see the operation description).",
            "items": {
              "$ref": "#/components/schemas/RemediationPlanAction"
            }
          },
          "guidance": {
            "type": "string",
            "description": "Remediation guidance text with `includeGuidance=true`; the empty string otherwise."
          },
          "timeline": {
            "$ref": "#/components/schemas/RemediationPlanTimeline"
          },
          "references": {
            "type": "array",
            "maxItems": 20,
            "description": "The first 20 references; `source` holds the reference type here.",
            "items": {
              "$ref": "#/components/schemas/RemediationReference"
            }
          },
          "relatedCves": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "type": "string"
            },
            "description": "Always null today: the lookup reads columns the alias table does not have."
          },
          "registryFixes": {
            "type": "array",
            "description": "Every registry fix, filtered by ecosystem and packageName; not paged.",
            "items": {
              "$ref": "#/components/schemas/RemediationRegistryFix"
            }
          },
          "sourceFixes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationSourceFix"
            }
          },
          "distributionPatches": {
            "type": "array",
            "description": "From advisory references only, narrowed by `os` and the image base OS.",
            "items": {
              "$ref": "#/components/schemas/RemediationDistributionPatch"
            }
          },
          "workarounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "configurations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "solutions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "vendorComments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationVendorComment"
            }
          },
          "aiAdvisory": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vulnesis's AI analysis; null when none."
          },
          "advisoryReferences": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/RemediationReference"
            }
          },
          "cwes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CweGuidanceEntry"
            }
          },
          "kevEntries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationPlanKevEntry"
            }
          },
          "vulnCheckKev": {
            "type": "array",
            "description": "Not plan-gated here, although GET /vuln/{identifier}/kev gates it.",
            "items": {
              "$ref": "#/components/schemas/RemediationVulnCheckKevEntry"
            }
          },
          "exploitationSignals": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment).",
            "oneOf": [
              {
                "$ref": "#/components/schemas/RemediationExploitationSignals"
              },
              {
                "type": "null"
              }
            ]
          },
          "crowdSecSummary": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Null without sightings too.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/CrowdSecSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "msrcAdvisory": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/RemediationMsrcAdvisory"
              },
              {
                "type": "null"
              }
            ],
            "description": "Null when Microsoft has no advisory for it."
          },
          "redhatAdvisories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationPlanRedHatAdvisory"
            }
          },
          "snortRules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationSnortRule"
            }
          },
          "snortRuleCount": {
            "type": "integer",
            "format": "int32"
          },
          "channelActions": {
            "$ref": "#/components/schemas/RemediationChannelActions"
          },
          "versionComparison": {
            "$ref": "#/components/schemas/RemediationVersionComparison"
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnRemediationPlanResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnRemediationPlanResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnRemediationPlanResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnRemediationPlanResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `GetVulnRemediationPlanResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the plan was built (Unix seconds); a cached plan keeps it."
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "description": {
            "type": "string",
            "description": "The first English description (else the first of any language); empty when none."
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "context": {
            "$ref": "#/components/schemas/RemediationPlanContext"
          },
          "severity": {
            "$ref": "#/components/schemas/RemediationPlanSeverity"
          },
          "ssvc": {
            "$ref": "#/components/schemas/RemediationPlanSsvc"
          },
          "fixAvailability": {
            "type": "string",
            "enum": [
              "no_fix",
              "multiple",
              "registry_available",
              "distribution_patch",
              "source_only"
            ],
            "description": "Which kinds of fix exist: `multiple` when more than one of registry, source and distribution."
          },
          "actions": {
            "type": "array",
            "minItems": 1,
            "description": "The plan in priority order (see the operation description).",
            "items": {
              "$ref": "#/components/schemas/RemediationPlanAction"
            }
          },
          "guidance": {
            "type": "string",
            "description": "Remediation guidance text with `includeGuidance=true`; the empty string otherwise."
          },
          "timeline": {
            "$ref": "#/components/schemas/RemediationPlanTimeline"
          },
          "references": {
            "type": "array",
            "maxItems": 20,
            "description": "The first 20 references; `source` holds the reference type here.",
            "items": {
              "$ref": "#/components/schemas/RemediationReference"
            }
          },
          "relatedCves": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "type": "string"
            },
            "description": "Always null today: the lookup reads columns the alias table does not have."
          },
          "registryFixes": {
            "type": "array",
            "description": "Every registry fix, filtered by ecosystem and packageName; not paged.",
            "items": {
              "$ref": "#/components/schemas/RemediationRegistryFix"
            }
          },
          "sourceFixes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationSourceFix"
            }
          },
          "distributionPatches": {
            "type": "array",
            "description": "From advisory references only, narrowed by `os` and the image base OS.",
            "items": {
              "$ref": "#/components/schemas/RemediationDistributionPatch"
            }
          },
          "workarounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "configurations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "solutions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "vendorComments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationVendorComment"
            }
          },
          "aiAdvisory": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vulnesis's AI analysis; null when none."
          },
          "advisoryReferences": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/RemediationReference"
            }
          },
          "cwes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CweGuidanceEntry"
            }
          },
          "kevEntries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationPlanKevEntry"
            }
          },
          "vulnCheckKev": {
            "type": "array",
            "description": "Not plan-gated here, although GET /vuln/{identifier}/kev gates it.",
            "items": {
              "$ref": "#/components/schemas/RemediationVulnCheckKevEntry"
            }
          },
          "exploitationSignals": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment).",
            "oneOf": [
              {
                "$ref": "#/components/schemas/RemediationExploitationSignals"
              },
              {
                "type": "null"
              }
            ]
          },
          "crowdSecSummary": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Null without sightings too.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/CrowdSecSummary"
              },
              {
                "type": "null"
              }
            ]
          },
          "msrcAdvisory": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/RemediationMsrcAdvisory"
              },
              {
                "type": "null"
              }
            ],
            "description": "Null when Microsoft has no advisory for it."
          },
          "redhatAdvisories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationPlanRedHatAdvisory"
            }
          },
          "snortRules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RemediationSnortRule"
            }
          },
          "snortRuleCount": {
            "type": "integer",
            "format": "int32"
          },
          "channelActions": {
            "$ref": "#/components/schemas/RemediationChannelActions"
          },
          "versionComparison": {
            "$ref": "#/components/schemas/RemediationVersionComparison"
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "GetVulnScorecardResponse": {
        "type": "object",
        "required": [
          "identifier",
          "timestamp",
          "scorecards",
          "total",
          "commitHealth",
          "prRepoHealth",
          "sourceFixCorrelation",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id, normalised and alias-resolved."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix seconds."
          },
          "scorecards": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "$ref": "#/components/schemas/ScorecardEntry"
            }
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 64
          },
          "commitHealth": {
            "description": "The first stored fix-commit health record for the vulnerability's references, as stored (JSON); null when there is none."
          },
          "prRepoHealth": {
            "description": "The first stored pull-request repository health record, as stored (JSON); null when there is none."
          },
          "sourceFixCorrelation": {
            "type": [
              "object",
              "null"
            ],
            "description": "Whether a fix commit (from the first five commit references) lies in a scorecarded repository. Null when there is no commit reference.",
            "additionalProperties": false,
            "required": [
              "hasFixCommit",
              "fixCommitSha",
              "fixCommitInScorecardRepo",
              "scorecardScoreAtFixTime"
            ],
            "properties": {
              "hasFixCommit": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "fixCommitSha": {
                "type": "string",
                "maxLength": 64
              },
              "fixCommitInScorecardRepo": {
                "type": "boolean"
              },
              "scorecardScoreAtFixTime": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": -1,
                "maximum": 10
              }
            }
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, DISPUTED and the like); null when no source gives one."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other advisory ids for the same vulnerability, both directions, sorted, at most 20."
          }
        }
      },
      "GetVulnScorecardResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnScorecardResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnScorecardResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnScorecardResponseWithVulnId": {
        "type": "object",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id, normalised and alias-resolved."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix seconds."
          },
          "scorecards": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "$ref": "#/components/schemas/ScorecardEntry"
            }
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 64
          },
          "commitHealth": {
            "description": "The first stored fix-commit health record for the vulnerability's references, as stored (JSON); null when there is none."
          },
          "prRepoHealth": {
            "description": "The first stored pull-request repository health record, as stored (JSON); null when there is none."
          },
          "sourceFixCorrelation": {
            "type": [
              "object",
              "null"
            ],
            "description": "Whether a fix commit (from the first five commit references) lies in a scorecarded repository. Null when there is no commit reference.",
            "additionalProperties": false,
            "required": [
              "hasFixCommit",
              "fixCommitSha",
              "fixCommitInScorecardRepo",
              "scorecardScoreAtFixTime"
            ],
            "properties": {
              "hasFixCommit": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "fixCommitSha": {
                "type": "string",
                "maxLength": 64
              },
              "fixCommitInScorecardRepo": {
                "type": "boolean"
              },
              "scorecardScoreAtFixTime": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": -1,
                "maximum": 10
              }
            }
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, DISPUTED and the like); null when no source gives one."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other advisory ids for the same vulnerability, both directions, sorted, at most 20."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `GetVulnScorecardResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "GetVulnSightingsResponse": {
        "type": "object",
        "description": "The in-the-wild observation timeline for one vulnerability.",
        "required": [
          "identifier",
          "timestamp",
          "count",
          "firstObservation",
          "lastObservation",
          "daysSinceLastSeen",
          "events",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Events on the timeline."
          },
          "firstObservation": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35
          },
          "lastObservation": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35
          },
          "daysSinceLastSeen": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": -36500,
            "maximum": 36500
          },
          "events": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 100000,
            "items": {
              "$ref": "#/components/schemas/VulnSightingEvent"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Oldest first."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, ...); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The record title from the most authoritative source; null when none has one."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Aliases of the id, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnSightingsResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnSightingsResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnSightingsResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnSightingsResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `GetVulnSightingsResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Events on the timeline."
          },
          "firstObservation": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35
          },
          "lastObservation": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35
          },
          "daysSinceLastSeen": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": -36500,
            "maximum": 36500
          },
          "events": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 100000,
            "items": {
              "$ref": "#/components/schemas/VulnSightingEvent"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Oldest first."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, ...); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The record title from the most authoritative source; null when none has one."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Aliases of the id, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "GetVulnTimelineResponse": {
        "type": "object",
        "required": [
          "identifier",
          "timestamp",
          "state",
          "title",
          "aliases",
          "events",
          "sources",
          "meta",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id, normalised and alias-resolved."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix seconds."
          },
          "events": {
            "type": "array",
            "maxItems": 10000,
            "items": {
              "$ref": "#/components/schemas/VulnTimelineEvent"
            },
            "description": "Events in time order, de-duplicated. An empty array when no event passes the filters."
          },
          "sources": {
            "type": "object",
            "description": "What each source said, behind the events.",
            "required": [
              "cve",
              "kev",
              "epss",
              "cess",
              "vulncheck",
              "crowdsec",
              "scorecard",
              "advisories",
              "adp"
            ],
            "additionalProperties": false,
            "properties": {
              "cve": {
                "type": "object",
                "required": [
                  "datePublished",
                  "state"
                ],
                "additionalProperties": false,
                "properties": {
                  "datePublished": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "dateUpdated": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "dateReserved": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "state": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 32
                  }
                }
              },
              "kev": {
                "type": "object",
                "required": [
                  "cisa",
                  "eu"
                ],
                "additionalProperties": false,
                "properties": {
                  "cisa": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "dateAdded": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "dueDate": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "vendorProject": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "product": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "vulnerabilityName": {
                        "type": "string",
                        "maxLength": 1024
                      },
                      "requiredAction": {
                        "type": "string",
                        "maxLength": 8192
                      },
                      "knownRansomwareCampaignUse": {
                        "type": "string",
                        "maxLength": 32
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "maxLength": 8192
                      }
                    }
                  },
                  "eu": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "dateAdded": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "dueDate": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "vendorProject": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "product": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "source": {
                        "type": "string",
                        "maxLength": 64
                      }
                    }
                  }
                }
              },
              "epss": {
                "type": "object",
                "required": [
                  "history"
                ],
                "additionalProperties": false,
                "properties": {
                  "history": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "maxItems": 365,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "date": {
                          "type": "string",
                          "maxLength": 40
                        },
                        "score": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        },
                        "percentile": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        }
                      }
                    }
                  },
                  "current": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "date": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "score": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "percentile": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      }
                    }
                  }
                }
              },
              "cess": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "properties": {
                  "history": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "maxItems": 365,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "date": {
                          "type": "string",
                          "maxLength": 40
                        },
                        "score": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 100
                        },
                        "probabilityExploitUsage": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        },
                        "modelVersion": {
                          "type": "string",
                          "maxLength": 64
                        }
                      }
                    }
                  },
                  "current": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "date": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "score": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "probabilityExploitUsage": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      }
                    }
                  }
                }
              },
              "vulncheck": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "properties": {
                  "reportedExploitations": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "maxItems": 10000,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 4096
                        },
                        "dateAdded": {
                          "type": "integer",
                          "format": "int64",
                          "minimum": -62135596800000,
                          "maximum": 4102444800000,
                          "description": "Unix milliseconds. A row with no date reads -62135596800000 (Go's zero time)."
                        },
                        "kevId": {
                          "type": "string",
                          "maxLength": 128
                        }
                      }
                    }
                  },
                  "xdb": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "maxItems": 10000,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "xdbId": {
                          "type": "string",
                          "maxLength": 128
                        },
                        "xdbUrl": {
                          "type": "string",
                          "maxLength": 4096
                        },
                        "exploitType": {
                          "type": "string",
                          "maxLength": 64
                        },
                        "dateAdded": {
                          "type": "integer",
                          "format": "int64",
                          "minimum": -62135596800000,
                          "maximum": 4102444800000,
                          "description": "Unix milliseconds. A row with no date reads -62135596800000 (Go's zero time)."
                        }
                      }
                    }
                  }
                }
              },
              "crowdsec": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "properties": {
                  "firstSeen": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "lastSeen": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "totalSightings": {
                    "type": "integer",
                    "format": "int32",
                    "minimum": 0,
                    "maximum": 2147483647
                  }
                }
              },
              "scorecard": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "properties": {
                  "score": {
                    "type": "number",
                    "minimum": -1,
                    "maximum": 10
                  },
                  "date": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "repo": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "commit": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 64
                  }
                }
              },
              "advisories": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 10000,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "url": {
                      "type": "string",
                      "maxLength": 4096
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 4096
                    },
                    "source": {
                      "type": "string",
                      "maxLength": 64
                    }
                  }
                }
              },
              "adp": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 64,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "adpId": {
                      "type": "string",
                      "maxLength": 128
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 1024
                    },
                    "source": {
                      "type": "string",
                      "maxLength": 64
                    }
                  }
                }
              }
            }
          },
          "meta": {
            "type": "object",
            "description": "Lifecycle figures derived from the events.",
            "required": [
              "currentAgeDays",
              "lifecycleStage",
              "publicationToKevDays",
              "publicationToFirstExploitDays",
              "publicationToFirstPatchDays",
              "reservationToPublicationDays",
              "totalEvents",
              "insights",
              "futureEpssDate",
              "futureEpssScore"
            ],
            "additionalProperties": false,
            "properties": {
              "currentAgeDays": {
                "type": "integer",
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "lifecycleStage": {
                "type": "string",
                "enum": [
                  "NEW",
                  "EMERGING",
                  "MATURE",
                  "LEGACY"
                ],
                "description": "NEW under 90 days since publication, EMERGING under a year, MATURE under two, LEGACY after."
              },
              "publicationToKevDays": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "publicationToFirstExploitDays": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "publicationToFirstPatchDays": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "reservationToPublicationDays": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "totalEvents": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 10000
              },
              "insights": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 32,
                "items": {
                  "type": "string",
                  "maxLength": 512
                }
              },
              "futureEpssDate": {
                "type": "string",
                "maxLength": 40,
                "description": "Thirty days from now, RFC 3339."
              },
              "futureEpssScore": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": 0,
                "maximum": 1
              }
            }
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, DISPUTED and the like); null when no source gives one."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other advisory ids for the same vulnerability, both directions, sorted, at most 20."
          }
        }
      },
      "GetVulnTimelineResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnTimelineResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnTimelineResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnTimelineResponseWithVulnId": {
        "type": "object",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id, normalised and alias-resolved."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix seconds."
          },
          "events": {
            "type": "array",
            "maxItems": 10000,
            "items": {
              "$ref": "#/components/schemas/VulnTimelineEvent"
            },
            "description": "Events in time order, de-duplicated. An empty array when no event passes the filters."
          },
          "sources": {
            "type": "object",
            "description": "What each source said, behind the events.",
            "required": [
              "cve",
              "kev",
              "epss",
              "cess",
              "vulncheck",
              "crowdsec",
              "scorecard",
              "advisories",
              "adp"
            ],
            "additionalProperties": false,
            "properties": {
              "cve": {
                "type": "object",
                "required": [
                  "datePublished",
                  "state"
                ],
                "additionalProperties": false,
                "properties": {
                  "datePublished": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "dateUpdated": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "dateReserved": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "state": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 32
                  }
                }
              },
              "kev": {
                "type": "object",
                "required": [
                  "cisa",
                  "eu"
                ],
                "additionalProperties": false,
                "properties": {
                  "cisa": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "dateAdded": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "dueDate": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "vendorProject": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "product": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "vulnerabilityName": {
                        "type": "string",
                        "maxLength": 1024
                      },
                      "requiredAction": {
                        "type": "string",
                        "maxLength": 8192
                      },
                      "knownRansomwareCampaignUse": {
                        "type": "string",
                        "maxLength": 32
                      },
                      "notes": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "maxLength": 8192
                      }
                    }
                  },
                  "eu": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "dateAdded": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "dueDate": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "vendorProject": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "product": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "source": {
                        "type": "string",
                        "maxLength": 64
                      }
                    }
                  }
                }
              },
              "epss": {
                "type": "object",
                "required": [
                  "history"
                ],
                "additionalProperties": false,
                "properties": {
                  "history": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "maxItems": 365,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "date": {
                          "type": "string",
                          "maxLength": 40
                        },
                        "score": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        },
                        "percentile": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        }
                      }
                    }
                  },
                  "current": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "date": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "score": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "percentile": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      }
                    }
                  }
                }
              },
              "cess": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "properties": {
                  "history": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "maxItems": 365,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "date": {
                          "type": "string",
                          "maxLength": 40
                        },
                        "score": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 100
                        },
                        "probabilityExploitUsage": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        },
                        "modelVersion": {
                          "type": "string",
                          "maxLength": 64
                        }
                      }
                    }
                  },
                  "current": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "date": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "score": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "probabilityExploitUsage": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      }
                    }
                  }
                }
              },
              "vulncheck": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "properties": {
                  "reportedExploitations": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "maxItems": 10000,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 4096
                        },
                        "dateAdded": {
                          "type": "integer",
                          "format": "int64",
                          "minimum": -62135596800000,
                          "maximum": 4102444800000,
                          "description": "Unix milliseconds. A row with no date reads -62135596800000 (Go's zero time)."
                        },
                        "kevId": {
                          "type": "string",
                          "maxLength": 128
                        }
                      }
                    }
                  },
                  "xdb": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "maxItems": 10000,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "xdbId": {
                          "type": "string",
                          "maxLength": 128
                        },
                        "xdbUrl": {
                          "type": "string",
                          "maxLength": 4096
                        },
                        "exploitType": {
                          "type": "string",
                          "maxLength": 64
                        },
                        "dateAdded": {
                          "type": "integer",
                          "format": "int64",
                          "minimum": -62135596800000,
                          "maximum": 4102444800000,
                          "description": "Unix milliseconds. A row with no date reads -62135596800000 (Go's zero time)."
                        }
                      }
                    }
                  }
                }
              },
              "crowdsec": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "properties": {
                  "firstSeen": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "lastSeen": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "totalSightings": {
                    "type": "integer",
                    "format": "int32",
                    "minimum": 0,
                    "maximum": 2147483647
                  }
                }
              },
              "scorecard": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "properties": {
                  "score": {
                    "type": "number",
                    "minimum": -1,
                    "maximum": 10
                  },
                  "date": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "repo": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "commit": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 64
                  }
                }
              },
              "advisories": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 10000,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "url": {
                      "type": "string",
                      "maxLength": 4096
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 4096
                    },
                    "source": {
                      "type": "string",
                      "maxLength": 64
                    }
                  }
                }
              },
              "adp": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 64,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "adpId": {
                      "type": "string",
                      "maxLength": 128
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "maxLength": 1024
                    },
                    "source": {
                      "type": "string",
                      "maxLength": 64
                    }
                  }
                }
              }
            }
          },
          "meta": {
            "type": "object",
            "description": "Lifecycle figures derived from the events.",
            "required": [
              "currentAgeDays",
              "lifecycleStage",
              "publicationToKevDays",
              "publicationToFirstExploitDays",
              "publicationToFirstPatchDays",
              "reservationToPublicationDays",
              "totalEvents",
              "insights",
              "futureEpssDate",
              "futureEpssScore"
            ],
            "additionalProperties": false,
            "properties": {
              "currentAgeDays": {
                "type": "integer",
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "lifecycleStage": {
                "type": "string",
                "enum": [
                  "NEW",
                  "EMERGING",
                  "MATURE",
                  "LEGACY"
                ],
                "description": "NEW under 90 days since publication, EMERGING under a year, MATURE under two, LEGACY after."
              },
              "publicationToKevDays": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "publicationToFirstExploitDays": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "publicationToFirstPatchDays": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "reservationToPublicationDays": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "minimum": -100000,
                "maximum": 100000
              },
              "totalEvents": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 10000
              },
              "insights": {
                "type": [
                  "array",
                  "null"
                ],
                "maxItems": 32,
                "items": {
                  "type": "string",
                  "maxLength": 512
                }
              },
              "futureEpssDate": {
                "type": "string",
                "maxLength": 40,
                "description": "Thirty days from now, RFC 3339."
              },
              "futureEpssScore": {
                "type": [
                  "number",
                  "null"
                ],
                "minimum": 0,
                "maximum": 1
              }
            }
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, DISPUTED and the like); null when no source gives one."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other advisory ids for the same vulnerability, both directions, sorted, at most 20."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `GetVulnTimelineResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "GetVulnWorkaroundsResponse": {
        "type": "object",
        "description": "Workarounds and configuration notes for one vulnerability.",
        "required": [
          "identifier",
          "timestamp",
          "state",
          "title",
          "aliases",
          "workarounds",
          "configurations",
          "descriptions"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "workarounds": {
            "type": "array",
            "description": "`workarounds` from each source's CNA and ADP containers.",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "configurations": {
            "type": "array",
            "description": "`configurations` from each source's CNA container, and NVD's evaluator comment.",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "descriptions": {
            "type": "array",
            "description": "Every source's description of the vulnerability, for context.",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          }
        }
      },
      "GetVulnWorkaroundsResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `GetVulnWorkaroundsResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/GetVulnWorkaroundsResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "GetVulnWorkaroundsResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `GetVulnWorkaroundsResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "workarounds": {
            "type": "array",
            "description": "`workarounds` from each source's CNA and ADP containers.",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "configurations": {
            "type": "array",
            "description": "`configurations` from each source's CNA container, and NVD's evaluator comment.",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "descriptions": {
            "type": "array",
            "description": "Every source's description of the vulnerability, for context.",
            "items": {
              "$ref": "#/components/schemas/RemediationTextEntry"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "GoogleArchiveAdvisory": {
        "type": "object",
        "description": "One Google advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "source",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "source": {
            "type": "string",
            "maxLength": 64,
            "description": "The record source: `Vulnesis` (GCVE), `gpz` (Project Zero), `google-cloud`, or `nist-nvd` / `github` / `osv` for cross-source CVEs."
          },
          "kind": {
            "type": "string",
            "enum": [
              "gcve",
              "google-cloud",
              "chrome",
              "android",
              "project-zero",
              "google-oss",
              "google-vendor"
            ],
            "description": "Which Google advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "GoogleProjectStat": {
        "type": "object",
        "description": "One Google open-source project and its CVE counts.",
        "additionalProperties": false,
        "required": [
          "slug",
          "displayName",
          "homepageURL",
          "isHardForked",
          "advisoryCount",
          "last30Days",
          "last90Days",
          "last365Days"
        ],
        "properties": {
          "slug": {
            "type": "string",
            "enum": [
              "chromium",
              "android",
              "chromeos",
              "golang",
              "kubernetes",
              "tensorflow",
              "angular",
              "bazel",
              "grpc",
              "protobuf",
              "gvisor",
              "flutter",
              "dart",
              "firebase",
              "skia",
              "tink",
              "v8",
              "material",
              "ortools",
              "polymer",
              "istio",
              "googlecloud-sdk"
            ]
          },
          "displayName": {
            "type": "string",
            "maxLength": 128
          },
          "homepageURL": {
            "type": "string",
            "maxLength": 2048
          },
          "isHardForked": {
            "type": "boolean",
            "description": "True for community-owned projects Google incubated (Kubernetes, Istio)."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Distinct CVEs matched to the project."
          },
          "last30Days": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Of those, published in the past 30 days."
          },
          "last90Days": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Of those, published in the past 90 days."
          },
          "last365Days": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Of those, published in the past 365 days."
          }
        }
      },
      "GoogleProjectZeroEntry": {
        "type": "object",
        "description": "One Project Zero in-the-wild entry.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "source",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The entry's id, normally a CVE id."
          },
          "source": {
            "type": "string",
            "enum": [
              "gpz"
            ]
          },
          "kind": {
            "type": "string",
            "enum": [
              "project-zero"
            ]
          },
          "title": {
            "type": "string",
            "maxLength": 2048,
            "description": "Omitted when none is recorded."
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "cveAliases": {
            "type": "array",
            "maxItems": 1,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "The id when it is a CVE id, else empty."
          },
          "isExploited": {
            "type": "boolean",
            "enum": [
              false
            ],
            "description": "Always false here: no KEV lookup is made on this route."
          },
          "advisoryUrl": {
            "type": "string",
            "maxLength": 2048
          },
          "products": {
            "type": "array",
            "maxItems": 0,
            "items": {
              "$ref": "#/components/schemas/VendorArchiveProduct"
            },
            "description": "Always empty."
          }
        }
      },
      "IdentifiersMonthResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "year",
          "month",
          "total",
          "limit",
          "offset",
          "hasMore",
          "identifiers"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800000,
            "description": "Unix milliseconds."
          },
          "year": {
            "type": "integer",
            "format": "int32",
            "minimum": 1999,
            "maximum": 2100
          },
          "month": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 12
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Distinct ids published in the month. Reads 0 when the count query fails."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean"
          },
          "identifiers": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Distinct ids, ascending."
          }
        }
      },
      "IdentifiersSearchResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "prefix",
          "total",
          "limit",
          "offset",
          "hasMore",
          "identifiers"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800000,
            "description": "Unix milliseconds."
          },
          "prefix": {
            "type": "string",
            "maxLength": 50
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Distinct ids with the prefix. Reads 0 when the count query fails."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean"
          },
          "identifiers": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Distinct ids, ascending."
          }
        }
      },
      "InputError": {
        "type": "object",
        "required": [
          "error",
          "field"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "field": {
            "type": "string"
          }
        }
      },
      "Inputs": {
        "type": "object",
        "description": "Every input kind. Kinds given together narrow the answer; a TEI uuid or a CEL expression widens within itself. The alias keys are accepted as the canonical ones; send one spelling of each.",
        "additionalProperties": false,
        "properties": {
          "vulnIds": {
            "description": "Advisory ids, as one string or a list; at most 100.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "vulnId": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "cveId": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "identifier": {
            "deprecated": true,
            "description": "Alias of `vulnIds`.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/VulnId"
              },
              {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "$ref": "#/components/schemas/VulnId"
                }
              }
            ]
          },
          "package": {
            "$ref": "#/components/schemas/PackageName"
          },
          "packageName": {
            "deprecated": true,
            "description": "Alias of `package`.",
            "$ref": "#/components/schemas/PackageName"
          },
          "ecosystem": {
            "$ref": "#/components/schemas/Ecosystem"
          },
          "version": {
            "$ref": "#/components/schemas/Version"
          },
          "packageVersion": {
            "deprecated": true,
            "description": "Alias of `version`.",
            "$ref": "#/components/schemas/Version"
          },
          "currentVersion": {
            "deprecated": true,
            "description": "Alias of `version`.",
            "$ref": "#/components/schemas/Version"
          },
          "vendor": {
            "$ref": "#/components/schemas/VendorName"
          },
          "product": {
            "$ref": "#/components/schemas/ProductName"
          },
          "cpe": {
            "$ref": "#/components/schemas/Cpe"
          },
          "purl": {
            "$ref": "#/components/schemas/Purl"
          },
          "swid": {
            "$ref": "#/components/schemas/Swid"
          },
          "tei": {
            "$ref": "#/components/schemas/Tei"
          },
          "cel": {
            "$ref": "#/components/schemas/Cel"
          }
        }
      },
      "IssueApiKeyResponse": {
        "type": "object",
        "required": [
          "success",
          "orgId",
          "apiKey"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "orgId": {
            "type": "string",
            "maxLength": 64,
            "pattern": "^[0-9A-Za-z-]{1,64}$",
            "description": "The access key from the credential scope: your organisation UUID."
          },
          "apiKey": {
            "type": "string",
            "pattern": "^[0-9a-f]{64}$",
            "minLength": 64,
            "maxLength": 64,
            "description": "Lowercase hex `HMAC-SHA256(key = secret, message = orgId)`. Send as `Authorization: ApiKey <orgId>:<apiKey>`."
          }
        }
      },
      "IssueTokenResponse": {
        "type": "object",
        "required": [
          "token",
          "iss",
          "sub",
          "exp"
        ],
        "additionalProperties": false,
        "properties": {
          "token": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4096,
            "description": "Session token (JWT) carrying `iss`, `sub`, `orgId`, `accessKey`, `iat` and `exp`. Signed ES256 by a KMS key where one is configured, otherwise HS512; treat it as opaque. Valid for 15 minutes."
          },
          "iss": {
            "type": "string",
            "enum": [
              "urn:vulnetix:vdb"
            ],
            "description": "Issuer."
          },
          "sub": {
            "type": "string",
            "pattern": "^urn:uuid:[0-9A-Za-z-]{1,64}$",
            "maxLength": 73,
            "description": "`urn:uuid:` followed by the access key from the credential scope (your organisation UUID)."
          },
          "exp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Expiry, Unix seconds: 15 minutes after issue."
          }
        }
      },
      "KevSearchItem": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "cveId"
        ],
        "properties": {
          "source": {
            "type": "string",
            "enum": [
              "CISA",
              "vulnetix",
              "enisa",
              "vulncheck"
            ]
          },
          "cveId": {
            "type": "string",
            "maxLength": 226
          },
          "vendorProject": {
            "type": "string",
            "maxLength": 512,
            "description": "Absent when empty."
          },
          "product": {
            "type": "string",
            "maxLength": 512,
            "description": "Absent when empty."
          },
          "vulnerabilityName": {
            "type": "string",
            "maxLength": 1024,
            "description": "Absent when empty."
          },
          "requiredAction": {
            "type": "string",
            "maxLength": 2048,
            "description": "Absent when empty."
          },
          "knownRansomwareCampaignUse": {
            "type": "string",
            "maxLength": 32,
            "description": "Absent when empty."
          },
          "dateAdded": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35,
            "description": "Absent on a VulnCheck row with no date."
          },
          "dueDate": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35,
            "description": "Present on CISA, Vulnesis and ENISA rows; absent on VulnCheck rows. A row with no deadline reads 1970-01-01T00:00:00Z."
          },
          "overdue": {
            "type": "boolean",
            "description": "Present on CISA, Vulnesis and ENISA rows; absent on VulnCheck rows. A row with no deadline reads true."
          },
          "daysUntilDue": {
            "type": "integer",
            "format": "int32",
            "minimum": -2147483648,
            "maximum": 2147483647,
            "description": "Present on CISA, Vulnesis and ENISA rows; absent on VulnCheck rows. Whole days to the due date, negative when past."
          }
        },
        "description": "One catalogue entry."
      },
      "ListAiAssistedExploitsResponse": {
        "type": "object",
        "required": [
          "generatedAt",
          "total",
          "succeeded",
          "failed",
          "leaderboard",
          "items"
        ],
        "additionalProperties": false,
        "properties": {
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Demonstrations listed."
          },
          "succeeded": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Demonstrations that produced a working exploit."
          },
          "failed": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Demonstrations that did not."
          },
          "leaderboard": {
            "type": "array",
            "description": "One entry per researcher organisation, in no fixed order.",
            "items": {
              "type": "object",
              "required": [
                "researcherOrg",
                "total",
                "succeeded",
                "successRate"
              ],
              "additionalProperties": false,
              "properties": {
                "researcherOrg": {
                  "type": "string"
                },
                "total": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0
                },
                "succeeded": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0
                },
                "successRate": {
                  "type": "number",
                  "format": "double",
                  "minimum": 0,
                  "maximum": 1,
                  "description": "succeeded / total."
                }
              }
            }
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiAssistedExploitItem"
            },
            "description": "Every demonstration, newest first."
          }
        }
      },
      "ListAiDiscoveriesResponse": {
        "type": "object",
        "required": [
          "generatedAt",
          "total",
          "count",
          "limit",
          "offset",
          "items",
          "aggregate",
          "markers"
        ],
        "additionalProperties": false,
        "properties": {
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Items in the whole filtered set, before pagination."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Items in this page."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 5000,
            "description": "The page size applied, after clamping; `0` means no cap."
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "The offset applied."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiDiscoveryItem"
            },
            "description": "This page of discoveries, newest first."
          },
          "aggregate": {
            "$ref": "#/components/schemas/AiDiscoveryAggregate"
          },
          "markers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiDiscoveryMarker"
            },
            "description": "Every notable or milestone-tagged discovery, oldest first. Not filtered. `[]` when the marker query fails."
          }
        }
      },
      "ListAiGeneratedMalwareResponse": {
        "type": "object",
        "required": [
          "generatedAt",
          "total",
          "byUseMode",
          "items"
        ],
        "additionalProperties": false,
        "properties": {
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Families listed."
          },
          "byUseMode": {
            "type": "array",
            "description": "Families per AI use mode, in no fixed order.",
            "items": {
              "type": "object",
              "required": [
                "aiUseMode",
                "count"
              ],
              "additionalProperties": false,
              "properties": {
                "aiUseMode": {
                  "type": "string"
                },
                "count": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0
                }
              }
            }
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiGeneratedMalwareItem"
            },
            "description": "Every family, newest publication first."
          }
        }
      },
      "ListAiInWildExploitationsResponse": {
        "type": "object",
        "required": [
          "generatedAt",
          "total",
          "items"
        ],
        "additionalProperties": false,
        "properties": {
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Rows listed."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AiInWildExploitationItem"
            },
            "description": "Every observation, newest advisory first."
          }
        }
      },
      "ListAlpineRegistriesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "registries"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "Server time the answer was built, Unix seconds."
          },
          "registries": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "$ref": "#/components/schemas/AlpineRegistryStat"
            }
          }
        }
      },
      "ListEcosystemsResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "ecosystems"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this response was assembled."
          },
          "ecosystems": {
            "type": [
              "array",
              "null"
            ],
            "description": "Ecosystems by distinct package count, descending; `null` when none are recorded.",
            "items": {
              "$ref": "#/components/schemas/EnumNameCount"
            }
          }
        }
      },
      "ListEolCategoriesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "categories"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds."
          },
          "categories": {
            "type": "array",
            "description": "Largest count first. Below Pro, a category with no endoflife.date products is left out (its products still count toward the top-level withheld).",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "name",
                "count"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "maxLength": 64
                },
                "count": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0,
                  "maximum": 2147483647,
                  "description": "Products in the category that the caller's plan can see."
                },
                "withheld": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0,
                  "maximum": 2147483647,
                  "description": "Below Pro only: vendor-lifecycle products in this category left out of count (0 when none). Absent for Pro and above."
                }
              }
            }
          },
          "withheld": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Below Pro only: vendor-lifecycle products the plan left out of the counts, across all categories, including categories left out entirely because they hold no endoflife.date products (0 when none). Absent for Pro and above."
          },
          "_entitlements": {
            "$ref": "#/components/schemas/EolEntitlements"
          }
        }
      },
      "ListEolProductsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "total",
          "limit",
          "offset",
          "hasMore",
          "products"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Products matching the filters that the caller may see."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9223372036854775807,
            "description": "The offset applied, echoed as parsed (any non-negative integer in log mode)."
          },
          "hasMore": {
            "type": "boolean"
          },
          "products": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/EolProductListItem"
            }
          },
          "withheld": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Below Pro only: vendor-lifecycle products matching the filters that the plan left out (0 when none). Absent for Pro and above."
          },
          "_entitlements": {
            "$ref": "#/components/schemas/EolEntitlements"
          },
          "_links": {
            "type": "array",
            "maxItems": 500,
            "description": "One `product` link per listed product; absent when the page is empty.",
            "items": {
              "$ref": "#/components/schemas/APILink"
            }
          }
        }
      },
      "ListExploitSourcesResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "exploitSources"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this response was assembled."
          },
          "exploitSources": {
            "type": "array",
            "description": "Reference sources by count, descending, then by name.",
            "items": {
              "$ref": "#/components/schemas/EnumNameCount"
            }
          }
        }
      },
      "ListExploitTypesResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "exploitTypes"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this response was assembled."
          },
          "exploitTypes": {
            "type": "array",
            "description": "Exploit-DB types by count, descending.",
            "items": {
              "$ref": "#/components/schemas/EnumNameCount"
            }
          }
        }
      },
      "ListFixDistributionsResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "distributions"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this response was assembled."
          },
          "distributions": {
            "type": "array",
            "minItems": 7,
            "maxItems": 7,
            "items": {
              "$ref": "#/components/schemas/FixDistribution"
            }
          }
        }
      },
      "ListFreeDemoPackagesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "free_demo_packages"
        ],
        "properties": {
          "free_demo_packages": {
            "type": "array",
            "description": "The allowlisted packages, each `<ecosystem>:<name>`; empty when the list cannot be loaded.",
            "items": {
              "type": "string",
              "maxLength": 576
            }
          }
        }
      },
      "ListGoogleProjectZeroRecentResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "total",
          "advisories"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "Server time the answer was built, Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 12,
            "description": "Entries in `advisories`."
          },
          "advisories": {
            "type": "array",
            "maxItems": 12,
            "items": {
              "$ref": "#/components/schemas/GoogleProjectZeroEntry"
            }
          }
        }
      },
      "ListGoogleProjectsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "projects"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "Server time the answer was built, Unix seconds."
          },
          "projects": {
            "type": "array",
            "maxItems": 22,
            "description": "Always the 22 projects, in a fixed order.",
            "items": {
              "$ref": "#/components/schemas/GoogleProjectStat"
            }
          }
        }
      },
      "ListMalwareCampaignsResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "campaigns",
          "aggregates"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the answer was built, Unix seconds. A cached answer repeats the time it was first built."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the snapshot was computed, Unix seconds. Present when the snapshot carries it."
          },
          "campaigns": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MalwareCampaign"
            },
            "description": "Headline campaigns first, then by actor count. `[]` when the snapshot lacks it."
          },
          "aggregates": {
            "$ref": "#/components/schemas/MalwareCampaignAggregates"
          }
        }
      },
      "ListMetricTypesResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "metricTypes"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this response was assembled."
          },
          "metricTypes": {
            "type": "array",
            "description": "Metric types by record count, descending.",
            "items": {
              "$ref": "#/components/schemas/EnumNameCount"
            }
          }
        }
      },
      "ListMsrcPatchTuesdaysResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "generatedAt",
          "total",
          "patchTuesdays"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "When the snapshot was computed, Unix seconds; equal to `generatedAt`."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the snapshot was computed, Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Releases listed."
          },
          "patchTuesdays": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MsrcPatchTuesdaySummary"
            },
            "description": "Every release, most recent first."
          }
        }
      },
      "ListOrgPackagesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packages",
          "pagination"
        ],
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 256,
            "description": "The lowercased `q`; empty when none. Present only when the page has packages."
          },
          "ecosystem": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The lowercased `ecosystem`, null when none. Present only when the page has packages."
          },
          "packages": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/OrgPackageCatalogRow"
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/PackagePagePagination"
          }
        }
      },
      "ListPackageVersionsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packageName",
          "resolvedNames",
          "resolvedMode",
          "timestamp",
          "total",
          "limit",
          "offset",
          "hasMore",
          "versions",
          "_links"
        ],
        "description": "Known versions of a package.",
        "properties": {
          "packageName": {
            "type": "string",
            "maxLength": 1024,
            "description": "The path name, percent-decoded and lowercased."
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Canonical package names the path name resolved to: up to three exact matches (the name, and the name with `_` or `-` read as a space), otherwise up to ten fuzzy matches. Null when nothing matched (`resolvedMode` is `empty`)."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name was resolved: `exact` match, `fuzzy` (trigram) fallback, or `empty` when nothing matched."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix time in seconds when the answer was built."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Distinct versions known."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "Page size, as applied (at most 100 with `withVulnIntel=1`)."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9223372036854775807,
            "description": "Items skipped, as applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit` is less than `total`."
          },
          "versions": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/PackageVersionListing"
            }
          },
          "safeHarbour": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SafeHarbourSummary"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Present only with `withVulnIntel=1` and a non-empty page."
          },
          "_links": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Always three links, in this order: rel `versions` (`/v2/{name}/versions`), rel `product` (`/v2/product/{name}`) and rel `vulns` (`/v2/{name}/vulns`), where {name} is the lowercased path name, path-escaped."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListPackageVulnsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packageName",
          "resolvedNames",
          "resolvedMode",
          "timestamp",
          "totalCVEs",
          "total",
          "limit",
          "offset",
          "hasMore",
          "versions",
          "_links"
        ],
        "description": "Known versions of a package with the package's CVEs.",
        "properties": {
          "packageName": {
            "type": "string",
            "maxLength": 1024,
            "description": "The path name, percent-decoded and lowercased."
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Canonical package names the path name resolved to: up to three exact matches (the name, and the name with `_` or `-` read as a space), otherwise up to ten fuzzy matches. Null when nothing matched (`resolvedMode` is `empty`)."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name was resolved: `exact` match, `fuzzy` (trigram) fallback, or `empty` when nothing matched."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix time in seconds when the answer was built."
          },
          "totalCVEs": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Distinct CVEs with metadata recorded against the resolved names (0 when the count timed out)."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Distinct versions known."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "Page size, as applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9223372036854775807,
            "description": "Items skipped, as applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit` is less than `total`."
          },
          "versions": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/PackageVulnsVersion"
            }
          },
          "safeHarbour": {
            "$ref": "#/components/schemas/SafeHarbourSummary"
          },
          "_links": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Always three links, in this order: rel `versions` (`/v2/{name}/versions`), rel `product` (`/v2/product/{name}`) and rel `vulns` (`/v2/{name}/vulns`), where {name} is the lowercased path name, path-escaped."
          }
        }
      },
      "ListPackagesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packages",
          "pagination"
        ],
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 256,
            "description": "The trimmed `q`; empty for the recent list. Present only when the page has packages."
          },
          "ecosystem": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The lowercased `ecosystem`, null when none. Present only when the page has packages."
          },
          "packages": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/PackageCatalogRow"
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/PackagePagePagination"
          }
        }
      },
      "ListRawSourcesResponse": {
        "type": "object",
        "description": "The raw archive source catalogue.",
        "required": [
          "timestamp",
          "count",
          "sources"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 8
          },
          "sources": {
            "type": "array",
            "maxItems": 8,
            "items": {
              "type": "object",
              "required": [
                "slug",
                "perCVE",
                "contentType",
                "description",
                "totalRows",
                "archivedRows"
              ],
              "additionalProperties": false,
              "properties": {
                "slug": {
                  "type": "string",
                  "enum": [
                    "mitre-cve",
                    "ghsa",
                    "osv",
                    "nist-nvd",
                    "vulncheck-nvd",
                    "vulncheck-kev",
                    "cisa-kev",
                    "euvd"
                  ]
                },
                "perCVE": {
                  "type": "boolean",
                  "description": "Whether one advisory can be fetched with `GET /v2/raw/{source}/{cveId}`."
                },
                "contentType": {
                  "type": "string",
                  "enum": [
                    "application/json"
                  ]
                },
                "description": {
                  "type": "string",
                  "maxLength": 256
                },
                "totalRows": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 9223372036854775807
                },
                "archivedRows": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 9223372036854775807
                }
              }
            }
          }
        }
      },
      "ListSourcesResponse": {
        "type": "object",
        "required": [
          "timestamp",
          "sources",
          "degraded",
          "droppedSources"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when this response was assembled."
          },
          "sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VdbSourceMetadata"
            },
            "description": "Data sources, sorted by `id`."
          },
          "degraded": {
            "type": "boolean",
            "description": "True when some source tables could not be read and the list may be missing their sources."
          },
          "droppedSources": {
            "type": "array",
            "maxItems": 15,
            "description": "Names of the tables that could not be read; empty when `degraded` is false. Fewer than half of the 31 source tables (at most 15), never the main advisory table: past that the answer is `500`.",
            "items": {
              "type": "string",
              "maxLength": 64
            }
          }
        }
      },
      "ListVulnAffectedPackagesResponse": {
        "type": "object",
        "required": [
          "cveId",
          "packages"
        ],
        "additionalProperties": false,
        "properties": {
          "cveId": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given, trimmed (not normalised or alias-resolved)."
          },
          "packages": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "required": [
                "packageName",
                "ecosystem"
              ],
              "additionalProperties": false,
              "properties": {
                "packageName": {
                  "type": "string",
                  "maxLength": 512
                },
                "ecosystem": {
                  "type": "string",
                  "maxLength": 64
                }
              }
            },
            "description": "Distinct packages, language ecosystems first (npm, pypi, go, cargo, maven, nuget, rubygems, composer), then by name; at most 50."
          }
        }
      },
      "ListVulnAffectedPackagesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnAffectedPackagesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnAffectedPackagesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnAffectedPackagesResponseWithVulnId": {
        "type": "object",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "cveId": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given, trimmed (not normalised or alias-resolved)."
          },
          "packages": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "required": [
                "packageName",
                "ecosystem"
              ],
              "additionalProperties": false,
              "properties": {
                "packageName": {
                  "type": "string",
                  "maxLength": 512
                },
                "ecosystem": {
                  "type": "string",
                  "maxLength": 64
                }
              }
            },
            "description": "Distinct packages, language ecosystems first (npm, pypi, go, cargo, maven, nuget, rubygems, composer), then by name; at most 50."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `ListVulnAffectedPackagesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "ListVulnAffectedResponse": {
        "type": "object",
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "affected",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id, normalised and alias-resolved."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix seconds."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Equal to `total` (entries after filtering), not the page size."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean"
          },
          "affected": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/VulnAffectedEntry"
            }
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, DISPUTED and the like); null when no source gives one."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other advisory ids for the same vulnerability, both directions, sorted, at most 20."
          }
        }
      },
      "ListVulnAffectedResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnAffectedResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnAffectedResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnAffectedResponseWithVulnId": {
        "type": "object",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id, normalised and alias-resolved."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix seconds."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Equal to `total` (entries after filtering), not the page size."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean"
          },
          "affected": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/VulnAffectedEntry"
            }
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The record state from the most authoritative source (PUBLISHED, REJECTED, DISPUTED and the like); null when no source gives one."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 4096,
            "description": "The title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other advisory ids for the same vulnerability, both directions, sorted, at most 20."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `ListVulnAffectedResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "ListVulnAttackTechniquesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "attackTechniques",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The advisory id after normalisation and alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (for example `PUBLISHED`, `REJECTED`); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Alias ids, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for this vulnerability."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Techniques in the answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Always equal to `count`: the route is not paged."
          },
          "attackTechniques": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "$ref": "#/components/schemas/AttackTechnique"
            },
            "description": "Sorted by technique id. The handler sets no bound; 1000 is the documented ceiling."
          }
        }
      },
      "ListVulnAttackTechniquesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnAttackTechniquesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnAttackTechniquesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnAttackTechniquesResponseWithVulnId": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vulnId"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The advisory id after normalisation and alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (for example `PUBLISHED`, `REJECTED`); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Alias ids, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for this vulnerability."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Techniques in the answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Always equal to `count`: the route is not paged."
          },
          "attackTechniques": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "$ref": "#/components/schemas/AttackTechnique"
            },
            "description": "Sorted by technique id. The handler sets no bound; 1000 is the documented ceiling."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `ListVulnAttackTechniquesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "ListVulnCountermeasuresResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "byKind",
          "resolved",
          "countermeasures"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Defences on this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Every matching defence. Visible to every tier: that a defence exists is the warning, the rule is the product."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "byKind": {
            "type": "object",
            "description": "Count per kind (keys are this lane's kinds), over every matching defence, not the page. Visible to every tier.",
            "maxProperties": 16,
            "additionalProperties": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 2147483647
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "countermeasures": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/CountermeasureRecord"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature countermeasures). Ordered by kind, then newest first."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "identifier": {
            "type": "string",
            "maxLength": 65536,
            "description": "A single advisory id comes back in its canonical spelling, resolved to its primary CVE when it is an alias that is not an advisory of its own; any other identifier is echoed as given."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The advisory's state from its most authoritative source. Only when the identifier is a single advisory id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "The advisory's title. Only when the identifier is a single advisory id."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Aliases of the advisory, both ways. Only when the identifier is a single advisory id."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for the advisory. Only when the identifier is a single advisory id."
          }
        }
      },
      "ListVulnDistributionPatchesResponse": {
        "type": "object",
        "description": "Linux distribution patches for one vulnerability, one page.",
        "required": [
          "identifier",
          "timestamp",
          "state",
          "title",
          "aliases",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "patches"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "count": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "total": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "limit": {
            "$ref": "#/components/schemas/RemediationPageLimit"
          },
          "offset": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "hasMore": {
            "type": "boolean"
          },
          "patches": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/RemediationDistributionPatch"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          }
        }
      },
      "ListVulnDistributionPatchesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnDistributionPatchesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnDistributionPatchesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnDistributionPatchesResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `ListVulnDistributionPatchesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "count": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "total": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "limit": {
            "$ref": "#/components/schemas/RemediationPageLimit"
          },
          "offset": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "hasMore": {
            "type": "boolean"
          },
          "patches": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/RemediationDistributionPatch"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "ListVulnExploitsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "exploits",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Same as `count`: the list is not paged."
          },
          "exploits": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ExploitArchiveEntry"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Every archived exploit file for the vulnerability, newest first."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other views of this vulnerability: every vulnerability rel except this route's own (`exploits-archive`), including rel `exploits` (`/v2/exploits/{id}`)."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (PUBLISHED, REJECTED, ...). Null when no record is held."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one. Null when none."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other ids for this vulnerability, both directions, at most 20."
          }
        },
        "description": "The archived exploit files held for one vulnerability."
      },
      "ListVulnExploitsResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnExploitsResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnExploitsResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnExploitsResponseWithVulnId": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vulnId"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Same as `count`: the list is not paged."
          },
          "exploits": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ExploitArchiveEntry"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Every archived exploit file for the vulnerability, newest first."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other views of this vulnerability: every vulnerability rel except this route's own (`exploits-archive`), including rel `exploits` (`/v2/exploits/{id}`)."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (PUBLISHED, REJECTED, ...). Null when no record is held."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one. Null when none."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other ids for this vulnerability, both directions, at most 20."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `ListVulnExploitsResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "ListVulnNucleiTemplatesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "templates",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "templates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NucleiTemplateRef"
            },
            "description": "Every template path on file, sorted."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other views of this vulnerability."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (PUBLISHED, REJECTED, ...). Null when no record is held."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one. Null when none."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other ids for this vulnerability, both directions, at most 20."
          }
        },
        "description": "The Nuclei templates that target one vulnerability."
      },
      "ListVulnNucleiTemplatesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnNucleiTemplatesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnNucleiTemplatesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnNucleiTemplatesResponseWithVulnId": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vulnId"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "templates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NucleiTemplateRef"
            },
            "description": "Every template path on file, sorted."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other views of this vulnerability."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (PUBLISHED, REJECTED, ...). Null when no record is held."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one. Null when none."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Other ids for this vulnerability, both directions, at most 20."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `ListVulnNucleiTemplatesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "ListVulnRegistryFixesResponse": {
        "type": "object",
        "description": "Fixed releases in package registries for one vulnerability, one page.",
        "required": [
          "identifier",
          "timestamp",
          "state",
          "title",
          "aliases",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "fixes"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "count": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "total": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "limit": {
            "$ref": "#/components/schemas/RemediationPageLimit"
          },
          "offset": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "hasMore": {
            "type": "boolean"
          },
          "fixes": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/RemediationRegistryFix"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnRegistryFixesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnRegistryFixesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnRegistryFixesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnRegistryFixesResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `ListVulnRegistryFixesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "count": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "total": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "limit": {
            "$ref": "#/components/schemas/RemediationPageLimit"
          },
          "offset": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "hasMore": {
            "type": "boolean"
          },
          "fixes": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/RemediationRegistryFix"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "ListVulnSnortRulesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "rules",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The advisory id after normalisation and alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (for example `PUBLISHED`, `REJECTED`); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Alias ids, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for this vulnerability."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 500,
            "description": "Rows in this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rows matching in all."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "The page size applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The offset applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "rules": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/SnortRule"
            },
            "description": "Ordered by `signatureSeverity` as text, descending (alphabetical, so `Minor` before `Major` before `Informational` before `Critical`), rules without one last, then by `snortId`."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnSnortRulesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnSnortRulesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnSnortRulesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnSnortRulesResponseWithVulnId": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vulnId"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The advisory id after normalisation and alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (for example `PUBLISHED`, `REJECTED`); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Alias ids, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for this vulnerability."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 500,
            "description": "Rows in this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rows matching in all."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "The page size applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The offset applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "rules": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/SnortRule"
            },
            "description": "Ordered by `signatureSeverity` as text, descending (alphabetical, so `Minor` before `Major` before `Informational` before `Critical`), rules without one last, then by `snortId`."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `ListVulnSnortRulesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "ListVulnSourceFixesResponse": {
        "type": "object",
        "description": "Upstream source references for one vulnerability, one page.",
        "required": [
          "identifier",
          "timestamp",
          "state",
          "title",
          "aliases",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "fixes"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "count": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "total": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "limit": {
            "$ref": "#/components/schemas/RemediationPageLimit"
          },
          "offset": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "hasMore": {
            "type": "boolean"
          },
          "fixes": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/RemediationSourceFix"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          }
        }
      },
      "ListVulnSourceFixesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnSourceFixesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnSourceFixesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnSourceFixesResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `ListVulnSourceFixesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "$ref": "#/components/schemas/RemediationIdentifierField"
          },
          "timestamp": {
            "$ref": "#/components/schemas/RemediationTimestampField"
          },
          "state": {
            "$ref": "#/components/schemas/RemediationStateField"
          },
          "title": {
            "$ref": "#/components/schemas/RemediationTitleField"
          },
          "aliases": {
            "$ref": "#/components/schemas/RemediationAliases"
          },
          "count": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "total": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "limit": {
            "$ref": "#/components/schemas/RemediationPageLimit"
          },
          "offset": {
            "$ref": "#/components/schemas/RemediationPageCounter"
          },
          "hasMore": {
            "type": "boolean"
          },
          "fixes": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/RemediationSourceFix"
            }
          },
          "_links": {
            "$ref": "#/components/schemas/RemediationLinks"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "ListVulnThreatActorsResponse": {
        "type": "object",
        "description": "Malware-author intelligence for one advisory.",
        "required": [
          "success",
          "identifier",
          "isMalicious",
          "threatActors",
          "iocs",
          "impersonationTrap",
          "counts"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id as given, upper-cased."
          },
          "isMalicious": {
            "type": "boolean"
          },
          "threatActors": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10000,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when there are none. One row per attribution edge.",
            "items": {
              "type": "object",
              "required": [
                "platform",
                "identifier",
                "actorType",
                "attributionForm",
                "attributionBasis",
                "confidence",
                "cveId",
                "cveSource"
              ],
              "additionalProperties": false,
              "properties": {
                "platform": {
                  "type": "string",
                  "maxLength": 64
                },
                "identifier": {
                  "type": "string",
                  "maxLength": 512
                },
                "actorType": {
                  "type": "string",
                  "maxLength": 64
                },
                "displayName": {
                  "type": "string",
                  "maxLength": 512
                },
                "email": {
                  "type": "string",
                  "maxLength": 512
                },
                "profileUrl": {
                  "type": "string",
                  "maxLength": 2048
                },
                "company": {
                  "type": "string",
                  "maxLength": 512
                },
                "location": {
                  "type": "string",
                  "maxLength": 512
                },
                "attributionForm": {
                  "type": "string",
                  "maxLength": 64
                },
                "attributionBasis": {
                  "type": "string",
                  "maxLength": 512
                },
                "confidence": {
                  "type": "string",
                  "maxLength": 32
                },
                "cveId": {
                  "type": "string",
                  "maxLength": 226
                },
                "cveSource": {
                  "type": "string",
                  "maxLength": 64
                },
                "keys": {
                  "type": "array",
                  "maxItems": 1000,
                  "items": {
                    "type": "object",
                    "required": [
                      "keyType",
                      "fingerprint"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "keyType": {
                        "type": "string",
                        "maxLength": 64
                      },
                      "fingerprint": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "emails": {
                        "type": "string",
                        "maxLength": 2048
                      }
                    }
                  }
                }
              }
            }
          },
          "iocs": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 100000,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when there are none.",
            "items": {
              "type": "object",
              "required": [
                "iocType",
                "value",
                "truncated",
                "cveId"
              ],
              "additionalProperties": false,
              "properties": {
                "iocType": {
                  "type": "string",
                  "maxLength": 64
                },
                "value": {
                  "type": "string",
                  "maxLength": 8192
                },
                "truncated": {
                  "type": "boolean"
                },
                "cveId": {
                  "type": "string",
                  "maxLength": 226
                }
              }
            }
          },
          "impersonationTrap": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10000,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when there are none. The repositories the package claims to be.",
            "items": {
              "type": "object",
              "required": [
                "cveId",
                "cveSource"
              ],
              "additionalProperties": false,
              "properties": {
                "cveId": {
                  "type": "string",
                  "maxLength": 226
                },
                "cveSource": {
                  "type": "string",
                  "maxLength": 64
                },
                "claimedRepoOwner": {
                  "type": "string",
                  "maxLength": 512
                },
                "claimedRepoUrl": {
                  "type": "string",
                  "maxLength": 2048
                },
                "claimedRepoSource": {
                  "type": "string",
                  "maxLength": 256
                }
              }
            }
          },
          "counts": {
            "type": "object",
            "required": [
              "threatActors",
              "iocs",
              "keys"
            ],
            "additionalProperties": false,
            "properties": {
              "threatActors": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "iocs": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "keys": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              }
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnThreatActorsResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnThreatActorsResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnThreatActorsResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnThreatActorsResponseWithVulnId": {
        "type": "object",
        "description": "One result of a fan-out: `ListVulnThreatActorsResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id as given, upper-cased."
          },
          "isMalicious": {
            "type": "boolean"
          },
          "threatActors": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10000,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when there are none. One row per attribution edge.",
            "items": {
              "type": "object",
              "required": [
                "platform",
                "identifier",
                "actorType",
                "attributionForm",
                "attributionBasis",
                "confidence",
                "cveId",
                "cveSource"
              ],
              "additionalProperties": false,
              "properties": {
                "platform": {
                  "type": "string",
                  "maxLength": 64
                },
                "identifier": {
                  "type": "string",
                  "maxLength": 512
                },
                "actorType": {
                  "type": "string",
                  "maxLength": 64
                },
                "displayName": {
                  "type": "string",
                  "maxLength": 512
                },
                "email": {
                  "type": "string",
                  "maxLength": 512
                },
                "profileUrl": {
                  "type": "string",
                  "maxLength": 2048
                },
                "company": {
                  "type": "string",
                  "maxLength": 512
                },
                "location": {
                  "type": "string",
                  "maxLength": 512
                },
                "attributionForm": {
                  "type": "string",
                  "maxLength": 64
                },
                "attributionBasis": {
                  "type": "string",
                  "maxLength": 512
                },
                "confidence": {
                  "type": "string",
                  "maxLength": 32
                },
                "cveId": {
                  "type": "string",
                  "maxLength": 226
                },
                "cveSource": {
                  "type": "string",
                  "maxLength": 64
                },
                "keys": {
                  "type": "array",
                  "maxItems": 1000,
                  "items": {
                    "type": "object",
                    "required": [
                      "keyType",
                      "fingerprint"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "keyType": {
                        "type": "string",
                        "maxLength": 64
                      },
                      "fingerprint": {
                        "type": "string",
                        "maxLength": 512
                      },
                      "emails": {
                        "type": "string",
                        "maxLength": 2048
                      }
                    }
                  }
                }
              }
            }
          },
          "iocs": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 100000,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when there are none.",
            "items": {
              "type": "object",
              "required": [
                "iocType",
                "value",
                "truncated",
                "cveId"
              ],
              "additionalProperties": false,
              "properties": {
                "iocType": {
                  "type": "string",
                  "maxLength": 64
                },
                "value": {
                  "type": "string",
                  "maxLength": 8192
                },
                "truncated": {
                  "type": "boolean"
                },
                "cveId": {
                  "type": "string",
                  "maxLength": 226
                }
              }
            }
          },
          "impersonationTrap": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10000,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when there are none. The repositories the package claims to be.",
            "items": {
              "type": "object",
              "required": [
                "cveId",
                "cveSource"
              ],
              "additionalProperties": false,
              "properties": {
                "cveId": {
                  "type": "string",
                  "maxLength": 226
                },
                "cveSource": {
                  "type": "string",
                  "maxLength": 64
                },
                "claimedRepoOwner": {
                  "type": "string",
                  "maxLength": 512
                },
                "claimedRepoUrl": {
                  "type": "string",
                  "maxLength": 2048
                },
                "claimedRepoSource": {
                  "type": "string",
                  "maxLength": 256
                }
              }
            }
          },
          "counts": {
            "type": "object",
            "required": [
              "threatActors",
              "iocs",
              "keys"
            ],
            "additionalProperties": false,
            "properties": {
              "threatActors": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "iocs": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              },
              "keys": {
                "type": "integer",
                "format": "int32",
                "minimum": 0,
                "maximum": 2147483647
              }
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "ListVulnVexStatementsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "statements",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The advisory id after normalisation and alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (for example `PUBLISHED`, `REJECTED`); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Alias ids, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for this vulnerability."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Statements in the answer."
          },
          "statements": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/VexStatement"
            },
            "description": "Newest first, at most 200. Null (with `count` 0) when the statement query failed."
          }
        }
      },
      "ListVulnVexStatementsResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnVexStatementsResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnVexStatementsResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnVexStatementsResponseWithVulnId": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vulnId"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The advisory id after normalisation and alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (for example `PUBLISHED`, `REJECTED`); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Alias ids, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for this vulnerability."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Statements in the answer."
          },
          "statements": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/VexStatement"
            },
            "description": "Newest first, at most 200. Null (with `count` 0) when the statement query failed."
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `ListVulnVexStatementsResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "ListVulnVirtualPatchesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "byKind",
          "resolved",
          "virtual-patches"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Defences on this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Every matching defence. Visible to every tier: that a defence exists is the warning, the rule is the product."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "byKind": {
            "type": "object",
            "description": "Count per kind (keys are this lane's kinds), over every matching defence, not the page. Visible to every tier.",
            "maxProperties": 16,
            "additionalProperties": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 2147483647
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "virtual-patches": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/VirtualPatchRecord"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature virtual-patches). Ordered by kind, then newest first."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "identifier": {
            "type": "string",
            "maxLength": 65536,
            "description": "A single advisory id comes back in its canonical spelling, resolved to its primary CVE when it is an alias that is not an advisory of its own; any other identifier is echoed as given."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The advisory's state from its most authoritative source. Only when the identifier is a single advisory id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "The advisory's title. Only when the identifier is a single advisory id."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Aliases of the advisory, both ways. Only when the identifier is a single advisory id."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for the advisory. Only when the identifier is a single advisory id."
          }
        }
      },
      "ListVulnYaraRulesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "identifier",
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "rules",
          "state",
          "title",
          "aliases",
          "_links"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The advisory id after normalisation and alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (for example `PUBLISHED`, `REJECTED`); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Alias ids, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for this vulnerability."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 500,
            "description": "Rows in this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rows matching in all."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "The page size applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The offset applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "rules": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/YaraRule"
            },
            "description": "Newest first, then by `ruleName`."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnYaraRulesResponseFanout": {
        "type": "object",
        "description": "The answer when the identifier is a purl, CPE, TEI or SWID tag: this operation run once per resolved vulnerability (at most 50, known-exploited first), each answer under `results`. See `ListVulnYaraRulesResponse` for one answer.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000,
            "description": "Vulnerabilities the identifier resolved to that this operation applies to."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/ListVulnYaraRulesResponseWithVulnId"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "description": "Resolved ids whose family this operation does not take.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "ListVulnYaraRulesResponseWithVulnId": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vulnId"
        ],
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 226,
            "description": "The advisory id after normalisation and alias resolution."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "Record state from the most authoritative source (for example `PUBLISHED`, `REJECTED`); null when no source has the id."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "Title from the most authoritative source that has one; null when none does."
          },
          "aliases": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Alias ids, both directions, at most 20."
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes for this vulnerability."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 500,
            "description": "Rows in this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rows matching in all."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "The page size applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The offset applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "rules": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/YaraRule"
            },
            "description": "Newest first, then by `ruleName`."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          }
        },
        "description": "One result of a fan-out: `ListVulnYaraRulesResponse` for one vulnerability, with `vulnId`. A run that did not answer 200 carries `status` and `error` instead of the body."
      },
      "MaintenanceError": {
        "type": "object",
        "required": [
          "success",
          "error",
          "message",
          "retry_after_seconds"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "enum": [
              "maintenance_mode"
            ]
          },
          "message": {
            "type": "string",
            "maxLength": 2048
          },
          "retry_after_seconds": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          }
        }
      },
      "MalwareCampaign": {
        "type": "object",
        "required": [
          "key",
          "name",
          "ecosystem",
          "startDate",
          "headline",
          "description",
          "actorCount",
          "actorsShown",
          "iocCount",
          "cveCount",
          "packageCount",
          "actors",
          "iocs"
        ],
        "additionalProperties": false,
        "properties": {
          "key": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "ecosystem": {
            "type": "string"
          },
          "startDate": {
            "type": "string",
            "description": "Campaign start, `YYYY-MM-DD`."
          },
          "headline": {
            "type": "boolean",
            "description": "Featured campaign."
          },
          "description": {
            "type": "string"
          },
          "actorCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "All actors attributed to the campaign."
          },
          "actorsShown": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Actors listed in `actors`."
          },
          "iocCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "cveCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "packageCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "actors": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/MalwareCampaignActor"
            }
          },
          "iocs": {
            "type": "array",
            "description": "IOC samples per type, largest first.",
            "items": {
              "type": "object",
              "required": [
                "iocType",
                "total",
                "truncated",
                "values"
              ],
              "additionalProperties": false,
              "properties": {
                "iocType": {
                  "type": "string"
                },
                "total": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "truncated": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "description": "Values of this type not listed."
                },
                "values": {
                  "type": "array",
                  "maxItems": 50,
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      },
      "MalwareCampaignActor": {
        "type": "object",
        "required": [
          "platform",
          "identifier",
          "actorType",
          "threatCount",
          "edgeCount",
          "firstSeen",
          "lastSeen"
        ],
        "additionalProperties": false,
        "properties": {
          "platform": {
            "type": "string"
          },
          "identifier": {
            "type": "string"
          },
          "actorType": {
            "type": "string"
          },
          "displayName": {
            "type": "string",
            "description": "Absent when empty."
          },
          "email": {
            "type": "string",
            "description": "Absent when empty."
          },
          "keyEmails": {
            "type": "string",
            "description": "Emails recovered from the actor's keys, comma-separated. Absent when empty."
          },
          "profileUrl": {
            "type": "string",
            "description": "Absent when empty."
          },
          "company": {
            "type": "string",
            "description": "Absent when empty."
          },
          "location": {
            "type": "string",
            "description": "Absent when empty."
          },
          "threatCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "edgeCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Malware advisories linked to the actor."
          },
          "firstSeen": {
            "type": "integer",
            "format": "int64",
            "description": "Unix milliseconds; 0 when unknown."
          },
          "lastSeen": {
            "type": "integer",
            "format": "int64",
            "description": "Unix milliseconds; 0 when unknown."
          }
        }
      },
      "MalwareCampaignAggregates": {
        "type": "object",
        "description": "Totals across the campaigns and the whole threat-intelligence corpus. `{}` when the snapshot lacks it; otherwise every key is present.",
        "additionalProperties": false,
        "properties": {
          "actorsByEcosystem": {
            "type": "object",
            "maxProperties": 64,
            "additionalProperties": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          "iocsByType": {
            "type": "object",
            "maxProperties": 256,
            "additionalProperties": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          "timeline": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "date",
                "campaign",
                "actors",
                "iocs"
              ],
              "additionalProperties": false,
              "properties": {
                "date": {
                  "type": "string"
                },
                "campaign": {
                  "type": "string"
                },
                "actors": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                },
                "iocs": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0
                }
              }
            }
          },
          "totalActors": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "totalIocs": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "totalCampaigns": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "globalActors": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Every threat actor in the corpus."
          },
          "globalIocs": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "globalMalwareCves": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Malware advisories with a linked actor."
          },
          "globalMalwareRecords": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Every malicious-package record."
          },
          "globalEmails": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "actorsByPlatform": {
            "type": "object",
            "maxProperties": 64,
            "additionalProperties": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          "topActors": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/MalwareCampaignActor"
            },
            "description": "Actors with the highest threat count."
          }
        }
      },
      "MalwareCheckClean": {
        "type": "object",
        "description": "No malware source flags the package.",
        "required": [
          "success",
          "ecosystem",
          "package",
          "isMalicious",
          "counts"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "ecosystem": {
            "type": "string",
            "description": "The ecosystem from the path, lower-cased."
          },
          "package": {
            "type": "string",
            "maxLength": 512,
            "description": "The package name from the path, decoded."
          },
          "isMalicious": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "counts": {
            "$ref": "#/components/schemas/MalwareCheckCounts"
          }
        }
      },
      "MalwareCheckCounts": {
        "type": "object",
        "description": "Sizes of the malware evidence. Visible to every plan, including the counts of Pro-gated lists.",
        "required": [
          "advisories",
          "threatActors",
          "iocs",
          "keys"
        ],
        "additionalProperties": false,
        "properties": {
          "advisories": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "threatActors": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "iocs": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "keys": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "SSH and GPG keys across all attributed actors."
          }
        }
      },
      "MalwareCheckMalicious": {
        "type": "object",
        "description": "The package is flagged as malicious by at least one source.",
        "required": [
          "success",
          "ecosystem",
          "package",
          "isMalicious",
          "advisories",
          "threatActors",
          "iocs",
          "impersonationTrap",
          "counts"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "ecosystem": {
            "type": "string",
            "description": "The ecosystem from the path, lower-cased."
          },
          "package": {
            "type": "string",
            "maxLength": 512,
            "description": "The package name from the path, decoded."
          },
          "isMalicious": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "advisories": {
            "type": "array",
            "description": "Malware advisories naming this package, ordered by id.",
            "items": {
              "type": "object",
              "required": [
                "cveId",
                "source",
                "title"
              ],
              "additionalProperties": false,
              "properties": {
                "cveId": {
                  "type": "string",
                  "description": "Advisory id (MAL-, GHSA-, OSM- and others)."
                },
                "source": {
                  "type": "string",
                  "description": "Source of the advisory record."
                },
                "title": {
                  "type": "string",
                  "description": "Advisory title; empty when the record has none."
                },
                "aliases": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Alias ids. `[]` when none."
                }
              }
            }
          },
          "threatActors": {
            "type": [
              "array",
              "null"
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). The attributed malware authors, one entry per actor and advisory; also null when nothing is attributed.",
            "items": {
              "$ref": "#/components/schemas/MalwareThreatActor"
            }
          },
          "iocs": {
            "type": [
              "array",
              "null"
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Indicators of compromise parsed from OpenSourceMalware payloads, ordered by type then value; also null when there are none.",
            "items": {
              "type": "object",
              "required": [
                "iocType",
                "value",
                "truncated",
                "cveId"
              ],
              "additionalProperties": false,
              "properties": {
                "iocType": {
                  "type": "string",
                  "description": "Indicator type (for example `domains`, `ips`, `urls`)."
                },
                "value": {
                  "type": "string"
                },
                "truncated": {
                  "type": "boolean",
                  "description": "True when the stored value was cut short."
                },
                "cveId": {
                  "type": "string",
                  "description": "Advisory the indicator came from."
                }
              }
            }
          },
          "impersonationTrap": {
            "type": [
              "array",
              "null"
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). The legitimate repository the package falsely claims to be; also null when there is none.",
            "items": {
              "type": "object",
              "required": [
                "cveId",
                "cveSource"
              ],
              "additionalProperties": false,
              "properties": {
                "cveId": {
                  "type": "string"
                },
                "cveSource": {
                  "type": "string"
                },
                "claimedRepoOwner": {
                  "type": "string",
                  "description": "Owner of the claimed repository. Absent when empty."
                },
                "claimedRepoUrl": {
                  "type": "string",
                  "description": "URL of the claimed repository. Absent when empty."
                },
                "claimedRepoSource": {
                  "type": "string",
                  "description": "Where the claim was found. Absent when empty."
                }
              }
            }
          },
          "counts": {
            "$ref": "#/components/schemas/MalwareCheckCounts"
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "MalwareExposureStats": {
        "type": "object",
        "required": [
          "checked",
          "removed",
          "erased",
          "measurable",
          "medianDays",
          "sameDay",
          "days1to7",
          "weeks1to4",
          "months1to3",
          "months3to12",
          "overYear"
        ],
        "additionalProperties": false,
        "properties": {
          "checked": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Packages checked against the registry."
          },
          "removed": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Gone from the registry."
          },
          "erased": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Only a post-takedown publish record remains."
          },
          "measurable": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Published at or before the advisory, so the window can be measured."
          },
          "medianDays": {
            "type": "number",
            "format": "double",
            "minimum": 0
          },
          "sameDay": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "days1to7": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "weeks1to4": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "months1to3": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "months3to12": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "overYear": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "MalwareThreatActor": {
        "type": "object",
        "description": "An account attributed as the author of a malware advisory.",
        "required": [
          "platform",
          "identifier",
          "actorType",
          "attributionForm",
          "attributionBasis",
          "confidence",
          "cveId",
          "cveSource"
        ],
        "additionalProperties": false,
        "properties": {
          "platform": {
            "type": "string",
            "description": "Where the account lives (for example `npm`, `github`)."
          },
          "identifier": {
            "type": "string",
            "description": "Account name on that platform."
          },
          "actorType": {
            "type": "string"
          },
          "displayName": {
            "type": "string",
            "description": "Absent when empty."
          },
          "email": {
            "type": "string",
            "description": "Absent when empty."
          },
          "profileUrl": {
            "type": "string",
            "description": "Absent when empty."
          },
          "company": {
            "type": "string",
            "description": "Absent when empty."
          },
          "location": {
            "type": "string",
            "description": "Absent when empty."
          },
          "attributionForm": {
            "type": "string"
          },
          "attributionBasis": {
            "type": "string"
          },
          "confidence": {
            "type": "string"
          },
          "cveId": {
            "type": "string",
            "description": "Advisory the attribution belongs to."
          },
          "cveSource": {
            "type": "string"
          },
          "keys": {
            "type": "array",
            "description": "The actor's SSH and GPG public keys. Absent when none.",
            "items": {
              "type": "object",
              "required": [
                "keyType",
                "fingerprint"
              ],
              "additionalProperties": false,
              "properties": {
                "keyType": {
                  "type": "string"
                },
                "fingerprint": {
                  "type": "string"
                },
                "emails": {
                  "type": "string",
                  "description": "Emails on the key. Absent when empty."
                }
              }
            }
          }
        }
      },
      "MsrcAdvisory": {
        "type": "object",
        "description": "One MSRC advisory (one CVE), with archive links, ranking signals and affected products grouped by product family.",
        "required": [
          "cveId",
          "trackingId",
          "advisoryUrl",
          "isExploited",
          "currentReleaseDate",
          "initialReleaseDate",
          "productFamilies"
        ],
        "additionalProperties": false,
        "properties": {
          "cveId": {
            "type": "string",
            "description": "CVE id the advisory addresses."
          },
          "trackingId": {
            "type": "string",
            "description": "MSRC tracking id; also the file name of the CSAF and VEX documents in the archive."
          },
          "advisoryUrl": {
            "type": "string",
            "description": "MSRC advisory page."
          },
          "sourceVexUrl": {
            "type": "string",
            "description": "MSRC's own VEX document URL. Absent when MSRC published none."
          },
          "severity": {
            "type": "string",
            "description": "MSRC severity rating (for example `Critical`, `Important`). Absent when none."
          },
          "exploitabilityIndex": {
            "type": "string",
            "description": "MSRC exploitability assessment. Absent when none."
          },
          "isExploited": {
            "type": "boolean",
            "description": "MSRC flags the vulnerability as exploited."
          },
          "currentReleaseDate": {
            "type": "integer",
            "format": "int64",
            "description": "Release of the current revision, Unix milliseconds."
          },
          "initialReleaseDate": {
            "type": "integer",
            "format": "int64",
            "description": "First release, Unix milliseconds."
          },
          "revisionVersion": {
            "type": "string",
            "description": "Current revision. Absent when none."
          },
          "csafSha256": {
            "type": "string",
            "description": "SHA-256 of the source CSAF document. Absent when none."
          },
          "csafUrl": {
            "type": "string",
            "format": "uri",
            "description": "The CSAF document in the public MSRC archive. Present on a published release; absent on the preparation release."
          },
          "vexUrl": {
            "type": "string",
            "format": "uri",
            "description": "The VEX document in the public MSRC archive. Present on a published release when MSRC published a VEX document."
          },
          "risk": {
            "$ref": "#/components/schemas/MsrcArchiveRisk"
          },
          "productFamilies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MsrcProductFamily"
            },
            "description": "Affected products by product family. Products with no family are grouped under `Other`. `[]` when none are recorded."
          }
        }
      },
      "MsrcAffectedProduct": {
        "type": "object",
        "description": "An affected product within a product family.",
        "required": [
          "productName",
          "status",
          "csafProductId",
          "versions"
        ],
        "additionalProperties": false,
        "properties": {
          "productName": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "CSAF product status (for example `known_affected`, `fixed`)."
          },
          "csafProductId": {
            "type": "string",
            "description": "CSAF product id."
          },
          "versions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MsrcAffectedVersion"
            },
            "description": "Affected or fixed versions. `[]` when none are recorded."
          }
        }
      },
      "MsrcAffectedVersion": {
        "type": "object",
        "description": "An affected or fixed version with its KB and download links. Every key is left out when it has no value; at least one of `versionString`, `fixedBuild` and `kbArticleId` is present.",
        "minProperties": 1,
        "additionalProperties": false,
        "properties": {
          "versionString": {
            "type": "string"
          },
          "fixedBuild": {
            "type": "string",
            "description": "Build that fixes the vulnerability."
          },
          "kbArticleId": {
            "type": "string",
            "description": "KB article number."
          },
          "kbArticleUrl": {
            "type": "string"
          },
          "downloadUrl": {
            "type": "string"
          },
          "remediationCategory": {
            "type": "string",
            "description": "CSAF remediation category (for example `vendor_fix`)."
          },
          "remediationDetails": {
            "type": "string"
          }
        }
      },
      "MsrcArchiveRisk": {
        "type": "object",
        "description": "Ranking signals for the advisory, taken over its CVE. A signal that is unknown, false or zero is left out.",
        "required": [
          "cves"
        ],
        "additionalProperties": false,
        "properties": {
          "cves": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "CVE ids the signals were taken over."
          },
          "vendorCvss": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "CVSS base score published by Microsoft."
          },
          "cvss": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "Highest CVSS base score from any source."
          },
          "cvssSource": {
            "type": "string",
            "description": "Source of `cvss`."
          },
          "epss": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1
          },
          "epssPercentile": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1
          },
          "cess": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "description": "Vulnesis CESS score."
          },
          "kevCisa": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Listed in CISA KEV."
          },
          "kevEnisa": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Listed in the ENISA EUVD exploited list."
          },
          "kevVulnetix": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Listed in the Vulnesis KEV."
          },
          "kevVulncheck": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Listed in VulnCheck KEV."
          },
          "exploitMaturity": {
            "type": "string",
            "enum": [
              "weaponized",
              "active",
              "poc"
            ],
            "description": "Strongest exploit maturity seen."
          },
          "exploitCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "description": "Linked exploits."
          },
          "malicious": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "Linked to a malicious package."
          }
        }
      },
      "MsrcArchiveUnavailable": {
        "type": "object",
        "description": "The MSRC archive snapshot has not been produced yet.",
        "required": [
          "error",
          "vendor"
        ],
        "additionalProperties": false,
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 256
          },
          "vendor": {
            "type": "string",
            "enum": [
              "msrc"
            ]
          }
        }
      },
      "MsrcPatchTuesdayNotFound": {
        "type": "object",
        "description": "No release on the requested date.",
        "required": [
          "error",
          "date"
        ],
        "additionalProperties": false,
        "properties": {
          "error": {
            "type": "string",
            "enum": [
              "Patch Tuesday not found"
            ]
          },
          "date": {
            "$ref": "#/components/schemas/Date"
          }
        }
      },
      "MsrcPatchTuesdayPreparation": {
        "type": "object",
        "description": "The advisories published since the last Patch Tuesday, as one upcoming release.",
        "required": [
          "id",
          "releaseDate",
          "dateSlug",
          "title",
          "cveCount",
          "exploitedCount",
          "kbCount",
          "patchedCount",
          "noPatchCount",
          "manifestUrl",
          "status",
          "isPreparation",
          "advisories"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "preparation"
            ]
          },
          "releaseDate": {
            "type": "integer",
            "format": "int64",
            "description": "The next second Tuesday at 18:00 UTC on or after the newest pending advisory, Unix milliseconds."
          },
          "dateSlug": {
            "type": "string",
            "format": "date",
            "description": "That date, `YYYY-MM-DD`."
          },
          "title": {
            "type": "string",
            "description": "`<Month YYYY> (Preparation)`."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "description": "Pending advisories."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "kbCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "patchedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "noPatchCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "manifestUrl": {
            "type": "null",
            "description": "Always null: no archive manifest exists yet."
          },
          "status": {
            "type": "string",
            "enum": [
              "Upcoming"
            ]
          },
          "isPreparation": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "advisories": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/MsrcAdvisory"
            },
            "description": "Pending advisories, newest first, then by CVE id. They carry no `csafUrl` or `vexUrl`."
          }
        }
      },
      "MsrcPatchTuesdaySummary": {
        "type": "object",
        "description": "One Patch Tuesday release, without its advisories.",
        "required": [
          "id",
          "releaseDate",
          "dateSlug",
          "title",
          "cveCount",
          "exploitedCount",
          "kbCount",
          "patchedCount",
          "noPatchCount",
          "manifestUrl",
          "status",
          "isPreparation"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "description": "Release id; empty when the snapshot lacks it."
          },
          "releaseDate": {
            "type": "integer",
            "format": "int64",
            "description": "Release time, Unix milliseconds; 0 when the snapshot lacks it."
          },
          "dateSlug": {
            "type": "string",
            "format": "date",
            "description": "Release date, `YYYY-MM-DD` UTC; the `{date}` for `GET /msrc/patch-tuesday/{date}`."
          },
          "title": {
            "type": "string"
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Advisories (one per CVE) in the release."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Advisories flagged as exploited."
          },
          "kbCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Distinct KB articles."
          },
          "patchedCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Advisories with a vendor fix, a fixed build or a KB article."
          },
          "noPatchCount": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Advisories with none of those."
          },
          "manifestUrl": {
            "type": "string",
            "format": "uri",
            "description": "The release's manifest in the public MSRC archive."
          },
          "status": {
            "type": "string",
            "enum": [
              "Published"
            ]
          },
          "isPreparation": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "MsrcProductFamily": {
        "type": "object",
        "description": "A product family within an MSRC advisory.",
        "required": [
          "familyName",
          "products"
        ],
        "additionalProperties": false,
        "properties": {
          "familyName": {
            "type": "string",
            "description": "Product family name, or `Other` for products with no family."
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MsrcAffectedProduct"
            },
            "description": "Affected products in the family."
          }
        }
      },
      "NucleiTemplateRef": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "path",
          "rawUrl",
          "url"
        ],
        "properties": {
          "path": {
            "type": "string",
            "maxLength": 1024,
            "description": "Path in projectdiscovery/nuclei-templates."
          },
          "rawUrl": {
            "type": "string",
            "maxLength": 2048
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          }
        }
      },
      "NvdDeepDiveBucket": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "totalRecords",
          "missingCvss",
          "missingCpe",
          "missingCisaAdp",
          "onlyAffectedVersions",
          "noAffectedVersions",
          "noPackageName",
          "noProgramTarget",
          "noRepo",
          "noPlatforms",
          "noRemediation",
          "noFixVersion",
          "cannotMatch"
        ],
        "description": "Counts of CVE records in one period that lack each kind of enrichment.",
        "properties": {
          "period": {
            "type": "string",
            "pattern": "^[0-9]{4}(-[0-9]{2})?$",
            "maxLength": 7,
            "description": "`YYYY` in `yearly`, `YYYY-MM` in `monthly`; absent in `allTime`."
          },
          "totalRecords": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "CVE records in the period."
          },
          "missingCvss": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no CVSS score."
          },
          "missingCpe": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no CPE."
          },
          "missingCisaAdp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no CISA ADP container."
          },
          "onlyAffectedVersions": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Whose only product data is affected versions."
          },
          "noAffectedVersions": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no affected versions."
          },
          "noPackageName": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no package name."
          },
          "noProgramTarget": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no program routines, modules or files."
          },
          "noRepo": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no source repository."
          },
          "noPlatforms": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no platforms."
          },
          "noRemediation": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no configurations, workarounds or solutions."
          },
          "noFixVersion": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "With no fixed version."
          },
          "cannotMatch": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "That cannot be matched to software by any identifier."
          }
        }
      },
      "OpenApiDocument": {
        "type": "object",
        "description": "An OpenAPI 3.1 document. See https://spec.openapis.org/oas/v3.1.0 for the full structure; the nested objects are listed here by kind only.",
        "required": [
          "openapi",
          "info",
          "paths"
        ],
        "additionalProperties": false,
        "properties": {
          "openapi": {
            "type": "string",
            "pattern": "^3\\.1\\.[0-9]{1,3}$",
            "maxLength": 16
          },
          "info": {
            "type": "object",
            "description": "Title, version, summary, description, contact, licence and terms of service.",
            "required": [
              "title",
              "version"
            ],
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 256
              },
              "version": {
                "type": "string",
                "maxLength": 64
              }
            }
          },
          "servers": {
            "type": "array",
            "maxItems": 16,
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "maxLength": 2048
                },
                "description": {
                  "type": "string",
                  "maxLength": 1024
                }
              }
            }
          },
          "security": {
            "type": "array",
            "maxItems": 16,
            "items": {
              "type": "object"
            }
          },
          "tags": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "object"
            }
          },
          "x-tagGroups": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "object"
            }
          },
          "externalDocs": {
            "type": "object"
          },
          "paths": {
            "type": "object",
            "description": "Path items keyed by path template.",
            "maxProperties": 2000,
            "additionalProperties": {
              "type": "object"
            }
          },
          "components": {
            "type": "object"
          }
        }
      },
      "OrgPackageCatalogRow": {
        "type": "object",
        "description": "One package from your organisation's inventory.",
        "additionalProperties": false,
        "required": [
          "name",
          "ecosystem",
          "latestVersion",
          "versionCount",
          "publishedAt",
          "isMalware",
          "vulnCount",
          "exploitCount",
          "inCisaKev",
          "scorecard"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 512,
            "description": "Lowercased package name."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "Lowercased recorded ecosystem, else the first the VDB knows; empty when unknown."
          },
          "latestVersion": {
            "type": "string",
            "maxLength": 256,
            "description": "Most recently published version your organisation recorded."
          },
          "versionCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Distinct versions your organisation recorded."
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Latest publish time (RFC 3339), null when unknown."
          },
          "isMalware": {
            "type": "boolean"
          },
          "vulnCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "exploitCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "inCisaKev": {
            "type": "boolean"
          },
          "scorecard": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 10
          },
          "eol": {
            "description": "End-of-life status; absent when the package maps to no product (below Pro, to no endoflife.date product).",
            "allOf": [
              {
                "$ref": "#/components/schemas/EolStatus"
              }
            ]
          }
        }
      },
      "OtherSightingSource": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "title",
          "type"
        ],
        "properties": {
          "source": {
            "type": "string",
            "maxLength": 64
          },
          "title": {
            "type": "string",
            "maxLength": 1024
          },
          "type": {
            "type": "string",
            "enum": [
              "sighting"
            ]
          },
          "datePublished": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35,
            "description": "Absent when unknown."
          }
        }
      },
      "PackageCatalogRow": {
        "type": "object",
        "description": "One package in the catalog.",
        "additionalProperties": false,
        "required": [
          "name",
          "ecosystem",
          "latestVersion",
          "versionCount",
          "publishedAt",
          "inOrg",
          "isMalware",
          "vulnCount",
          "exploitCount",
          "inCisaKev",
          "scorecard"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 512,
            "description": "Lowercased package name."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "Lowercased ecosystem; empty when unknown."
          },
          "latestVersion": {
            "type": "string",
            "maxLength": 256,
            "description": "Most recently published version; empty when unknown."
          },
          "versionCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Latest publish time (RFC 3339), null when unknown."
          },
          "inOrg": {
            "type": "boolean",
            "description": "Whether the package appears in your organisation's scanned dependencies; always false without a provisioned organisation."
          },
          "isMalware": {
            "type": "boolean",
            "description": "Whether the package is flagged as malicious."
          },
          "vulnCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "exploitCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "inCisaKev": {
            "type": "boolean"
          },
          "scorecard": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "OpenSSF Scorecard overall score, null when none."
          },
          "eol": {
            "description": "End-of-life status; absent when the package maps to no product (below Pro, to no endoflife.date product).",
            "allOf": [
              {
                "$ref": "#/components/schemas/EolStatus"
              }
            ]
          }
        }
      },
      "PackageDistroScope": {
        "type": "object",
        "description": "The distribution release the answer was limited to. Present only when the request carried `distro`.",
        "additionalProperties": false,
        "required": [
          "distro",
          "arch",
          "release",
          "releaseScoped"
        ],
        "properties": {
          "distro": {
            "type": "string",
            "maxLength": 64,
            "description": "The `distro` qualifier, lowercased."
          },
          "arch": {
            "type": "string",
            "maxLength": 32,
            "description": "The architecture, lowercased without a `linux/` prefix; `amd64` by default."
          },
          "release": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128,
            "description": "The indexed release the qualifier resolved to; null when the release is not indexed (and no versions came back)."
          },
          "releaseScoped": {
            "type": "boolean",
            "description": "Whether advisories, as well as versions, were limited to the release. Always false today: advisories are attributed at the distribution-family level."
          }
        }
      },
      "PackageIssuesResponse": {
        "type": "object",
        "additionalProperties": false,
        "description": "Placeholder answer of the package issues route.",
        "required": [
          "success",
          "status",
          "message",
          "_timestamp",
          "package"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "under_construction"
            ],
            "description": "Placeholder status marker."
          },
          "message": {
            "type": "string",
            "enum": [
              "This endpoint is under active development and will be available soon."
            ]
          },
          "_timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix time in seconds when the answer was built."
          },
          "package": {
            "type": "string",
            "maxLength": 1024,
            "description": "The path package, percent-decoded, case kept."
          }
        }
      },
      "PackageName": {
        "type": "string",
        "description": "A package name as its ecosystem writes it, including an npm scope (`@scope/name`) or a Maven `group:artifact`.",
        "minLength": 1,
        "maxLength": 512,
        "pattern": "^@?[A-Za-z0-9][A-Za-z0-9._~:@/+-]{0,510}$",
        "examples": [
          "lodash",
          "@angular/core",
          "org.apache.logging.log4j:log4j-core"
        ]
      },
      "PackagePagePagination": {
        "type": "object",
        "description": "Page-number pagination.",
        "additionalProperties": false,
        "required": [
          "page",
          "perPage",
          "totalRows",
          "totalPages"
        ],
        "properties": {
          "page": {
            "type": "integer",
            "format": "int32",
            "minimum": 1
          },
          "perPage": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 100
          },
          "totalRows": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          }
        }
      },
      "PackageResult": {
        "type": "object",
        "description": "One package matched by a search.",
        "additionalProperties": false,
        "required": [
          "packageName",
          "matchSources",
          "ecosystems",
          "versionCount",
          "versions",
          "safeHarbour",
          "vulnCount",
          "isMalware",
          "vulnerabilities",
          "exploitationSignals",
          "scorecardScore",
          "hasProvenance",
          "vendor",
          "product",
          "repositoryUrl",
          "eolStatus",
          "generatedCpe",
          "cloudLocators",
          "_links"
        ],
        "properties": {
          "packageName": {
            "type": "string",
            "maxLength": 512,
            "description": "Lowercased package name."
          },
          "matchSources": {
            "type": "array",
            "maxItems": 9,
            "items": {
              "type": "string",
              "enum": [
                "dependency",
                "package_version",
                "cve_affected",
                "github_repository",
                "eol_product",
                "kev",
                "cyclonedx_info",
                "msrc_affected",
                "depsdev"
              ]
            },
            "description": "The indexes the name matched in."
          },
          "ecosystems": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Ecosystems the package is recorded in."
          },
          "versionCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Distinct recorded versions."
          },
          "versions": {
            "type": "array",
            "maxItems": 10,
            "items": {
              "$ref": "#/components/schemas/SearchVersion"
            },
            "description": "The 10 most recently published versions."
          },
          "safeHarbour": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Computed over the versions listed; carries `picks` when the ecosystem is known and never `recommendation`.",
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/SafeHarbourSummary"
              }
            ]
          },
          "vulnCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "CVEs affecting the package."
          },
          "isMalware": {
            "type": "boolean",
            "description": "Whether the package is flagged as malicious (a malicious-package advisory or a malware-feed source)."
          },
          "vulnerabilities": {
            "type": "array",
            "description": "Every CVE record affecting the package, one per CVE and source, with its highest-scoring metric.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "cveId",
                "source",
                "severity",
                "score",
                "metricType",
                "vectorString",
                "purl"
              ],
              "properties": {
                "cveId": {
                  "type": "string",
                  "maxLength": 64
                },
                "source": {
                  "type": "string",
                  "maxLength": 128
                },
                "severity": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 32
                },
                "score": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "double",
                  "minimum": 0,
                  "maximum": 10
                },
                "metricType": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 64
                },
                "vectorString": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 512
                },
                "purl": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 1024,
                  "description": "Package URL built from the affected record, null when it names no package."
                }
              }
            }
          },
          "exploitationSignals": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment).",
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/ExploitationSignals"
              }
            ]
          },
          "scorecardScore": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "OpenSSF Scorecard overall score, null when none."
          },
          "hasProvenance": {
            "type": "boolean",
            "description": "Whether build provenance is recorded."
          },
          "vendor": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Vendor from CVE or KEV data."
          },
          "product": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Product from CVE or KEV data."
          },
          "repositoryUrl": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Source repository URL."
          },
          "eolStatus": {
            "description": "End-of-life status, null when the package maps to no product. Below Pro only endoflife.date products are matched.",
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/EolStatus"
              }
            ]
          },
          "generatedCpe": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). A CPE 2.3 string from vendor and product, null when either is unknown."
          },
          "cloudLocators": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Cloud resource locator templates for the vendor and product, null when no mapping exists.",
            "allOf": [
              {
                "$ref": "#/components/schemas/CloudLocatorResult"
              }
            ]
          },
          "_links": {
            "type": "array",
            "minItems": 2,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Related routes: rel `versions` and `product` always, `vulns` when the package has CVEs, `eol-product` when it maps to an end-of-life product, and per CVE of the listed versions `vuln`, `timeline`, `remediation-plan`, `snort-rules`, `yara-rules` and (with exploits) `exploits`."
          }
        }
      },
      "PackageSafetyMatrixRow": {
        "type": "object",
        "description": "One version's safety aggregates.",
        "additionalProperties": false,
        "required": [
          "version",
          "publishedAt",
          "isSafeHarbour",
          "isMalware",
          "isEol",
          "eolFrom",
          "vulnCount",
          "maxSeverity",
          "maxCvss",
          "maxEpss",
          "exploitCount",
          "maxExploitGrade",
          "inKev",
          "safeHarbourScore",
          "isStable",
          "rank"
        ],
        "properties": {
          "version": {
            "type": "string",
            "maxLength": 256
          },
          "publishedAt": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "description": "Release time in Unix milliseconds, null when unknown."
          },
          "isSafeHarbour": {
            "type": "boolean",
            "description": "True when the version has no vulnerability, no exploit, is not malware and is not end of life."
          },
          "isMalware": {
            "type": "boolean"
          },
          "isEol": {
            "type": "boolean",
            "description": "Whether the version's release cycle (major.minor, then major) is end of life."
          },
          "eolFrom": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "When the release cycle reached end of life; null when it has not or the date is unknown."
          },
          "vulnCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "CVEs attributed to this version."
          },
          "maxSeverity": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "CRITICAL",
              "HIGH",
              "MEDIUM",
              "LOW",
              null
            ],
            "description": "Highest severity across the attributed CVEs, null when none."
          },
          "maxCvss": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 10
          },
          "maxEpss": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "minimum": 0,
            "maximum": 1
          },
          "exploitCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "maxExploitGrade": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "POC",
              "WEAPONIZED",
              "ACTIVE",
              "WIDESPREAD",
              null
            ],
            "description": "Highest exploit maturity across the attributed CVEs, null when none."
          },
          "inKev": {
            "type": "boolean",
            "description": "Whether any attributed CVE is in CISA KEV."
          },
          "safeHarbourScore": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1
          },
          "isStable": {
            "type": "boolean",
            "description": "False for a pre-release, snapshot, nightly or other build the version's scheme marks unstable."
          },
          "rank": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Position in the scheme's version order across this answer's rows; 0 is the lowest."
          }
        }
      },
      "PackageSearchResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "query",
          "ecosystem",
          "timestamp",
          "total",
          "limit",
          "offset",
          "hasMore",
          "upstreamSync",
          "degraded",
          "unavailableSources",
          "packages"
        ],
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 256,
            "description": "The search string, trimmed."
          },
          "ecosystem": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32,
            "description": "The ecosystem hint, lowercased; null when none was given."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Matching packages across all pages."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "hasMore": {
            "type": "boolean"
          },
          "capped": {
            "type": "boolean",
            "description": "True when an index hit its row cap, so results may be incomplete. Absent when matches were found but none of them had enrichment data."
          },
          "upstreamSync": {
            "type": "boolean",
            "description": "Whether the package was fetched from deps.dev during this request."
          },
          "degraded": {
            "type": "boolean",
            "description": "True when one or more indexes could not be queried. An empty degraded answer is inconclusive, not proof that no such package exists."
          },
          "unavailableSources": {
            "type": "array",
            "maxItems": 8,
            "description": "The indexes that could not be queried (`all` when no database connection was available). Empty on a complete search.",
            "items": {
              "type": "string",
              "enum": [
                "dependency",
                "package_version",
                "cve_affected",
                "github_repository",
                "eol_product",
                "kev",
                "cyclonedx_info",
                "msrc_affected",
                "all"
              ]
            }
          },
          "packages": {
            "type": "array",
            "maxItems": 2000,
            "items": {
              "$ref": "#/components/schemas/PackageResult"
            },
            "description": "One entry per package name and ecosystem: up to `limit` names, each of which can appear in several ecosystems."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "PackageVersionListing": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "version",
          "ecosystem",
          "sources"
        ],
        "description": "One known version of a package.",
        "properties": {
          "version": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "The ecosystem the product index stores this version under: the requested ecosystem when the version is stored under it, else the one ecosystem it is stored under. Empty when only CVE affected entries list the version or when it is stored under several ecosystems and none was requested."
          },
          "sources": {
            "type": "array",
            "minItems": 1,
            "maxItems": 32,
            "items": {
              "type": "string",
              "maxLength": 128
            },
            "description": "Sources that list the version: product-index source names, and `cve_affected` for CVE affected entries. Order is not stable."
          },
          "safeHarbour": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SafeHarbourVersion"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Present only with `withVulnIntel=1`."
          }
        }
      },
      "PackageVulnsVersion": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "version",
          "ecosystem",
          "sources",
          "cveIds"
        ],
        "description": "One known version of a package with the package's CVEs.",
        "properties": {
          "version": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1024
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "The ecosystem the product index stores this version under: the requested ecosystem when the version is stored under it, else the one ecosystem it is stored under. Empty when only CVE affected entries list the version or when it is stored under several ecosystems and none was requested."
          },
          "sources": {
            "type": "array",
            "minItems": 1,
            "maxItems": 32,
            "items": {
              "type": "string",
              "maxLength": 128
            },
            "description": "Sources that list the version: product-index source names, and `cve_affected` for CVE affected entries. Order is not stable."
          },
          "cveIds": {
            "type": "array",
            "maxItems": 2000,
            "items": {
              "type": "string",
              "maxLength": 128
            },
            "description": "Every CVE known for the package (at most 2000), attached to each version as a worst-case attribution; per-version ranges are not evaluated. Empty when the lookup failed or found none. Order is not stable."
          },
          "safeHarbour": {
            "$ref": "#/components/schemas/SafeHarbourVersion"
          }
        }
      },
      "PackagesRefreshEcosystem": {
        "type": "object",
        "description": "What happened for one ecosystem, in order of first appearance.",
        "additionalProperties": false,
        "required": [
          "ecosystem",
          "mode",
          "addedVersions"
        ],
        "properties": {
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "Your spelling of the ecosystem, lowercased."
          },
          "mode": {
            "type": "string",
            "enum": [
              "live",
              "database"
            ],
            "description": "`live`: the registry was read. `database`: no registry client, so stored versions only."
          },
          "addedVersions": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Versions newly recorded across the ecosystem's packages."
          },
          "error": {
            "type": "string",
            "maxLength": 2048,
            "description": "Present when some registry reads failed: how many of how many, and the first failure."
          }
        }
      },
      "PackagesRefreshQuotaError": {
        "type": "object",
        "description": "The organisation's daily refresh quota is spent.",
        "additionalProperties": false,
        "required": [
          "error",
          "limit",
          "used"
        ],
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 256
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "enum": [
              500
            ],
            "description": "Refresh calls allowed per rolling 24 hours."
          },
          "used": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Refresh calls made in the last 24 hours."
          }
        }
      },
      "PackagesRefreshRow": {
        "type": "object",
        "description": "One package's refresh outcome and recomputed picks.",
        "additionalProperties": false,
        "required": [
          "name",
          "ecosystem",
          "state",
          "picks",
          "cooldown",
          "addedVersions",
          "versionsTracked",
          "safeVersions"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 512,
            "description": "The canonical package name, lowercased."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "Your spelling of the ecosystem, lowercased."
          },
          "state": {
            "type": "string",
            "enum": [
              "ok",
              "no-safe-harbour",
              "none-tracked",
              "plan-locked"
            ]
          },
          "picks": {
            "description": "The recomputed picks; null on `plan-locked` and `none-tracked` rows.",
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/SafeHarbourPicks"
              }
            ]
          },
          "cooldown": {
            "type": "boolean",
            "description": "True when the package was refreshed in the last 60 seconds, so the registry was not read again."
          },
          "addedVersions": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Versions newly recorded."
          },
          "versionsTracked": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Versions considered (at most the newest 400)."
          },
          "safeVersions": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Clean versions among them."
          },
          "error": {
            "type": "string",
            "maxLength": 2048,
            "description": "Present when the registry read failed; the picks then come from stored versions."
          }
        }
      },
      "PackagesRefreshTooLargeError": {
        "type": "object",
        "description": "Too many packages, or a field longer than 512 characters.",
        "additionalProperties": false,
        "required": [
          "error",
          "field"
        ],
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 256
          },
          "field": {
            "type": "string",
            "maxLength": 64,
            "description": "`packages`, or the entry field at fault such as `packages[3].name`."
          },
          "max": {
            "type": "integer",
            "format": "int32",
            "enum": [
              50
            ],
            "description": "Present when there were too many packages."
          }
        }
      },
      "PlanLocked": {
        "type": "object",
        "description": "The answer to a caller whose plan does not include this operation, or this record. It is HTTP 200, never an error, so a client renders an upgrade prompt rather than a failure. `upgrade` is always true and `_entitlements.plan` is the caller's plan: every gated route sits behind authentication, so the lowest value is `community` (this API never reports `anonymous`). The add-on variant (`requiredPlan` empty, `addon` set) is described in the CLI document; the website backend's own planLocked body (`proOnly`, `anonymous`) is not this API's.",
        "required": [
          "planLocked",
          "feature",
          "requiredPlan",
          "upgrade",
          "_entitlements"
        ],
        "properties": {
          "planLocked": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "feature": {
            "type": "string",
            "maxLength": 64
          },
          "requiredPlan": {
            "type": "string",
            "enum": [
              "pro",
              "teams",
              "enterprise"
            ]
          },
          "upgrade": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "error": {
            "type": "string",
            "maxLength": 512
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          },
          "_pro_data": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "string",
              "maxLength": 256
            }
          }
        }
      },
      "ProDataPaths": {
        "type": "array",
        "description": "JSONPath of each field nulled because it needs Pro. Present only when something was nulled.",
        "maxItems": 64,
        "items": {
          "type": "string",
          "maxLength": 256
        }
      },
      "ProductName": {
        "type": "string",
        "description": "A product as CVE records and CPEs name it.",
        "minLength": 1,
        "maxLength": 512,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9 ._:@+#,&/-]{0,511}$",
        "examples": [
          "log4j"
        ]
      },
      "ProductResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "packageName",
          "resolvedNames",
          "resolvedMode",
          "timestamp",
          "total",
          "limit",
          "offset",
          "hasMore",
          "versions",
          "_links",
          "version"
        ],
        "description": "One version of a package or product from the product index (GET /product/{name}/{version}).",
        "properties": {
          "packageName": {
            "type": "string",
            "maxLength": 1024,
            "description": "The path name, percent-decoded and lowercased."
          },
          "resolvedNames": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10,
            "items": {
              "type": "string",
              "maxLength": 512
            },
            "description": "Canonical package names the path name resolved to: up to three exact matches (the name, and the name with `_` or `-` read as a space), otherwise up to ten fuzzy matches. Null when nothing matched (`resolvedMode` is `empty`)."
          },
          "resolvedMode": {
            "type": "string",
            "enum": [
              "exact",
              "fuzzy",
              "empty"
            ],
            "description": "How the name was resolved: `exact` match, `fuzzy` (trigram) fallback, or `empty` when nothing matched."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix time in seconds when the answer was built."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Distinct (version, ecosystem) pairs for this version."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500,
            "description": "Page size, as applied (index rows)."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9223372036854775807,
            "description": "Items skipped, as applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit` is less than `total`."
          },
          "versions": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/ProductVersionRecord"
            }
          },
          "safeHarbour": {
            "$ref": "#/components/schemas/SafeHarbourSummary"
          },
          "_links": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Always three links, in this order: rel `versions` (`/v2/{name}/versions`), rel `product` (`/v2/product/{name}`) and rel `vulns` (`/v2/{name}/vulns`), where {name} is the lowercased path name, path-escaped."
          },
          "version": {
            "type": "string",
            "maxLength": 1024,
            "description": "The path version, percent-decoded."
          }
        }
      },
      "ProductVersionRecord": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "version",
          "ecosystem",
          "sources"
        ],
        "description": "One (version, ecosystem) pair from the product index.",
        "properties": {
          "version": {
            "type": "string",
            "maxLength": 1024,
            "description": "The version, or `unknown` for index rows that carry none."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "The ecosystem label as the product index stores it (for example npm, pypi, maven, go, cargo, nuget, rubygems, generic or unknown). May be empty."
          },
          "sources": {
            "type": "array",
            "minItems": 1,
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/ProductVersionSource"
            },
            "description": "Index rows on this page that name the pair."
          },
          "safeHarbour": {
            "$ref": "#/components/schemas/SafeHarbourVersion"
          }
        }
      },
      "ProductVersionSource": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "sourceTable",
          "sourceId"
        ],
        "description": "One product-index row that names this version.",
        "properties": {
          "sourceTable": {
            "type": "string",
            "maxLength": 128,
            "description": "The source the row comes from."
          },
          "sourceId": {
            "type": "string",
            "maxLength": 1024,
            "description": "The row's id in that source."
          }
        }
      },
      "Purl": {
        "type": "string",
        "description": "A Package URL. Its type must be a known ecosystem; qualifiers and subpath are ignored for matching.",
        "minLength": 6,
        "maxLength": 512,
        "pattern": "^pkg:[A-Za-z][A-Za-z0-9.+-]{0,31}/[!-~]{1,480}$",
        "examples": [
          "pkg:npm/lodash@4.17.20"
        ]
      },
      "RateLimitError": {
        "type": "object",
        "required": [
          "success",
          "error",
          "details"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "maxLength": 256,
            "examples": [
              "Daily rate limit exceeded"
            ]
          },
          "details": {
            "type": "string",
            "maxLength": 512,
            "examples": [
              "Limit: 1000 requests per day. Resets in 5 hours."
            ]
          }
        }
      },
      "RawAdvisoryPayload": {
        "type": "object",
        "description": "The upstream advisory exactly as the source published it (a CVE JSON 5 record, a GHSA or OSV advisory, an EUVD record). Its keys are the source's.",
        "maxProperties": 1000,
        "properties": {
          "planLocked": {
            "description": "Never present in an upstream record; its presence marks the planLocked body."
          }
        }
      },
      "RedHatArchiveAdvisory": {
        "type": "object",
        "description": "One Red Hat Security Advisory. Entries are ordered by `datePublished`, newest first, then by `rhsaId`.",
        "additionalProperties": false,
        "required": [
          "rhsaId",
          "datePublished",
          "cveAliases",
          "isExploited",
          "errataUrl",
          "csafUrl",
          "risk",
          "products"
        ],
        "properties": {
          "rhsaId": {
            "type": "string",
            "maxLength": 64,
            "description": "The RHSA id, for example `RHSA-2024:1249`."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "type": "string",
            "maxLength": 32,
            "description": "Red Hat's severity rating as recorded. Omitted when none is recorded."
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Ids linked to the RHSA (other than RHSA ids), normally CVE ids; may be empty."
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "errataUrl": {
            "type": "string",
            "maxLength": 2048,
            "description": "The errata page: the recorded reference, else `https://access.redhat.com/errata/<rhsaId>`."
          },
          "csafUrl": {
            "type": "string",
            "maxLength": 2048,
            "description": "The CSAF document mirrored on vulnes.is."
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "type": "array",
            "maxItems": 5000,
            "items": {
              "$ref": "#/components/schemas/VendorArchiveProduct"
            },
            "description": "Affected products recorded by Red Hat; may be empty."
          }
        }
      },
      "RedHatArchiveIndex": {
        "type": "object",
        "description": "Every month of the Red Hat archive, newest first.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "total",
          "generatedAt",
          "archives"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "When the snapshot was built, Unix seconds (same as `generatedAt`; not the response time)."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1200,
            "description": "Months in `archives`."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "When the snapshot was built, Unix seconds."
          },
          "archives": {
            "type": "array",
            "maxItems": 1200,
            "items": {
              "$ref": "#/components/schemas/RedHatArchivePeriodSummary"
            }
          }
        }
      },
      "RedHatArchivePeriodSummary": {
        "type": "object",
        "description": "Counts for one month of the Red Hat archive, from the daily snapshot.",
        "additionalProperties": false,
        "required": [
          "month",
          "title",
          "rhsaCount",
          "cveCount",
          "exploitedCount",
          "latestDate"
        ],
        "properties": {
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 64,
            "description": "`<Month YYYY>`, for example `March 2024`."
          },
          "rhsaCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct RHSAs in the month."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's RHSAs cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "RHSAs with a CVE in CISA/ENISA KEV or VulnCheck KEV."
          },
          "latestDate": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000000,
            "description": "Publication time of the month's newest RHSA, Unix epoch milliseconds."
          }
        }
      },
      "RefreshPackagesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "timestamp",
          "total",
          "cooldownSeconds",
          "ecosystems",
          "packages"
        ],
        "properties": {
          "schemaVersion": {
            "type": "string",
            "enum": [
              "packages-refresh/v1"
            ]
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "description": "Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50
          },
          "cooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "enum": [
              60
            ],
            "description": "The per-package cooldown window."
          },
          "ecosystems": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/PackagesRefreshEcosystem"
            },
            "description": "One entry per ecosystem with at least one package your plan covers."
          },
          "packages": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/PackagesRefreshRow"
            },
            "description": "One row per distinct package, in request order."
          }
        }
      },
      "RemediationAffectedRange": {
        "type": "object",
        "description": "The first affected-version row that bounds the range.",
        "required": [
          "version",
          "status",
          "versionType",
          "lessThan",
          "lessThanOrEqual"
        ],
        "additionalProperties": false,
        "properties": {
          "version": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "`affected`, `unaffected` or `unknown`, as the record states."
          },
          "versionType": {
            "type": "string",
            "description": "The record's version scheme (semver, maven, git, custom...)."
          },
          "lessThan": {
            "$ref": "#/components/schemas/RemediationNullableText"
          },
          "lessThanOrEqual": {
            "$ref": "#/components/schemas/RemediationNullableText"
          }
        }
      },
      "RemediationAliases": {
        "type": "array",
        "description": "Other ids for this vulnerability, at most 20.",
        "maxItems": 20,
        "items": {
          "type": "string"
        }
      },
      "RemediationChannelActions": {
        "type": "object",
        "description": "Actions by channel. Today every channel answers an empty array (see the operation description).",
        "required": [
          "registry",
          "source",
          "distro",
          "vendor",
          "cloud"
        ],
        "additionalProperties": false,
        "properties": {
          "registry": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChannelAction"
            }
          },
          "source": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChannelAction"
            }
          },
          "distro": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChannelAction"
            }
          },
          "vendor": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChannelAction"
            }
          },
          "cloud": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChannelAction"
            }
          }
        }
      },
      "RemediationContainerRef": {
        "type": "object",
        "description": "The image parsed from `containerImage`.",
        "required": [
          "registry",
          "repository"
        ],
        "additionalProperties": false,
        "properties": {
          "registry": {
            "type": "string",
            "description": "`docker.io` when the reference names none."
          },
          "repository": {
            "type": "string",
            "description": "`library/<name>` for a bare Docker Hub name."
          },
          "tag": {
            "type": "string"
          },
          "digest": {
            "type": "string"
          },
          "baseOS": {
            "type": "string",
            "description": "Base OS inferred from the tag (alpine, debian, ubuntu)."
          }
        }
      },
      "RemediationDistributionPatch": {
        "type": "object",
        "description": "A Linux distribution's patch for the vulnerability.",
        "required": [
          "distro",
          "displayName",
          "advisoryId",
          "advisoryUrl",
          "purl"
        ],
        "additionalProperties": false,
        "properties": {
          "distro": {
            "$ref": "#/components/schemas/RemediationDistroKey"
          },
          "displayName": {
            "type": "string"
          },
          "advisoryId": {
            "type": "string",
            "description": "The advisory id (USN-, DSA-, RHSA-...); empty for a patch derived from an affected row's vendor."
          },
          "advisoryUrl": {
            "type": "string",
            "description": "The advisory reference, or the distribution's tracker page for the vulnerability."
          },
          "source": {
            "type": "string",
            "description": "The source that carried the reference or row. Absent when empty."
          },
          "referenceName": {
            "type": "string",
            "description": "The reference's title. Absent when empty."
          },
          "purl": {
            "type": "string"
          },
          "affectedPackages": {
            "type": "array",
            "description": "Affected rows of the record naming this distribution. Absent when none.",
            "items": {
              "$ref": "#/components/schemas/RemediationDistroAffectedPackage"
            }
          }
        }
      },
      "RemediationDistroAffectedPackage": {
        "type": "object",
        "description": "An affected row of the record that names this distribution.",
        "required": [
          "vendor",
          "product"
        ],
        "additionalProperties": false,
        "properties": {
          "vendor": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "cpes": {
            "type": "string",
            "description": "The row's CPEs, as stored (a JSON-encoded array). Absent when none."
          },
          "platforms": {
            "type": "string",
            "description": "The row's platforms, as stored. Absent when none."
          }
        }
      },
      "RemediationDistroKey": {
        "type": "string",
        "enum": [
          "ubuntu",
          "debian",
          "redhat",
          "almalinux",
          "rockylinux",
          "centos",
          "oracle",
          "suse",
          "alpine",
          "amazon",
          "fedora",
          "arch",
          "gentoo",
          "chainguard",
          "wolfi",
          "tuxcare",
          "echo",
          "mariner"
        ]
      },
      "RemediationExploitationMaturity": {
        "type": "object",
        "description": "Exploitation maturity from EPSS, CESS, KEV, exploits and sightings.",
        "required": [
          "score",
          "level",
          "confidence",
          "factors",
          "reasoning"
        ],
        "additionalProperties": false,
        "properties": {
          "score": {
            "type": "integer",
            "format": "int32"
          },
          "level": {
            "type": "string",
            "enum": [
              "NONE",
              "POC",
              "WEAPONIZED",
              "ACTIVE",
              "WIDESPREAD"
            ]
          },
          "confidence": {
            "type": "string",
            "enum": [
              "LOW",
              "MEDIUM",
              "HIGH",
              "VERY_HIGH"
            ],
            "description": "From how many independent signals contributed."
          },
          "factors": {
            "type": "object",
            "required": [
              "epss",
              "cess",
              "kevPresence",
              "exploitDbCount",
              "metasploitCount",
              "nucleiCount",
              "crowdSecSightings",
              "githubExploits",
              "vulnCheckXDB"
            ],
            "additionalProperties": false,
            "properties": {
              "epss": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "cess": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "kevPresence": {
                "type": "boolean"
              },
              "exploitDbCount": {
                "type": "integer",
                "format": "int32"
              },
              "metasploitCount": {
                "type": "integer",
                "format": "int32"
              },
              "nucleiCount": {
                "type": "integer",
                "format": "int32"
              },
              "crowdSecSightings": {
                "type": "integer",
                "format": "int32"
              },
              "githubExploits": {
                "type": "integer",
                "format": "int32"
              },
              "vulnCheckXDB": {
                "type": "integer",
                "format": "int32"
              }
            }
          },
          "reasoning": {
            "type": "string"
          }
        }
      },
      "RemediationExploitationSignals": {
        "type": "object",
        "required": [
          "inCisaKev",
          "inVulnCheckKev",
          "crowdSecActive",
          "msrcConfirmedExploited",
          "redhatFixAvailable",
          "redhatAdvisoryCount",
          "totalExploitSources",
          "summary"
        ],
        "additionalProperties": false,
        "properties": {
          "inCisaKev": {
            "type": "boolean"
          },
          "inVulnCheckKev": {
            "type": "boolean"
          },
          "crowdSecActive": {
            "type": "boolean"
          },
          "msrcConfirmedExploited": {
            "type": "boolean"
          },
          "redhatFixAvailable": {
            "type": "boolean",
            "description": "An RHSA lists at least one fixed product."
          },
          "redhatAdvisoryCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalExploitSources": {
            "type": "integer",
            "format": "int32",
            "description": "Count of CISA KEV, VulnCheck KEV, active CrowdSec and MSRC exploited that hold."
          },
          "summary": {
            "type": "string"
          }
        }
      },
      "RemediationIdentifierField": {
        "type": "string",
        "description": "The normalised vulnerability id (aliases followed)."
      },
      "RemediationLinks": {
        "type": "array",
        "description": "Links to this vulnerability's other answers.",
        "maxItems": 32,
        "items": {
          "$ref": "#/components/schemas/APILink"
        }
      },
      "RemediationMsrcAdvisory": {
        "type": "object",
        "description": "Microsoft's advisory for the vulnerability.",
        "required": [
          "trackingId",
          "advisoryUrl",
          "status",
          "isExploited",
          "currentReleaseDate"
        ],
        "additionalProperties": false,
        "properties": {
          "trackingId": {
            "type": "string"
          },
          "advisoryUrl": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "exploitabilityIndex": {
            "type": "string"
          },
          "isExploited": {
            "type": "boolean"
          },
          "currentReleaseDate": {
            "type": "integer",
            "format": "int64",
            "description": "As stored (Unix time)."
          },
          "patchTuesday": {
            "type": "object",
            "required": [
              "title",
              "releaseDate"
            ],
            "additionalProperties": false,
            "properties": {
              "title": {
                "type": "string"
              },
              "releaseDate": {
                "type": "integer",
                "format": "int64"
              }
            }
          }
        }
      },
      "RemediationMsrcKbPatch": {
        "type": "object",
        "description": "A Microsoft product the advisory covers, with its update.",
        "required": [
          "productName",
          "status"
        ],
        "additionalProperties": false,
        "properties": {
          "productName": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "kbArticleId": {
            "type": "string"
          },
          "kbArticleUrl": {
            "type": "string"
          },
          "downloadUrl": {
            "type": "string"
          },
          "remediationCategory": {
            "type": "string"
          },
          "familyName": {
            "type": "string"
          }
        }
      },
      "RemediationNotFoundError": {
        "type": "object",
        "description": "The vulnerability has no record.",
        "required": [
          "error",
          "identifier"
        ],
        "additionalProperties": false,
        "properties": {
          "error": {
            "type": "string",
            "enum": [
              "Vulnerability not found"
            ]
          },
          "identifier": {
            "type": "string",
            "description": "The normalised identifier that was looked up."
          }
        }
      },
      "RemediationNullableText": {
        "type": [
          "string",
          "null"
        ]
      },
      "RemediationOsInfo": {
        "type": "object",
        "description": "The operating system parsed from `os`.",
        "required": [
          "distro",
          "packageFormat",
          "packageManager"
        ],
        "additionalProperties": false,
        "properties": {
          "distro": {
            "type": "string",
            "enum": [
              "ubuntu",
              "debian",
              "redhat",
              "centos",
              "fedora",
              "almalinux",
              "rockylinux",
              "alpine",
              "suse",
              "opensuse",
              "amzn",
              "oracle"
            ]
          },
          "version": {
            "type": "string"
          },
          "packageFormat": {
            "type": "string",
            "description": "deb, rpm or apk."
          },
          "packageManager": {
            "type": "string",
            "description": "apt, dnf, yum, apk or zypper."
          }
        }
      },
      "RemediationPageCounter": {
        "type": "integer",
        "format": "int32"
      },
      "RemediationPageLimit": {
        "type": "integer",
        "format": "int32"
      },
      "RemediationPlanAction": {
        "type": "object",
        "description": "One step of the prioritised plan.",
        "required": [
          "priority",
          "type",
          "title",
          "description",
          "effort",
          "impact",
          "steps",
          "buildFromSourceRequired"
        ],
        "additionalProperties": false,
        "properties": {
          "priority": {
            "type": "integer",
            "format": "int32"
          },
          "type": {
            "type": "string",
            "enum": [
              "upgrade",
              "patch",
              "workaround",
              "monitor"
            ]
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "effort": {
            "type": "string",
            "enum": [
              "low",
              "medium"
            ]
          },
          "impact": {
            "type": "string",
            "enum": [
              "complete_fix",
              "partial_mitigation",
              "none"
            ]
          },
          "steps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "verification": {
            "type": "array",
            "description": "Upgrade actions with `includeVerificationSteps=true` only.",
            "items": {
              "type": "string"
            }
          },
          "fix": {
            "type": "object",
            "required": [
              "ecosystem",
              "packageName",
              "fixedVersion",
              "purl"
            ],
            "additionalProperties": false,
            "properties": {
              "ecosystem": {
                "type": "string"
              },
              "packageName": {
                "type": "string"
              },
              "fixedVersion": {
                "type": "string"
              },
              "purl": {
                "type": "string"
              }
            }
          },
          "buildFromSourceRequired": {
            "type": "boolean"
          }
        }
      },
      "RemediationPlanContext": {
        "type": "object",
        "description": "The context read from the query (a purl or CPE fills gaps).",
        "required": [
          "ecosystem",
          "packageName",
          "currentVersion",
          "purl",
          "matchedDistro",
          "matchedContainer"
        ],
        "additionalProperties": false,
        "properties": {
          "ecosystem": {
            "type": "string"
          },
          "packageName": {
            "type": "string"
          },
          "currentVersion": {
            "type": "string"
          },
          "purl": {
            "type": "string"
          },
          "matchedDistro": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/RemediationOsInfo"
              },
              {
                "type": "null"
              }
            ]
          },
          "matchedContainer": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/RemediationContainerRef"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "RemediationPlanKevEntry": {
        "type": "object",
        "description": "A CISA KEV catalogue entry.",
        "required": [
          "source",
          "vendorProject",
          "product",
          "vulnerabilityName",
          "requiredAction",
          "dateAdded",
          "dueDate",
          "overdue",
          "daysUntilDue",
          "knownRansomwareCampaignUse",
          "notes"
        ],
        "additionalProperties": false,
        "properties": {
          "source": {
            "type": "string",
            "enum": [
              "CISA"
            ]
          },
          "vendorProject": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "vulnerabilityName": {
            "type": "string"
          },
          "requiredAction": {
            "type": "string"
          },
          "dateAdded": {
            "type": "string",
            "format": "date-time"
          },
          "dueDate": {
            "type": "string",
            "format": "date-time"
          },
          "overdue": {
            "type": "boolean"
          },
          "daysUntilDue": {
            "type": "integer",
            "format": "int32",
            "description": "Negative once overdue."
          },
          "knownRansomwareCampaignUse": {
            "type": "string"
          },
          "cwes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "notes": {
            "$ref": "#/components/schemas/RemediationNullableText"
          }
        }
      },
      "RemediationPlanRedHatAdvisory": {
        "type": "object",
        "description": "A Red Hat advisory with product counts.",
        "required": [
          "rhsaId",
          "fixedProductCount",
          "affectedCount"
        ],
        "additionalProperties": false,
        "properties": {
          "rhsaId": {
            "type": "string"
          },
          "errataUrl": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "initialReleaseDate": {
            "type": "integer",
            "format": "int64"
          },
          "currentReleaseDate": {
            "type": "integer",
            "format": "int64"
          },
          "fixedProductCount": {
            "type": "integer",
            "format": "int32"
          },
          "affectedCount": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "RemediationPlanSeverity": {
        "type": "object",
        "required": [
          "cvssScore",
          "cvssVector",
          "baseSeverity",
          "epssScore",
          "epssPercentile",
          "cessScore",
          "inKev",
          "kevDueDate",
          "exploitationMaturity",
          "cvssDetails"
        ],
        "additionalProperties": false,
        "properties": {
          "cvssScore": {
            "type": [
              "number",
              "null"
            ],
            "description": "The highest CVSS base score any source gives."
          },
          "cvssVector": {
            "$ref": "#/components/schemas/RemediationNullableText"
          },
          "baseSeverity": {
            "type": [
              "string",
              "null"
            ],
            "description": "The metric's severity, or NONE/LOW/MEDIUM/HIGH/CRITICAL derived from the score."
          },
          "epssScore": {
            "type": [
              "number",
              "null"
            ]
          },
          "epssPercentile": {
            "type": [
              "number",
              "null"
            ]
          },
          "cessScore": {
            "type": [
              "number",
              "null"
            ]
          },
          "inKev": {
            "type": "boolean",
            "description": "Listed in CISA KEV or VulnCheck KEV."
          },
          "kevDueDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "The first CISA KEV entry's due date."
          },
          "exploitationMaturity": {
            "$ref": "#/components/schemas/RemediationExploitationMaturity"
          },
          "cvssDetails": {
            "type": "object",
            "description": "CVSS components of the highest-scoring metric; null where unknown.",
            "required": [
              "attackVector",
              "attackComplexity",
              "privilegesRequired",
              "userInteraction",
              "scope",
              "confidentialityImpact",
              "integrityImpact",
              "availabilityImpact"
            ],
            "additionalProperties": false,
            "properties": {
              "attackVector": {
                "$ref": "#/components/schemas/RemediationNullableText"
              },
              "attackComplexity": {
                "$ref": "#/components/schemas/RemediationNullableText"
              },
              "privilegesRequired": {
                "$ref": "#/components/schemas/RemediationNullableText"
              },
              "userInteraction": {
                "$ref": "#/components/schemas/RemediationNullableText"
              },
              "scope": {
                "$ref": "#/components/schemas/RemediationNullableText"
              },
              "confidentialityImpact": {
                "$ref": "#/components/schemas/RemediationNullableText"
              },
              "integrityImpact": {
                "$ref": "#/components/schemas/RemediationNullableText"
              },
              "availabilityImpact": {
                "$ref": "#/components/schemas/RemediationNullableText"
              }
            }
          }
        }
      },
      "RemediationPlanSsvc": {
        "type": "object",
        "description": "Default ladder: Act (ACTIVE exploitation, CVSS 9+), Attend (ACTIVE), Track* (CVSS 9+), else Track. A stored organisation policy decides instead and adds its keys.",
        "required": [
          "decision",
          "priority",
          "exploitation",
          "automatable",
          "technicalImpact"
        ],
        "additionalProperties": false,
        "properties": {
          "decision": {
            "type": "string",
            "enum": [
              "Track",
              "Track*",
              "Attend",
              "Act"
            ]
          },
          "priority": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high",
              "immediate"
            ]
          },
          "exploitation": {
            "type": "string",
            "enum": [
              "NONE",
              "POC",
              "ACTIVE"
            ],
            "description": "ACTIVE when in a KEV catalogue, exploited per Microsoft, or maturity ACTIVE/WIDESPREAD; POC for POC/WEAPONIZED."
          },
          "automatable": {
            "type": "string",
            "enum": [
              "YES",
              "NO"
            ]
          },
          "technicalImpact": {
            "type": "string",
            "enum": [
              "PARTIAL",
              "TOTAL"
            ]
          },
          "policy": {
            "type": "string",
            "enum": [
              "tenant"
            ],
            "description": "Present when the organisation's SSVC policy decided."
          },
          "missionWellBeing": {
            "type": "string",
            "enum": [
              "LOW",
              "MEDIUM",
              "HIGH"
            ],
            "description": "Policy decisions only: the mission and well-being impact, from the repository's criticality."
          },
          "source": {
            "type": "string",
            "enum": [
              "table",
              "mapping",
              "override"
            ],
            "description": "Policy decisions only: what set the outcome."
          },
          "dueDays": {
            "type": "integer",
            "format": "int32",
            "description": "Policy decisions only, when the policy sets a deadline for the outcome."
          },
          "rule": {
            "type": "string",
            "description": "Policy decisions only: the name of the override rule that decided."
          }
        }
      },
      "RemediationPlanTimeline": {
        "type": "object",
        "required": [
          "datePublished",
          "currentAgeDays",
          "lifecycleStage",
          "kevDaysOverdue"
        ],
        "additionalProperties": false,
        "properties": {
          "datePublished": {
            "type": "string",
            "format": "date-time",
            "description": "The earliest source's publication date."
          },
          "currentAgeDays": {
            "type": "integer",
            "format": "int32"
          },
          "lifecycleStage": {
            "type": "string",
            "enum": [
              "NEW",
              "EMERGING",
              "MATURE",
              "LEGACY"
            ],
            "description": "NEW under 90 days, EMERGING under 365, MATURE under 730, else LEGACY."
          },
          "kevDaysOverdue": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Days past the first CISA KEV due date (negative before it); null outside CISA KEV."
          }
        }
      },
      "RemediationRedHatAdvisory": {
        "type": "object",
        "description": "A Red Hat advisory (RHSA) that fixes the vulnerability, with its products.",
        "required": [
          "rhsaId",
          "products"
        ],
        "additionalProperties": false,
        "properties": {
          "rhsaId": {
            "type": "string",
            "description": "RHSA id (or a CVE id for a VEX-only row); empty for an affected-row-derived entry."
          },
          "errataUrl": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "initialReleaseDate": {
            "type": "integer",
            "format": "int64",
            "description": "As stored (Unix time)."
          },
          "currentReleaseDate": {
            "type": "integer",
            "format": "int64",
            "description": "As stored (Unix time)."
          },
          "products": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/RemediationRedHatProduct"
            }
          }
        }
      },
      "RemediationRedHatProduct": {
        "type": "object",
        "required": [
          "productName",
          "status"
        ],
        "additionalProperties": false,
        "properties": {
          "productName": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "The product row's default status; empty when unset."
          },
          "vendor": {
            "type": "string"
          }
        }
      },
      "RemediationReference": {
        "type": "object",
        "required": [
          "url"
        ],
        "additionalProperties": false,
        "properties": {
          "url": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "description": "The source that carried the reference. Absent when empty."
          },
          "title": {
            "type": "string",
            "description": "Absent when empty."
          }
        }
      },
      "RemediationRegistryFix": {
        "type": "object",
        "description": "A fixed release in a package registry.",
        "required": [
          "ecosystem",
          "displayName",
          "registryKey",
          "packageName",
          "purl",
          "fixedVersions",
          "verified",
          "confidence"
        ],
        "additionalProperties": false,
        "properties": {
          "ecosystem": {
            "type": "string",
            "description": "Derived from the collection URL; `unknown` without one, else the URL itself."
          },
          "displayName": {
            "type": "string",
            "description": "Registry name (for example `PyPI`)."
          },
          "registryKey": {
            "type": "string",
            "description": "Stable registry key (for example `oci:kubernetes`)."
          },
          "registryUrl": {
            "type": "string",
            "description": "The affected row's collection URL. Absent when the row has none."
          },
          "packageName": {
            "type": "string",
            "description": "The affected row's package name, or its product when it has none."
          },
          "vendor": {
            "type": "string",
            "description": "The affected row's vendor. Absent when empty."
          },
          "purl": {
            "type": "string",
            "description": "Purl of the first fixed version; a URL collection URL yields `pkg:generic/...` today."
          },
          "fixedVersions": {
            "type": "array",
            "minItems": 1,
            "description": "Versions that fix the vulnerability, derived from the affected-version rows.",
            "items": {
              "type": "string"
            }
          },
          "defaultStatus": {
            "type": "string",
            "description": "The affected row's default status. Absent when empty."
          },
          "platforms": {
            "type": "string",
            "description": "The affected row's platforms, as stored. Absent when the row has none."
          },
          "affectedRange": {
            "$ref": "#/components/schemas/RemediationAffectedRange"
          },
          "verified": {
            "type": "boolean",
            "description": "A registry release matches one of the fixed versions."
          },
          "confidence": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "description": "By registry rows linking package and vulnerability: 2+ `high`, 1 `medium`, 0 `low`."
          },
          "registryVerification": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Absent when unverified.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/RemediationRegistryVerification"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "RemediationRegistryVerification": {
        "type": "object",
        "description": "The fixed version as the package registry knows it.",
        "required": [
          "isLatest"
        ],
        "additionalProperties": false,
        "properties": {
          "latestVersion": {
            "type": "string",
            "description": "The registry version that matched a fixed version."
          },
          "fixPublishedAt": {
            "type": "integer",
            "format": "int64",
            "description": "When the registry published that version, as stored (Unix time)."
          },
          "isLatest": {
            "type": "boolean",
            "description": "That version is the package's latest release."
          },
          "relationshipType": {
            "type": "string",
            "description": "For example `fixed`."
          },
          "source": {
            "type": "string",
            "description": "The feed that linked the version to the vulnerability."
          }
        }
      },
      "RemediationSnortRule": {
        "type": "object",
        "description": "A Snort rule that detects exploitation (header fields only).",
        "required": [
          "snortId",
          "rev",
          "action",
          "protocol",
          "msg",
          "source",
          "disabled"
        ],
        "additionalProperties": false,
        "properties": {
          "snortId": {
            "type": "string"
          },
          "rev": {
            "type": "integer",
            "format": "int32"
          },
          "action": {
            "type": "string"
          },
          "protocol": {
            "type": "string"
          },
          "msg": {
            "type": "string"
          },
          "classtype": {
            "type": "string"
          },
          "signatureSeverity": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "disabled": {
            "type": "boolean"
          },
          "mitreTechIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "mitreTacticIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "RemediationSourceFix": {
        "type": "object",
        "description": "A commit, PR, gist, Exploit-DB or Vulnerability Lab entry; only its type's keys appear.",
        "required": [
          "type",
          "url",
          "buildFromSourceRequired"
        ],
        "additionalProperties": false,
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "commit",
              "pr",
              "gist",
              "exploit_db",
              "vulnerability_lab"
            ]
          },
          "url": {
            "type": "string"
          },
          "sha": {
            "type": "string",
            "description": "commit: the commit SHA (from the reference, or parsed from the URL)."
          },
          "authorName": {
            "type": "string"
          },
          "authorEmail": {
            "type": "string"
          },
          "authorLogin": {
            "type": "string"
          },
          "committerName": {
            "type": "string"
          },
          "committerEmail": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "verified": {
            "type": "boolean",
            "description": "commit: GitHub verified the commit signature."
          },
          "diffUrl": {
            "type": "string",
            "description": "pr: the diff URL (the PR URL plus `.diff` when none is stored)."
          },
          "mergedAt": {
            "type": "integer",
            "format": "int64",
            "description": "pr: when it was merged, as stored (Unix time)."
          },
          "mergeCommitSha": {
            "type": "string"
          },
          "prState": {
            "type": "string"
          },
          "prAuthor": {
            "type": "string"
          },
          "prLabels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "buildFromSourceRequired": {
            "type": "boolean",
            "description": "true for commit, pr and gist; false for exploit_db and vulnerability_lab."
          },
          "repositoryHealth": {
            "type": "string",
            "description": "Repository health metrics, as stored (JSON text)."
          },
          "gistId": {
            "type": "string"
          },
          "gistPublic": {
            "type": "boolean",
            "description": "Never emitted today: a stored value fails to read and drops the whole reference."
          },
          "gistFileCount": {
            "type": "integer",
            "format": "int32"
          },
          "gistFiles": {
            "type": "string",
            "description": "The gist's files, as stored (JSON text)."
          },
          "gistComments": {
            "type": "integer",
            "format": "int32"
          },
          "gistUpdatedAt": {
            "type": "string",
            "description": "Unix time as stored, as a decimal string."
          },
          "exploitDbId": {
            "type": "string"
          },
          "exploitDbAuthor": {
            "type": "string"
          },
          "exploitDbDate": {
            "type": "string",
            "description": "Unix time as stored, as a decimal string."
          },
          "exploitDbPlatform": {
            "type": "string"
          },
          "exploitDbType": {
            "type": "string"
          },
          "exploitDbVerified": {
            "type": "boolean",
            "description": "Never emitted today: a stored value fails to read and drops the whole reference."
          },
          "vlId": {
            "type": "string"
          },
          "vlTitle": {
            "type": "string"
          },
          "vlAuthor": {
            "type": "string"
          },
          "vlExploitationTechnique": {
            "type": "string"
          },
          "vlCreatedAt": {
            "type": "string",
            "description": "Unix time as stored, as a decimal string."
          }
        }
      },
      "RemediationStateField": {
        "type": [
          "string",
          "null"
        ],
        "description": "Record state from the most authoritative source (for example `PUBLISHED`)."
      },
      "RemediationTextEntry": {
        "type": "object",
        "description": "A free-text entry (workaround, configuration, solution or description) from a source's record.",
        "required": [
          "lang",
          "value",
          "source"
        ],
        "additionalProperties": false,
        "properties": {
          "lang": {
            "type": "string",
            "description": "Language tag; `en` when the record gives none."
          },
          "value": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "description": "The source of the record; `<source>:adp` for an ADP container's entry."
          },
          "type": {
            "type": "string",
            "enum": [
              "cna",
              "adp",
              "evaluator"
            ],
            "description": "CNA container, ADP container, or NVD evaluator text. Absent on descriptions."
          }
        }
      },
      "RemediationTimestampField": {
        "type": "integer",
        "format": "int64",
        "description": "When the answer was built (Unix seconds)."
      },
      "RemediationTitleField": {
        "type": [
          "string",
          "null"
        ],
        "description": "Title from the most authoritative source that has one."
      },
      "RemediationVendorComment": {
        "type": "object",
        "description": "A vendor statement from NVD's vendorComments.",
        "required": [
          "organization",
          "comment"
        ],
        "additionalProperties": false,
        "properties": {
          "organization": {
            "type": "string",
            "description": "`Unknown` when the record names none."
          },
          "comment": {
            "type": "string"
          },
          "lastModified": {
            "type": "string",
            "description": "As the record states it. Absent when empty."
          }
        }
      },
      "RemediationVendorPatch": {
        "type": "object",
        "description": "A non-distro, non-Microsoft, non-Red Hat vendor on the affected rows.",
        "required": [
          "vendor",
          "product"
        ],
        "additionalProperties": false,
        "properties": {
          "vendor": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "advisoryUrl": {
            "type": "string",
            "description": "The vendor's security page for the vulnerability, when known."
          }
        }
      },
      "RemediationVersionComparison": {
        "type": "object",
        "description": "`currentVersion` against the first registry fix.",
        "required": [
          "kind",
          "text"
        ],
        "additionalProperties": false,
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "safe",
              "unsafe",
              "unknown"
            ]
          },
          "text": {
            "type": "string"
          }
        }
      },
      "RemediationVulnCheckKevEntry": {
        "type": "object",
        "description": "A VulnCheck KEV entry.",
        "required": [
          "kevId"
        ],
        "additionalProperties": false,
        "properties": {
          "kevId": {
            "type": "string"
          },
          "reportedExploitations": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "additionalProperties": false,
              "properties": {
                "url": {
                  "type": "string"
                },
                "dateAdded": {
                  "type": "integer",
                  "format": "int64",
                  "description": "As stored (Unix time)."
                }
              }
            }
          },
          "xdbEntries": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "xdbId",
                "xdbUrl"
              ],
              "additionalProperties": false,
              "properties": {
                "xdbId": {
                  "type": "string"
                },
                "xdbUrl": {
                  "type": "string"
                },
                "exploitType": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "ResolveInputsResponse": {
        "type": "object",
        "required": [
          "resolved"
        ],
        "additionalProperties": false,
        "properties": {
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          }
        }
      },
      "ResolvedInputs": {
        "type": "object",
        "description": "What the inputs became.",
        "required": [
          "kinds",
          "vulnIds"
        ],
        "additionalProperties": false,
        "properties": {
          "kinds": {
            "type": "array",
            "maxItems": 11,
            "description": "The input kinds used.",
            "items": {
              "type": "string",
              "enum": [
                "vulnId",
                "package",
                "ecosystem",
                "version",
                "vendor",
                "product",
                "cpe",
                "purl",
                "swid",
                "tei",
                "cel"
              ]
            }
          },
          "vulnIds": {
            "type": "array",
            "maxItems": 1000,
            "description": "Every advisory id the inputs resolved to, aliases included, ranked as the fan-out runs them: known exploited first, then CVE, GHSA and CNVD, then the rest, newest first within each.",
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "packages": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "name"
              ],
              "properties": {
                "ecosystem": {
                  "type": "string",
                  "maxLength": 32
                },
                "name": {
                  "type": "string",
                  "maxLength": 512
                },
                "version": {
                  "type": "string",
                  "maxLength": 128
                }
              }
            }
          },
          "products": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "product"
              ],
              "properties": {
                "vendor": {
                  "type": "string",
                  "maxLength": 512
                },
                "product": {
                  "type": "string",
                  "maxLength": 512
                },
                "version": {
                  "type": "string",
                  "maxLength": 128
                }
              }
            }
          },
          "truncated": {
            "type": "boolean",
            "description": "A TEI or CEL selection was capped at 500 packages, or the CEL evaluation at 5,000 matches."
          },
          "versionless": {
            "type": "boolean",
            "description": "A package was given with no version: every advisory naming it with some version affected is included."
          },
          "anyEcosystem": {
            "type": "boolean",
            "description": "A package was given with no ecosystem and matched by name across ecosystems."
          },
          "partial": {
            "type": "boolean",
            "description": "The CPE identity lookup hit its 20 second bound; the answer holds what was found."
          }
        }
      },
      "SafeHarbourPickReason": {
        "type": "string",
        "description": "`only-prerelease`: every cleared version is a pre-release. `no-running-version`: the pick needs the version in use. `no-dates`: no non-malware version has a publish date. `no-candidates`: no version is cleared (for `rolling`, every version is malware). `no-prior-day`: every dated version shares one release day. `dates-incomplete`: undated releases sit between the rolling day and the previous dated day. `no-prior-release`: no stable version below the highest. `semver-fallback-day`: see `SafeHarbourPickReasons`.",
        "enum": [
          "only-prerelease",
          "no-running-version",
          "no-dates",
          "no-candidates",
          "no-prior-day",
          "dates-incomplete",
          "no-prior-release",
          "semver-fallback-day"
        ]
      },
      "SafeHarbourPickReasons": {
        "type": "object",
        "description": "Why a pick is absent, keyed by pick name. `semver-fallback-day` is not an absence: the versions cannot be ordered, so `rollingPrevSemver` is the closest member of `rollingPrevDay`.",
        "additionalProperties": false,
        "properties": {
          "latest": {
            "$ref": "#/components/schemas/SafeHarbourPickReason"
          },
          "safest": {
            "$ref": "#/components/schemas/SafeHarbourPickReason"
          },
          "stable": {
            "$ref": "#/components/schemas/SafeHarbourPickReason"
          },
          "parity": {
            "$ref": "#/components/schemas/SafeHarbourPickReason"
          },
          "rolling": {
            "$ref": "#/components/schemas/SafeHarbourPickReason"
          },
          "rollingPrevDay": {
            "$ref": "#/components/schemas/SafeHarbourPickReason"
          },
          "rollingPrevSemver": {
            "$ref": "#/components/schemas/SafeHarbourPickReason"
          }
        }
      },
      "SafeHarbourPicks": {
        "type": "object",
        "description": "The Safe Harbour picks, from the scheme-aware rules in vdb-sca-match/version. Malware is removed before any pick. `latest`, `safest`, `stable` and `parity` are drawn from versions with no known vulnerability, exploit or (where known) end of life; the rolling picks may include exposed versions. A pick with no answer is absent, with the cause in `reasons`. Present on search results only when the package's ecosystem is known.",
        "additionalProperties": false,
        "required": [
          "scheme",
          "orderable",
          "rolling",
          "rollingPrevDay"
        ],
        "properties": {
          "scheme": {
            "type": "string",
            "maxLength": 64,
            "description": "The versioning scheme the versions were judged under (a catalogue id in vdb-sca-match/version/schemes.json).",
            "examples": [
              "semver"
            ]
          },
          "orderable": {
            "type": "boolean",
            "description": "False when the versions could not be ordered by number; `latest` and `safest` are then the most recent stable release by date."
          },
          "latest": {
            "type": "string",
            "maxLength": 256,
            "description": "The highest stable clean release by the scheme's order (not the most recently published)."
          },
          "safest": {
            "type": "string",
            "maxLength": 256,
            "description": "The highest stable clean release; computed separately from `latest`."
          },
          "stable": {
            "type": "string",
            "maxLength": 256,
            "description": "The stable clean release closest to the version in use. Absent when no version was given."
          },
          "parity": {
            "type": "string",
            "maxLength": 256,
            "description": "The available release nearest the version in use by the scheme's full order; exposed releases are eligible."
          },
          "rolling": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Every distinct non-malware version published on the release day of the highest version, highest first. Always an array; empty when no version carries a publish date. Join with a comma for one string."
          },
          "rollingDate": {
            "type": "string",
            "format": "date",
            "maxLength": 10,
            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
            "description": "That release day, UTC."
          },
          "rollingTarget": {
            "type": "string",
            "maxLength": 256,
            "description": "The member of `rolling` closest to the version in use: the single fix target for the rolling strategy."
          },
          "rollingPrevDay": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "The rolling set one release day back, highest first. Always an array."
          },
          "rollingPrevDayDate": {
            "type": "string",
            "format": "date",
            "maxLength": 10,
            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
            "description": "That release day, UTC."
          },
          "rollingPrevDayTarget": {
            "type": "string",
            "maxLength": 256,
            "description": "The member of `rollingPrevDay` closest to the version in use."
          },
          "rollingPrevSemver": {
            "type": "string",
            "maxLength": 256,
            "description": "One release back by version order."
          },
          "reasons": {
            "$ref": "#/components/schemas/SafeHarbourPickReasons"
          }
        }
      },
      "SafeHarbourSummary": {
        "type": "object",
        "description": "Package-level Safe Harbour summary: the versions sharing the highest score, the canonical recommendation and, where the ecosystem is known, the scheme-aware picks.",
        "additionalProperties": false,
        "required": [
          "recommendedVersions",
          "highestScore"
        ],
        "properties": {
          "recommendedVersions": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Every non-malware version sharing the highest score, sorted.",
            "examples": [
              [
                "4.21.0",
                "4.21.1"
              ]
            ]
          },
          "highestScore": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1,
            "description": "The highest score across all versions; 0 when there are none.",
            "examples": [
              0.98
            ]
          },
          "recommendation": {
            "type": "object",
            "description": "The canonical single-version recommendation. Absent on search results and when no rule picks a version.",
            "additionalProperties": false,
            "required": [
              "version",
              "reason"
            ],
            "properties": {
              "version": {
                "type": "string",
                "maxLength": 256,
                "description": "Recommended version; empty when every published version is malware (remove the dependency)."
              },
              "reason": {
                "type": "string",
                "maxLength": 1024,
                "description": "Why this version."
              }
            }
          },
          "picks": {
            "$ref": "#/components/schemas/SafeHarbourPicks"
          }
        }
      },
      "SafeHarbourVersion": {
        "type": "object",
        "description": "Per-version Safe Harbour scoring. The score (0-1) says how safe a version is to use: higher is safer, and the highest versions with the fewest and least severe vulnerabilities score closest to 1. Every version gets a score.",
        "additionalProperties": false,
        "required": [
          "vulnerabilityCount",
          "safeHarbourScore",
          "isMajorRelease",
          "maxSeverity",
          "isMalware",
          "exploitCount",
          "inKev"
        ],
        "properties": {
          "version": {
            "type": "string",
            "maxLength": 256,
            "description": "The version string."
          },
          "vulnerabilityCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "CVEs affecting this version.",
            "examples": [
              3
            ]
          },
          "safeHarbourScore": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1,
            "description": "Safety score, 0-1; higher is safer.",
            "examples": [
              0.92
            ]
          },
          "isMajorRelease": {
            "type": "boolean",
            "description": "Whether this is a semver major release boundary (1.0.0, 2.0.0).",
            "examples": [
              false
            ]
          },
          "maxSeverity": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "CRITICAL",
              "HIGH",
              "MEDIUM",
              "LOW",
              "NONE",
              null
            ],
            "description": "Highest CVSS severity across the version's CVEs; null when it has none.",
            "examples": [
              "HIGH"
            ]
          },
          "isMalware": {
            "type": "boolean",
            "description": "Whether the version is flagged as malware."
          },
          "exploitCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Known exploits across the version's CVEs."
          },
          "maxExploitMaturity": {
            "type": "string",
            "enum": [
              "NONE",
              "POC",
              "WEAPONIZED",
              "ACTIVE",
              "WIDESPREAD"
            ],
            "description": "Highest exploit maturity across the version's CVEs. Absent when unknown."
          },
          "maxCvssScore": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 10,
            "description": "Highest CVSS base score. Absent when unknown."
          },
          "maxEpssScore": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1,
            "description": "Highest EPSS probability. Absent when unknown."
          },
          "maxCessScore": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "description": "Highest CESS score. Absent when unknown."
          },
          "inKev": {
            "type": "boolean",
            "description": "Whether any of the version's CVEs is in CISA KEV."
          },
          "maxThreatExposure": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 100,
            "description": "Highest threat-exposure value across the version's CVEs. Absent when unknown."
          },
          "cveIds": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "CVE identifiers behind the score. Absent when there are none."
          },
          "daysSinceRelease": {
            "type": "integer",
            "format": "int32",
            "description": "Days since the version was released, when known (a recommendation tie-break)."
          },
          "publishedAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "description": "Release time in Unix milliseconds, when the source recorded it. Set on search results and other routes that read publish times."
          }
        }
      },
      "SafeText": {
        "type": "string",
        "description": "Free text: letters, digits, spaces and `. _ : @ + # , -`.",
        "minLength": 1,
        "maxLength": 256,
        "pattern": "^[A-Za-z0-9 ._:@+#,-]{1,256}$",
        "examples": [
          "log4j"
        ]
      },
      "SafetyMatrixBulkRow": {
        "type": "object",
        "description": "One package's Safe Harbour state and picks. A pick with no answer is null, with the cause in `reasons`. `plan-locked` and `none-tracked` rows carry nulls and zeroes.",
        "additionalProperties": false,
        "required": [
          "name",
          "ecosystem",
          "state",
          "latest",
          "safest",
          "stable",
          "parity",
          "rolling",
          "rollingDate",
          "rollingTarget",
          "rollingPrevDay",
          "rollingPrevDayDate",
          "rollingPrevDayTarget",
          "rollingPrevSemver",
          "versionsTracked",
          "safeVersions"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 512,
            "description": "Lowercased package name."
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "Lowercased ecosystem."
          },
          "state": {
            "type": "string",
            "enum": [
              "ok",
              "no-safe-harbour",
              "none-tracked",
              "plan-locked"
            ],
            "description": "`ok`: at least one clean version. `no-safe-harbour`: versions are known but none is clean. `none-tracked`: no version is known. `plan-locked`: the package needs Pro."
          },
          "latest": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "safest": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "stable": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Null when no `version` was given."
          },
          "parity": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Null when no `version` was given."
          },
          "rolling": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Null on `plan-locked` and `none-tracked` rows, otherwise an array."
          },
          "rollingDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "maxLength": 10
          },
          "rollingTarget": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "rollingPrevDay": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Null on `plan-locked` and `none-tracked` rows, otherwise an array."
          },
          "rollingPrevDayDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "maxLength": 10
          },
          "rollingPrevDayTarget": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "rollingPrevSemver": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "versionsTracked": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Versions considered (at most the newest 400 from the inventory)."
          },
          "safeVersions": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "description": "Clean versions among them."
          },
          "reasons": {
            "$ref": "#/components/schemas/SafeHarbourPickReasons"
          },
          "versionSource": {
            "type": "string",
            "enum": [
              "github-releases",
              "github-tags"
            ],
            "description": "Present when the versions were read from GitHub."
          },
          "sourceRepo": {
            "type": "string",
            "maxLength": 256,
            "description": "`owner/name` of the GitHub repository read; present with `versionSource`."
          },
          "releasesRead": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200,
            "description": "GitHub releases or tags read; present with `versionSource`."
          }
        }
      },
      "SafetyMatrixBulkTooManyError": {
        "type": "object",
        "description": "More than 100 distinct packages in one batch.",
        "additionalProperties": false,
        "required": [
          "error",
          "max"
        ],
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 256
          },
          "max": {
            "type": "integer",
            "format": "int32",
            "enum": [
              100
            ]
          }
        }
      },
      "ScanError": {
        "type": "object",
        "description": "An error on the scan routes. The message is repeated at `error` and `data.error`.",
        "additionalProperties": false,
        "required": [
          "success",
          "error",
          "meta",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          },
          "meta": {
            "$ref": "#/components/schemas/ScanResponseMeta"
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "error"
            ],
            "properties": {
              "error": {
                "type": "string",
                "maxLength": 2048
              }
            }
          }
        }
      },
      "ScanFindingResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "findingId",
          "findingUuid"
        ],
        "properties": {
          "findingId": {
            "type": "string",
            "maxLength": 256,
            "description": "The vulnerability id of the finding."
          },
          "findingUuid": {
            "type": "string",
            "maxLength": 64
          },
          "packageName": {
            "type": "string",
            "maxLength": 512
          },
          "packageVersion": {
            "type": "string",
            "maxLength": 256
          },
          "purl": {
            "type": "string",
            "maxLength": 2048
          },
          "introducedVia": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScanIntroducedViaPath"
            }
          }
        }
      },
      "ScanIngestionSnapshot": {
        "type": "object",
        "description": "The scanner-results snapshot this scan was saved as. Absent when the scan was not saved.",
        "additionalProperties": false,
        "required": [
          "uuid",
          "url",
          "createdAt"
        ],
        "properties": {
          "uuid": {
            "$ref": "#/components/schemas/Uuid"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048,
            "description": "Console page for the snapshot."
          },
          "createdAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999999,
            "description": "Unix milliseconds."
          }
        }
      },
      "ScanIntroducedViaPath": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "pathIndex",
          "pathLength",
          "packageManager",
          "manifestFile",
          "dependencyPath",
          "dependencyKeys"
        ],
        "properties": {
          "pathIndex": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "pathLength": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "packageManager": {
            "type": "string",
            "maxLength": 64
          },
          "manifestFile": {
            "type": "string",
            "maxLength": 1024
          },
          "dependencyPath": {
            "type": "string",
            "maxLength": 65536
          },
          "dependencyKeys": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string",
              "maxLength": 1024
            }
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64
          },
          "sourceType": {
            "type": "string",
            "maxLength": 32
          },
          "installedPath": {
            "type": "string",
            "maxLength": 1024
          }
        }
      },
      "ScanReachabilityHit": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "vulnId",
          "language",
          "name",
          "queryText"
        ],
        "properties": {
          "vulnId": {
            "type": "string",
            "maxLength": 256
          },
          "purl": {
            "type": "string",
            "maxLength": 2048
          },
          "source": {
            "type": "string",
            "maxLength": 256
          },
          "language": {
            "type": "string",
            "maxLength": 64
          },
          "name": {
            "type": "string",
            "maxLength": 512
          },
          "queryText": {
            "type": "string",
            "maxLength": 65536
          },
          "queryHash": {
            "type": "string",
            "maxLength": 128
          },
          "description": {
            "type": "string",
            "maxLength": 8192
          },
          "derivedBy": {
            "type": "string",
            "maxLength": 256
          },
          "captures": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true,
              "maxProperties": 64
            }
          },
          "predicates": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true,
              "maxProperties": 64
            }
          }
        }
      },
      "ScanResponseMeta": {
        "type": "object",
        "description": "Envelope metadata on every answer of the scan routes, success or error.",
        "additionalProperties": false,
        "required": [
          "tier",
          "endpointVersion",
          "requestId",
          "timestamp"
        ],
        "properties": {
          "tier": {
            "type": "string",
            "enum": [
              "community",
              "pro"
            ],
            "description": "`pro` for Pro, Teams and Enterprise callers, `community` otherwise."
          },
          "endpointVersion": {
            "type": "string",
            "enum": [
              "2.0"
            ]
          },
          "requestId": {
            "type": "string",
            "minLength": 16,
            "maxLength": 256,
            "description": "Not a per-request id: it is the caller credential's access key id (JWT) or the organisation UUID (API key or Authentik token), and a fresh UUID only when that value is shorter than 16 characters. It is the same on every answer to the same caller."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was written."
          },
          "tierGated": {
            "type": "object",
            "additionalProperties": false,
            "description": "Below Pro on a successful scan: the data the plan withheld. Absent for Pro and above and on errors.",
            "properties": {
              "reachability": {
                "type": "boolean",
                "enum": [
                  true
                ],
                "description": "`data.reachability` was withheld (it is null)."
              }
            }
          }
        }
      },
      "ScanResult": {
        "type": "object",
        "description": "A completed synchronous scan: envelope metadata and the analysis.",
        "additionalProperties": false,
        "required": [
          "meta",
          "data"
        ],
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/ScanResponseMeta"
          },
          "data": {
            "$ref": "#/components/schemas/ScanResultData"
          }
        }
      },
      "ScanResultData": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "cyclonedx",
          "reachability",
          "stats"
        ],
        "properties": {
          "cyclonedx": {
            "type": "object",
            "description": "A CycloneDX 1.6 JSON document (validated against the 1.6 schema before it is returned): the scanned components and a `vulnerabilities` array whose `affects[].ref` points at them. Vulnesis enrichment rides on `vulnerabilities[].properties` as `vulnetix:*` names.",
            "additionalProperties": true,
            "maxProperties": 32,
            "required": [
              "bomFormat",
              "specVersion"
            ],
            "properties": {
              "bomFormat": {
                "type": "string",
                "enum": [
                  "CycloneDX"
                ]
              },
              "specVersion": {
                "type": "string",
                "enum": [
                  "1.6"
                ]
              }
            }
          },
          "reachability": {
            "type": [
              "array",
              "null"
            ],
            "description": "Pro and above. Null below Pro (named in `meta.tierGated`). Tree-sitter queries to run against your source to test whether each vulnerable code path is reached; null when there are none.",
            "items": {
              "$ref": "#/components/schemas/ScanReachabilityHit"
            }
          },
          "stats": {
            "$ref": "#/components/schemas/ScanStats"
          },
          "ingestionSnapshot": {
            "$ref": "#/components/schemas/ScanIngestionSnapshot"
          },
          "findings": {
            "type": "array",
            "description": "The findings saved for this scan. Present only when the scan was saved and produced findings.",
            "items": {
              "$ref": "#/components/schemas/ScanFindingResult"
            }
          }
        }
      },
      "ScanStats": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "purlsRequested",
          "purlsResolved",
          "vulnerabilitiesFound",
          "reachabilityQueries"
        ],
        "properties": {
          "purlsRequested": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 5000,
            "description": "Distinct purls taken from the upload."
          },
          "purlsResolved": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 5000,
            "description": "Purls that parsed and were looked up."
          },
          "vulnerabilitiesFound": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "reachabilityQueries": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          }
        }
      },
      "ScorecardCheck": {
        "type": "object",
        "required": [
          "name",
          "score",
          "reason",
          "shortDescription",
          "documentationUrl"
        ],
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 128,
            "description": "The check (Code-Review, Maintained and the rest)."
          },
          "score": {
            "type": "integer",
            "format": "int32",
            "minimum": -1,
            "maximum": 10,
            "description": "0 to 10; -1 when the check could not run."
          },
          "reason": {
            "type": "string",
            "maxLength": 4096
          },
          "shortDescription": {
            "type": "string",
            "maxLength": 4096
          },
          "documentationUrl": {
            "type": "string",
            "maxLength": 2048
          },
          "details": {
            "type": "string",
            "maxLength": 65536
          }
        }
      },
      "ScorecardEntry": {
        "type": "object",
        "description": "An OpenSSF Scorecard run linked to the vulnerability.",
        "required": [
          "repository",
          "overallScore",
          "checks"
        ],
        "additionalProperties": false,
        "properties": {
          "repository": {
            "type": "string",
            "maxLength": 512
          },
          "overallScore": {
            "type": "number",
            "minimum": -1,
            "maximum": 10
          },
          "date": {
            "type": "string",
            "maxLength": 40,
            "description": "When the run was made, RFC 3339."
          },
          "repositoryCommit": {
            "type": "string",
            "maxLength": 64
          },
          "scorecardVersion": {
            "type": "string",
            "maxLength": 64
          },
          "scorecardCommit": {
            "type": "string",
            "maxLength": 64
          },
          "checks": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "$ref": "#/components/schemas/ScorecardCheck"
            },
            "description": "Highest score first."
          }
        }
      },
      "ScorecardSearchResult": {
        "type": "object",
        "required": [
          "uuid",
          "repository",
          "overallScore",
          "linkedCves",
          "checks"
        ],
        "additionalProperties": false,
        "properties": {
          "uuid": {
            "$ref": "#/components/schemas/Uuid"
          },
          "repository": {
            "type": "string",
            "maxLength": 512
          },
          "overallScore": {
            "type": "number",
            "minimum": -1,
            "maximum": 10
          },
          "date": {
            "type": "string",
            "maxLength": 40,
            "description": "RFC 3339."
          },
          "scorecardVersion": {
            "type": "string",
            "maxLength": 64
          },
          "repositoryCommit": {
            "type": "string",
            "maxLength": 64
          },
          "linkedCves": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Vulnerabilities linked to this run."
          },
          "checks": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "$ref": "#/components/schemas/ScorecardCheck"
            }
          }
        }
      },
      "SearchAttackTechniquesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "attackTechniques"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Rows in this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rows matching in all."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200,
            "description": "The page size applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The offset applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "attackTechniques": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/AttackTechniqueSearchRow"
            },
            "description": "Newest mapping first, then by technique id."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          }
        }
      },
      "SearchCountermeasuresResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "byKind",
          "resolved",
          "countermeasures"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Defences on this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Every matching defence. Visible to every tier: that a defence exists is the warning, the rule is the product."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "byKind": {
            "type": "object",
            "description": "Count per kind (keys are this lane's kinds), over every matching defence, not the page. Visible to every tier.",
            "maxProperties": 16,
            "additionalProperties": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 2147483647
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "countermeasures": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/CountermeasureRecord"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature countermeasures). Ordered by kind, then newest first."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "SearchEolIdentifiersResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "total",
          "limit",
          "offset",
          "hasMore",
          "identifiers"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Matching identifiers the caller may see."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9223372036854775807,
            "description": "The offset applied, echoed as parsed (any non-negative integer in log mode)."
          },
          "hasMore": {
            "type": "boolean"
          },
          "identifiers": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "type",
                "identifier",
                "productName",
                "productLabel",
                "category"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "maxLength": 32,
                  "description": "`purl`, `cpe` or `repology`."
                },
                "identifier": {
                  "type": "string",
                  "maxLength": 1024
                },
                "productName": {
                  "type": "string",
                  "maxLength": 128
                },
                "productLabel": {
                  "type": "string",
                  "maxLength": 256
                },
                "category": {
                  "type": "string",
                  "maxLength": 64
                }
              }
            }
          },
          "withheld": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Below Pro only: matching identifiers of vendor-lifecycle products left out (0 when none). Absent for Pro and above."
          },
          "_entitlements": {
            "$ref": "#/components/schemas/EolEntitlements"
          },
          "_links": {
            "type": "array",
            "maxItems": 1000,
            "description": "One `product` link per match, plus a `vuln` link for an identifier starting `CVE-`; absent when there are no matches.",
            "items": {
              "$ref": "#/components/schemas/APILink"
            }
          }
        }
      },
      "SearchIocsResponse": {
        "type": "object",
        "description": "A page of CrowdSec sightings.",
        "required": [
          "timestamp",
          "count",
          "limit",
          "offset",
          "sightings"
        ],
        "additionalProperties": false,
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 99999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 500,
            "description": "Rows on this page after the country and since filters."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 500
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "sightings": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 500,
            "items": {
              "$ref": "#/components/schemas/CrowdSecIocSighting"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Also null when the query failed."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "SearchIocsStixBundle": {
        "type": "object",
        "description": "A STIX 2.1 bundle: one identity (Vulnesis), one vulnerability per CVE, and per sighting an indicator (IPv4 pattern) and a sighting. Ids are deterministic, so the same data gives the same ids. `resolved` appears only when an input kind was given, and the bundle is then sent as `application/json`.",
        "required": [
          "type",
          "id",
          "objects"
        ],
        "additionalProperties": false,
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "bundle"
            ]
          },
          "id": {
            "type": "string",
            "maxLength": 64,
            "pattern": "^bundle--[0-9a-f-]{36}$"
          },
          "objects": {
            "type": "array",
            "maxItems": 1501,
            "items": {
              "type": "object",
              "required": [
                "type",
                "spec_version",
                "id",
                "created",
                "modified"
              ],
              "additionalProperties": false,
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "identity",
                    "vulnerability",
                    "indicator",
                    "sighting"
                  ]
                },
                "spec_version": {
                  "type": "string",
                  "enum": [
                    "2.1"
                  ]
                },
                "id": {
                  "type": "string",
                  "maxLength": 64,
                  "pattern": "^(identity|vulnerability|indicator|sighting)--[0-9a-f-]{36}$"
                },
                "created": {
                  "type": "string",
                  "format": "date-time",
                  "maxLength": 35
                },
                "modified": {
                  "type": "string",
                  "format": "date-time",
                  "maxLength": 35
                },
                "created_by_ref": {
                  "type": "string",
                  "maxLength": 64
                },
                "name": {
                  "type": "string",
                  "maxLength": 512
                },
                "identity_class": {
                  "type": "string",
                  "maxLength": 32
                },
                "sectors": {
                  "type": "array",
                  "maxItems": 8,
                  "items": {
                    "type": "string",
                    "maxLength": 64
                  }
                },
                "contact_information": {
                  "type": "string",
                  "maxLength": 256
                },
                "external_references": {
                  "type": "array",
                  "maxItems": 4,
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "source_name",
                      "external_id",
                      "url"
                    ],
                    "properties": {
                      "source_name": {
                        "type": "string",
                        "maxLength": 32
                      },
                      "external_id": {
                        "type": "string",
                        "maxLength": 226
                      },
                      "url": {
                        "type": "string",
                        "maxLength": 512
                      }
                    }
                  }
                },
                "indicator_types": {
                  "type": "array",
                  "maxItems": 4,
                  "items": {
                    "type": "string",
                    "maxLength": 64
                  }
                },
                "pattern": {
                  "type": "string",
                  "maxLength": 256
                },
                "pattern_type": {
                  "type": "string",
                  "enum": [
                    "stix"
                  ]
                },
                "valid_from": {
                  "type": "string",
                  "format": "date-time",
                  "maxLength": 35
                },
                "valid_until": {
                  "type": "string",
                  "format": "date-time",
                  "maxLength": 35
                },
                "labels": {
                  "type": "array",
                  "maxItems": 4,
                  "items": {
                    "type": "string",
                    "maxLength": 128
                  }
                },
                "sighting_of_ref": {
                  "type": "string",
                  "maxLength": 64
                },
                "observed_data_refs": {
                  "type": "array",
                  "maxItems": 1,
                  "items": {
                    "type": "string",
                    "maxLength": 64
                  }
                },
                "first_seen": {
                  "type": "string",
                  "format": "date-time",
                  "maxLength": 35
                },
                "last_seen": {
                  "type": "string",
                  "format": "date-time",
                  "maxLength": 35
                },
                "count": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 1,
                  "maximum": 1
                }
              }
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          }
        }
      },
      "SearchKevResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "count",
          "limit",
          "offset",
          "sources",
          "items"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "sources": {
            "type": "array",
            "minItems": 1,
            "maxItems": 4,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "CISA",
                "vulnetix",
                "enisa",
                "vulncheck"
              ]
            },
            "description": "The catalogues searched."
          },
          "items": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/KevSearchItem"
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs",
            "description": "Present when an input kind (purl, package, CPE, ...) was given: what it resolved to."
          }
        },
        "description": "One page of the merged KEV catalogues."
      },
      "SearchScorecardsResponse": {
        "type": "object",
        "required": [
          "query",
          "results",
          "total",
          "limit",
          "offset",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 256
          },
          "results": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/ScorecardSearchResult"
            },
            "description": "Highest overall score first."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Runs whose repository name contains the query. Reads 0 when the count query fails."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "_links": {
            "type": "array",
            "maxItems": 1,
            "items": {
              "$ref": "#/components/schemas/APILink"
            }
          }
        }
      },
      "SearchSnortRulesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "rules"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Rows in this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rows matching in all."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200,
            "description": "The page size applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The offset applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "rules": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/SnortRuleSearchRow"
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "SearchVersion": {
        "type": "object",
        "description": "One of a search result's 10 most recently published versions.",
        "additionalProperties": false,
        "required": [
          "version",
          "ecosystem",
          "sources",
          "cveIds",
          "publishedAt",
          "daysSinceRelease",
          "safeHarbour"
        ],
        "properties": {
          "version": {
            "type": "string",
            "maxLength": 256
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "Ecosystem as the dependency record spells it; empty when unknown."
          },
          "sources": {
            "type": "array",
            "maxItems": 1,
            "items": {
              "type": "string",
              "enum": [
                "dependency"
              ]
            },
            "description": "Where the version was found."
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Release time (RFC 3339), null when unknown."
          },
          "daysSinceRelease": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0,
            "description": "Whole days since release, null when unknown."
          },
          "cveIds": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "CVEs whose affected-version records name this exact version string."
          },
          "safeHarbour": {
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment).",
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/SafeHarbourVersion"
              }
            ]
          }
        }
      },
      "SearchVexStatementsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "count",
          "limit",
          "offset",
          "statements"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Statements in this page after the `since` filter."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "statements": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/VexStatement"
            },
            "description": "Newest first. Null (with `count` 0) when the statement query failed."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          }
        }
      },
      "SearchVirtualPatchesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "byKind",
          "resolved",
          "virtual-patches"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9999999999,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Defences on this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Every matching defence. Visible to every tier: that a defence exists is the warning, the rule is the product."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "byKind": {
            "type": "object",
            "description": "Count per kind (keys are this lane's kinds), over every matching defence, not the page. Visible to every tier.",
            "maxProperties": 16,
            "additionalProperties": {
              "type": "integer",
              "format": "int32",
              "minimum": 0,
              "maximum": 2147483647
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "virtual-patches": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/VirtualPatchRecord"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature virtual-patches). Ordered by kind, then newest first."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "SearchYaraRulesPlanLockedPage": {
        "type": "object",
        "description": "The empty page a below-Pro `matchString` search carries beside the `planLocked` marker.",
        "required": [
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "rules"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "enum": [
              0
            ]
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "enum": [
              0
            ]
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "hasMore": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "rules": {
            "type": "array",
            "maxItems": 0,
            "items": {
              "$ref": "#/components/schemas/YaraRuleSearchRow"
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          }
        }
      },
      "SearchYaraRulesResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "count",
          "total",
          "limit",
          "offset",
          "hasMore",
          "rules"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 253402300799,
            "description": "Unix seconds when the answer was built."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 200,
            "description": "Rows in this page."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rows matching in all."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 200,
            "description": "The page size applied."
          },
          "offset": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The offset applied."
          },
          "hasMore": {
            "type": "boolean",
            "description": "`offset + limit < total`."
          },
          "rules": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/YaraRuleSearchRow"
            }
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "SightingsData": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "crowdSec",
          "vulnCheckXDB",
          "vulnCheckReportedExploitation",
          "otherSources"
        ],
        "properties": {
          "crowdSec": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CrowdSecSummary"
              }
            ],
            "description": "Null when CrowdSec has no sighting."
          },
          "vulnCheckXDB": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VulnCheckXDBEntry"
            }
          },
          "vulnCheckReportedExploitation": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VulnCheckReportedEntry"
            }
          },
          "otherSources": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "$ref": "#/components/schemas/OtherSightingSource"
            },
            "description": "Exploit-table artefacts for the CVE, at most 20."
          }
        },
        "description": "Sighting and exploitation evidence detail."
      },
      "SnortRule": {
        "type": "object",
        "additionalProperties": false,
        "description": "A Snort or Suricata rule linked to the vulnerability.",
        "required": [
          "snortId",
          "rev",
          "action",
          "protocol",
          "srcIp",
          "srcPort",
          "direction",
          "dstIp",
          "dstPort",
          "msg",
          "disabled",
          "rawText",
          "source"
        ],
        "properties": {
          "snortId": {
            "type": "string",
            "maxLength": 32,
            "description": "Signature id (`sid`)."
          },
          "rev": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rule revision."
          },
          "action": {
            "type": "string",
            "maxLength": 16,
            "description": "Rule action (for example `alert`, `pass`, `drop`)."
          },
          "protocol": {
            "type": "string",
            "maxLength": 16,
            "description": "Rule header protocol (for example `tcp`, `udp`, `http`, `icmp`, `tls`, `ip`)."
          },
          "srcIp": {
            "type": "string",
            "maxLength": 256
          },
          "srcPort": {
            "type": "string",
            "maxLength": 256
          },
          "direction": {
            "type": "string",
            "maxLength": 4,
            "description": "`->` or `<>`."
          },
          "dstIp": {
            "type": "string",
            "maxLength": 256
          },
          "dstPort": {
            "type": "string",
            "maxLength": 256
          },
          "msg": {
            "type": "string",
            "maxLength": 1024,
            "description": "The rule's `msg`."
          },
          "flow": {
            "type": "string",
            "maxLength": 256,
            "description": "The `flow` option; absent when the rule has none."
          },
          "classtype": {
            "type": "string",
            "maxLength": 128,
            "description": "The `classtype` option; absent when the rule has none."
          },
          "disabled": {
            "type": "boolean",
            "description": "The rule ships commented out."
          },
          "rawText": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 65536,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The full rule text."
          },
          "confidence": {
            "type": "string",
            "maxLength": 64,
            "description": "Metadata `confidence`; absent when not set."
          },
          "signatureSeverity": {
            "type": "string",
            "maxLength": 64,
            "description": "Metadata `signature_severity` as published (Emerging Threats uses `Informational`, `Minor`, `Major`, `Critical`); absent when not set."
          },
          "affectedProducts": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Metadata `affected_product` values; absent when none."
          },
          "attackTargets": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Metadata `attack_target` values; absent when none."
          },
          "tags": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Metadata `tag` values; absent when none."
          },
          "mitreTechIds": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 32
            },
            "description": "ATT&CK technique ids (`T1190`, `T1059.001`); absent when none."
          },
          "mitreTacticIds": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 32
            },
            "description": "ATT&CK tactic ids (`TA0001`); absent when none."
          },
          "bodyOptions": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 1024,
            "items": {
              "$ref": "#/components/schemas/SnortRuleBodyOption"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The rule body parsed into options; absent when the body was not parsed."
          },
          "datePublished": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "RFC 3339, UTC, second precision."
          },
          "dateUpdated": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "RFC 3339, UTC, second precision."
          },
          "source": {
            "type": "string",
            "maxLength": 64,
            "description": "Where the rule came from (for example `emergingthreats`, `snort-registered`, `vulnetix`)."
          }
        }
      },
      "SnortRuleBodyOption": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "key"
        ],
        "description": "One parsed option of the rule body, in rule order.",
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 64,
            "description": "Option keyword (for example `content`, `pcre`, `flowbits`)."
          },
          "value": {
            "type": "string",
            "maxLength": 8192,
            "description": "Option argument; absent for a bare keyword such as `nocase`."
          }
        }
      },
      "SnortRuleSearchRow": {
        "type": "object",
        "additionalProperties": false,
        "description": "A Snort or Suricata rule found by the catalogue search. The search does not return `bodyOptions` or `dateUpdated`.",
        "required": [
          "uuid",
          "snortId",
          "rev",
          "action",
          "protocol",
          "srcIp",
          "srcPort",
          "direction",
          "dstIp",
          "dstPort",
          "msg",
          "disabled",
          "rawText",
          "source"
        ],
        "properties": {
          "uuid": {
            "$ref": "#/components/schemas/Uuid"
          },
          "snortId": {
            "type": "string",
            "maxLength": 32,
            "description": "Signature id (`sid`)."
          },
          "rev": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Rule revision."
          },
          "action": {
            "type": "string",
            "maxLength": 16
          },
          "protocol": {
            "type": "string",
            "maxLength": 16
          },
          "srcIp": {
            "type": "string",
            "maxLength": 256
          },
          "srcPort": {
            "type": "string",
            "maxLength": 256
          },
          "direction": {
            "type": "string",
            "maxLength": 4
          },
          "dstIp": {
            "type": "string",
            "maxLength": 256
          },
          "dstPort": {
            "type": "string",
            "maxLength": 256
          },
          "msg": {
            "type": "string",
            "maxLength": 1024
          },
          "flow": {
            "type": "string",
            "maxLength": 256
          },
          "classtype": {
            "type": "string",
            "maxLength": 128
          },
          "disabled": {
            "type": "boolean"
          },
          "confidence": {
            "type": "string",
            "maxLength": 64
          },
          "signatureSeverity": {
            "type": "string",
            "maxLength": 64
          },
          "affectedProducts": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 256
            }
          },
          "attackTargets": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 256
            }
          },
          "tags": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 256
            }
          },
          "mitreTechIds": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 32
            }
          },
          "mitreTacticIds": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 32
            }
          },
          "datePublished": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "RFC 3339, UTC, second precision."
          },
          "source": {
            "type": "string",
            "maxLength": 64
          },
          "rawText": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 65536,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The full rule text."
          }
        }
      },
      "SpdxDocument": {
        "type": "object",
        "description": "An SPDX 2.3 JSON document. Only `packages` is read; every other SPDX key (`spdxVersion`, `SPDXID`, `name`, `documentNamespace`, `creationInfo`, `relationships` and so on) is accepted and ignored.",
        "additionalProperties": true,
        "maxProperties": 64,
        "required": [
          "packages"
        ],
        "properties": {
          "packages": {
            "type": "array",
            "minItems": 1,
            "maxItems": 5000,
            "description": "More than 5000 packages is 400.",
            "items": {
              "type": "object",
              "description": "An SPDX package. Keys other than those listed are accepted and ignored.",
              "additionalProperties": true,
              "maxProperties": 64,
              "required": [
                "name"
              ],
              "properties": {
                "name": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/PackageName"
                    }
                  ],
                  "description": "Package name (required by SPDX; the handler does not check it). Recorded with the scanned package; matching uses the purl only."
                },
                "versionInfo": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Version"
                    }
                  ],
                  "description": "Package version."
                },
                "externalRefs": {
                  "type": "array",
                  "maxItems": 256,
                  "description": "The first entry with `referenceType` `purl` supplies the package's purl; other entries are ignored.",
                  "items": {
                    "type": "object",
                    "additionalProperties": true,
                    "maxProperties": 16,
                    "required": [
                      "referenceCategory",
                      "referenceType",
                      "referenceLocator"
                    ],
                    "properties": {
                      "referenceCategory": {
                        "type": "string",
                        "enum": [
                          "SECURITY",
                          "PACKAGE-MANAGER",
                          "PACKAGE_MANAGER",
                          "PERSISTENT-ID",
                          "PERSISTENT_ID",
                          "OTHER"
                        ],
                        "description": "Required by SPDX; not read by the handler."
                      },
                      "referenceType": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 64,
                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
                        "description": "Only `purl` is read."
                      },
                      "referenceLocator": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048,
                        "description": "A purl when `referenceType` is `purl`; for other types whatever the type defines (a CPE, a URL, a gitoid)."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "examples": [
          {
            "spdxVersion": "SPDX-2.3",
            "SPDXID": "SPDXRef-DOCUMENT",
            "name": "my-service",
            "packages": [
              {
                "name": "log4j-core",
                "versionInfo": "2.14.1",
                "externalRefs": [
                  {
                    "referenceCategory": "PACKAGE-MANAGER",
                    "referenceType": "purl",
                    "referenceLocator": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
                  }
                ]
              }
            ]
          }
        ]
      },
      "SummaryTopCwe": {
        "type": "object",
        "required": [
          "cweId",
          "count"
        ],
        "additionalProperties": false,
        "properties": {
          "cweId": {
            "type": "string",
            "maxLength": 64,
            "description": "CWE id as stored, for example `CWE-79`."
          },
          "count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Problem-type records with this CWE."
          }
        }
      },
      "SummaryTopVendor": {
        "type": "object",
        "required": [
          "vendor",
          "count"
        ],
        "additionalProperties": false,
        "properties": {
          "vendor": {
            "type": "string",
            "maxLength": 256
          },
          "count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Affected-product records for this vendor."
          }
        }
      },
      "SuseArchiveAdvisory": {
        "type": "object",
        "description": "One SUSE advisory in a month. Entries are ordered by `datePublished`, newest first, then by `advisoryId`.",
        "additionalProperties": false,
        "required": [
          "advisoryId",
          "kind",
          "datePublished",
          "cveAliases",
          "isExploited",
          "advisoryUrl",
          "risk",
          "products"
        ],
        "properties": {
          "advisoryId": {
            "type": "string",
            "maxLength": 256,
            "description": "The advisory id (or the CVE id for archives built from CVE records). Not unique within a month for SUSE, Canonical, Alpine and Google."
          },
          "kind": {
            "type": "string",
            "enum": [
              "sles",
              "opensuse",
              "rancher"
            ],
            "description": "Which SUSE advisory stream the entry belongs to."
          },
          "title": {
            "$ref": "#/components/schemas/VendorArchiveTitle"
          },
          "severity": {
            "$ref": "#/components/schemas/VendorArchiveSeverity"
          },
          "datePublished": {
            "$ref": "#/components/schemas/VendorArchiveDatePublished"
          },
          "dateUpdated": {
            "$ref": "#/components/schemas/VendorArchiveDateUpdated"
          },
          "cveAliases": {
            "$ref": "#/components/schemas/VendorArchiveCveAliases"
          },
          "isExploited": {
            "$ref": "#/components/schemas/VendorArchiveIsExploited"
          },
          "advisoryUrl": {
            "$ref": "#/components/schemas/VendorArchiveAdvisoryUrl"
          },
          "risk": {
            "$ref": "#/components/schemas/VendorArchiveRisk"
          },
          "products": {
            "$ref": "#/components/schemas/VendorArchiveProducts"
          }
        }
      },
      "Swid": {
        "type": "string",
        "description": "An ISO/IEC 19770-2 SoftwareIdentity tag, as XML or base64 of it. At most 64 KiB.",
        "minLength": 1,
        "maxLength": 65536
      },
      "Tei": {
        "type": "string",
        "description": "A Transparency Exchange Identifier, `urn:tei:<type>:<domain>:<id>`; a double-encoded `urn%3a...` is tolerated.",
        "minLength": 9,
        "maxLength": 512,
        "pattern": "^urn(?::|%3[Aa])tei(?::|%3[Aa])[!-~]{1,490}$",
        "examples": [
          "urn:tei:purl:vulnes.is:pkg:npm/lodash@4.17.20"
        ]
      },
      "TriageFeedItem": {
        "type": "object",
        "description": "One vulnerability in the feed. Keys without a value are absent.",
        "required": [
          "cveId",
          "source",
          "cvss",
          "epss",
          "cess"
        ],
        "additionalProperties": false,
        "properties": {
          "cveId": {
            "type": "string",
            "maxLength": 226
          },
          "source": {
            "type": "string",
            "maxLength": 64,
            "description": "The record source the row came from."
          },
          "title": {
            "type": "string",
            "maxLength": 4096
          },
          "datePublished": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35
          },
          "vendor": {
            "type": "string",
            "maxLength": 512
          },
          "product": {
            "type": "string",
            "maxLength": 512
          },
          "cvss": {
            "type": "object",
            "additionalProperties": false,
            "description": "The best CVSS metric.",
            "properties": {
              "vectorString": {
                "type": "string",
                "maxLength": 256
              },
              "baseScore": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 10
              },
              "severity": {
                "type": "string",
                "maxLength": 16
              }
            }
          },
          "epss": {
            "type": "object",
            "additionalProperties": false,
            "description": "The latest EPSS score.",
            "properties": {
              "score": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1
              },
              "percentile": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 1
              }
            }
          },
          "cess": {
            "type": "object",
            "additionalProperties": false,
            "description": "The latest CESS score.",
            "properties": {
              "score": {
                "type": "number",
                "format": "double",
                "minimum": 0,
                "maximum": 10
              }
            }
          },
          "kev": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "source"
            ],
            "description": "The latest KEV entry; absent when not known-exploited.",
            "properties": {
              "source": {
                "type": "string",
                "maxLength": 32
              },
              "dueDate": {
                "type": "string",
                "format": "date-time",
                "maxLength": 35
              },
              "knownRansomwareCampaignUse": {
                "type": "string",
                "maxLength": 32
              }
            }
          }
        }
      },
      "Uuid": {
        "type": "string",
        "format": "uuid",
        "minLength": 36,
        "maxLength": 36,
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "examples": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      },
      "VdbSourceMetadata": {
        "type": "object",
        "required": [
          "id",
          "displayName",
          "shortName"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 128,
            "description": "Canonical source id."
          },
          "displayName": {
            "type": "string",
            "maxLength": 256,
            "description": "Display name; the upper-cased id for an uncurated source."
          },
          "shortName": {
            "type": "string",
            "maxLength": 128,
            "description": "Short name; the upper-cased id for an uncurated source."
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "Description; the id itself for an uncurated source. Left out only when empty."
          }
        }
      },
      "VendorArchiveAdvisoryUrl": {
        "type": "string",
        "maxLength": 2048,
        "description": "Link to the advisory: the source's own reference when recorded, else a URL built from the id."
      },
      "VendorArchiveBuiltAt": {
        "type": "integer",
        "format": "int64",
        "minimum": 0,
        "maximum": 32503680000,
        "description": "Server time the answer was built, Unix seconds (a cached answer keeps its original time)."
      },
      "VendorArchiveCveAliases": {
        "type": "array",
        "maxItems": 1000,
        "items": {
          "type": "string",
          "maxLength": 256
        },
        "description": "Ids the advisory covers, normally CVE ids (a Bitnami entry can also list other alias ids, such as GHSA ids); may be empty."
      },
      "VendorArchiveDatePublished": {
        "type": "integer",
        "format": "int64",
        "minimum": 0,
        "maximum": 32503680000000,
        "description": "Publication time, Unix epoch milliseconds."
      },
      "VendorArchiveDateUpdated": {
        "type": "integer",
        "format": "int64",
        "minimum": 0,
        "maximum": 32503680000000,
        "description": "Last update time, Unix epoch milliseconds. Omitted when none is recorded."
      },
      "VendorArchiveIndex": {
        "type": "object",
        "description": "Every month of a vendor archive, newest first.",
        "additionalProperties": false,
        "required": [
          "timestamp",
          "total",
          "generatedAt",
          "archives"
        ],
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "When the snapshot was built, Unix seconds (same as `generatedAt`; not the response time)."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1200,
            "description": "Months in `archives`."
          },
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "When the snapshot was built, Unix seconds."
          },
          "archives": {
            "type": "array",
            "maxItems": 1200,
            "items": {
              "$ref": "#/components/schemas/VendorArchivePeriodSummary"
            }
          }
        }
      },
      "VendorArchiveIsExploited": {
        "type": "boolean",
        "description": "True when a linked CVE is in CISA KEV, ENISA EUVD KEV or VulnCheck KEV (Vulnesis KEV is reported separately in `risk.kevVulnetix`)."
      },
      "VendorArchiveNotFound": {
        "type": "object",
        "description": "No advisories for the month (`error`, `month`), or the organisation was not found (`success: false`, `error`).",
        "additionalProperties": false,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 256
          },
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "VendorArchivePeriodSummary": {
        "type": "object",
        "description": "Counts for one month of a vendor archive, from the daily snapshot.",
        "additionalProperties": false,
        "required": [
          "month",
          "title",
          "advisoryCount",
          "cveCount",
          "exploitedCount",
          "sourceBreakdown",
          "latestDate"
        ],
        "properties": {
          "month": {
            "$ref": "#/components/schemas/YearMonth"
          },
          "title": {
            "type": "string",
            "maxLength": 64,
            "description": "`<Month YYYY>`, for example `March 2024`."
          },
          "advisoryCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct advisories (advisory id and source) in the month."
          },
          "cveCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Distinct CVEs the month's advisories cover."
          },
          "exploitedCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Advisories with a CVE in CISA/ENISA KEV or VulnCheck KEV."
          },
          "sourceBreakdown": {
            "type": "object",
            "description": "Advisories per stream (`kind`). Streams with none are absent; may be empty.",
            "maxProperties": 16,
            "additionalProperties": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 1000000
            }
          },
          "latestDate": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000000,
            "description": "Publication time of the month's newest advisory, Unix epoch milliseconds."
          }
        }
      },
      "VendorArchiveProduct": {
        "type": "object",
        "description": "One affected product recorded for an advisory.",
        "additionalProperties": false,
        "required": [
          "productName",
          "status"
        ],
        "properties": {
          "productName": {
            "type": "string",
            "maxLength": 1024,
            "description": "Product name, or the package name when no product is recorded."
          },
          "status": {
            "type": "string",
            "maxLength": 64,
            "description": "The record's default status (for example `affected`, `unaffected`, `fixed`); `affected` when none is recorded (Red Hat and Broadcom always record one)."
          },
          "vendor": {
            "type": "string",
            "maxLength": 256,
            "description": "Vendor name. Omitted when none is recorded."
          },
          "packageName": {
            "type": "string",
            "maxLength": 1024,
            "description": "Package name. Omitted when none is recorded."
          }
        }
      },
      "VendorArchiveProducts": {
        "type": "array",
        "maxItems": 5000,
        "items": {
          "$ref": "#/components/schemas/VendorArchiveProduct"
        },
        "description": "Affected products recorded for the advisory; may be empty."
      },
      "VendorArchiveRisk": {
        "type": "object",
        "description": "Ranking signals for one advisory, folded over every CVE it covers (numbers: highest; flags: any; maturity: strongest). Flags, counts and the maturity are omitted when false, zero or empty; scores are omitted when unknown. Every month-route advisory carries this block. `kevCisa` is set by any KEV-table row whose source is not ENISA.",
        "additionalProperties": false,
        "required": [
          "cves"
        ],
        "properties": {
          "cves": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "CVE ids backing the advisory, directly or through aliases; may be empty (then no scores)."
          },
          "vendorCvss": {
            "type": "number",
            "minimum": 0,
            "maximum": 10,
            "description": "Highest CVSS base score the vendor itself published."
          },
          "cvss": {
            "type": "number",
            "minimum": 0,
            "maximum": 10,
            "description": "Highest CVSS base score from any source."
          },
          "cvssSource": {
            "type": "string",
            "maxLength": 64,
            "description": "Source of `cvss`."
          },
          "epss": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Highest latest EPSS probability among the CVEs."
          },
          "epssPercentile": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Percentile paired with `epss` (same CVE)."
          },
          "cess": {
            "type": "number",
            "minimum": 0,
            "maximum": 10,
            "description": "Highest latest CESS score among the CVEs, 0 to 10."
          },
          "kevCisa": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "A CVE is in the CISA KEV catalogue."
          },
          "kevEnisa": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "A CVE is in the ENISA EUVD KEV catalogue."
          },
          "kevVulnetix": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "A CVE is in the Vulnesis KEV catalogue."
          },
          "kevVulncheck": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "A CVE is in VulnCheck KEV."
          },
          "exploitMaturity": {
            "type": "string",
            "enum": [
              "weaponized",
              "active",
              "poc"
            ],
            "description": "Strongest exploit maturity across the CVEs' exploit artefacts."
          },
          "exploitCount": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000,
            "description": "Distinct exploit artefacts, summed over the CVEs."
          },
          "malicious": {
            "type": "boolean",
            "enum": [
              true
            ],
            "description": "A CVE is a malicious-package record."
          }
        }
      },
      "VendorArchiveSeverity": {
        "type": "string",
        "maxLength": 32,
        "description": "The source's own severity rating as recorded (for example `HIGH`, `Important`). Omitted when none is recorded."
      },
      "VendorArchiveSeverityCounts": {
        "type": "object",
        "description": "Distinct CVEs per normalised severity across every scoring source. Only buckets with CVEs are present; a CVE rated differently by two sources counts in both, so the sum can exceed `cveCount`.",
        "maxProperties": 5,
        "properties": {
          "Critical": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000
          },
          "High": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000
          },
          "Medium": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000
          },
          "Low": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000
          },
          "Unrated": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 1000000
          }
        },
        "additionalProperties": false
      },
      "VendorArchiveTitle": {
        "type": "string",
        "maxLength": 2048,
        "description": "Advisory title. Omitted when none is recorded."
      },
      "VendorArchiveUnavailable": {
        "type": "object",
        "description": "The vendor archive snapshot is not built yet (`error`, `vendor`), or the authentication backend did not answer (`success: false`, `error`).",
        "additionalProperties": false,
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "maxLength": 256
          },
          "vendor": {
            "type": "string",
            "enum": [
              "redhat",
              "broadcom",
              "aws",
              "cisco",
              "alibaba",
              "cloudflare",
              "suse",
              "canonical",
              "alpine",
              "apple",
              "google"
            ]
          },
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "VendorName": {
        "type": "string",
        "description": "A vendor as CVE records and CPEs name it. Matching is case- and decoration-insensitive.",
        "minLength": 1,
        "maxLength": 512,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9 ._:@+#,&/-]{0,511}$",
        "examples": [
          "apache"
        ]
      },
      "VendorTrendPeriod": {
        "type": "object",
        "required": [
          "period",
          "totals",
          "topVendors"
        ],
        "additionalProperties": false,
        "description": "One month or year of vendor activity, split by identifier prefix.",
        "properties": {
          "period": {
            "type": "string",
            "pattern": "^[0-9]{4}(-[0-9]{2})?$",
            "maxLength": 7,
            "description": "`YYYY-MM` in the monthly series, `YYYY` in the yearly series."
          },
          "totals": {
            "type": "object",
            "required": [
              "cve",
              "ghsa",
              "other",
              "total"
            ],
            "additionalProperties": false,
            "description": "Distinct identifiers published in the period, by prefix.",
            "properties": {
              "cve": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "`CVE-` identifiers."
              },
              "ghsa": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "`GHSA-` identifiers."
              },
              "other": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Identifiers with neither prefix."
              },
              "total": {
                "type": "integer",
                "format": "int64",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Sum of the three."
              }
            }
          },
          "topVendors": {
            "type": "array",
            "maxItems": 50,
            "description": "The 50 vendors with the most identifiers in the period, descending, then by name.",
            "items": {
              "type": "object",
              "required": [
                "vendor",
                "count",
                "cve",
                "ghsa",
                "other"
              ],
              "additionalProperties": false,
              "properties": {
                "vendor": {
                  "type": "string",
                  "maxLength": 256
                },
                "count": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Distinct identifiers affecting this vendor in the period."
                },
                "cve": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Of which `CVE-`."
                },
                "ghsa": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Of which `GHSA-`."
                },
                "other": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Of which other prefixes."
                }
              }
            }
          }
        }
      },
      "Version": {
        "type": "string",
        "description": "A package or product version, including a Debian or RPM epoch (`1:2.3.4-1`) or a PEP 440 epoch (`1!2.0`). `*` and `-` mean no version.",
        "minLength": 1,
        "maxLength": 128,
        "pattern": "^(?:[*-]|[A-Za-z0-9][A-Za-z0-9._+~:!-]{0,127})$",
        "examples": [
          "4.17.20",
          "1:2.3.4-1ubuntu1"
        ]
      },
      "VexStatement": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "uuid",
          "openVexUuid",
          "timestamp",
          "vulnerabilityId",
          "vulnerabilityName",
          "status"
        ],
        "description": "One statement from a VEX document the caller's organisation uploaded. Empty optional fields are absent.",
        "properties": {
          "uuid": {
            "$ref": "#/components/schemas/Uuid"
          },
          "openVexUuid": {
            "$ref": "#/components/schemas/Uuid"
          },
          "statementId": {
            "type": "string",
            "maxLength": 1024
          },
          "statementVersion": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "Statement timestamp, RFC 3339 UTC."
          },
          "lastUpdated": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "RFC 3339, UTC, second precision."
          },
          "vulnerabilityId": {
            "type": "string",
            "maxLength": 226
          },
          "vulnerabilityName": {
            "type": "string",
            "maxLength": 1024
          },
          "vulnerabilityDescription": {
            "type": "string",
            "maxLength": 65536
          },
          "products": {
            "type": [
              "array",
              "object",
              "string"
            ],
            "maxItems": 10000,
            "maxProperties": 1000,
            "maxLength": 1048576,
            "description": "The statement's products as stored: normally the OpenVEX `products` array, parsed; the raw text when it does not parse as JSON; absent when empty."
          },
          "status": {
            "type": "string",
            "maxLength": 32,
            "description": "VEX status as uploaded (`not_affected`, `affected`, `fixed`, `under_investigation`)."
          },
          "supplier": {
            "type": "string",
            "maxLength": 512
          },
          "statusNotes": {
            "type": "string",
            "maxLength": 8192
          },
          "justification": {
            "type": "string",
            "maxLength": 128
          },
          "impactStatement": {
            "type": "string",
            "maxLength": 8192
          },
          "actionStatement": {
            "type": "string",
            "maxLength": 8192
          }
        }
      },
      "VirtualPatchKind": {
        "type": "string",
        "enum": [
          "SNORT",
          "SURICATA",
          "MODSECURITY",
          "NGINX",
          "AWS_WAF",
          "CLOUDFLARE_WAF",
          "REGEX_L7"
        ],
        "description": "The output format of a virtual patch."
      },
      "VirtualPatchKindList": {
        "type": "string",
        "maxLength": 256,
        "pattern": "^(?:SNORT|SURICATA|MODSECURITY|NGINX|AWS_WAF|CLOUDFLARE_WAF|REGEX_L7|snort|suricata|modsecurity|nginx|aws_waf|cloudflare_waf|regex_l7)(?:, ?(?:SNORT|SURICATA|MODSECURITY|NGINX|AWS_WAF|CLOUDFLARE_WAF|REGEX_L7|snort|suricata|modsecurity|nginx|aws_waf|cloudflare_waf|regex_l7)){0,15}$",
        "description": "One kind, or several separated by commas. Matched case-insensitively; upper and lower case are both accepted here."
      },
      "VirtualPatchRecord": {
        "type": "object",
        "description": "One virtual patch. Optional keys are left out when the record has no value for them.",
        "additionalProperties": false,
        "required": [
          "uuid",
          "artifactId",
          "kind",
          "title",
          "rawText",
          "exploitUuid",
          "archiveUrl",
          "consoleUrl",
          "createdAt"
        ],
        "properties": {
          "uuid": {
            "type": "string",
            "maxLength": 64,
            "description": "The defence's id; use it with the archive route."
          },
          "artifactId": {
            "type": "string",
            "maxLength": 256,
            "description": "Deterministic natural key, `vulnetix-vp-<exploitUuid>-<kind>` or `vulnetix-cm-<exploitUuid>-<kind>`."
          },
          "kind": {
            "$ref": "#/components/schemas/VirtualPatchKind"
          },
          "title": {
            "type": "string",
            "maxLength": 1024
          },
          "description": {
            "type": "string",
            "maxLength": 65536
          },
          "confidence": {
            "type": "string",
            "maxLength": 16,
            "description": "HIGH, MEDIUM or LOW."
          },
          "deployMode": {
            "type": "string",
            "maxLength": 16,
            "description": "The mode this artifact is safe to start in (`log` or `block`). A recommendation about the artifact, never a record of what was deployed."
          },
          "falsePositiveRisk": {
            "type": "string",
            "maxLength": 16,
            "description": "HIGH, MEDIUM or LOW."
          },
          "coverageNotes": {
            "type": "string",
            "maxLength": 65536,
            "description": "What the rule catches and, explicitly, what it does not."
          },
          "mitreTechIds": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 32
            },
            "description": "MITRE ATT&CK technique ids."
          },
          "rawText": {
            "type": "string",
            "maxLength": 1048576,
            "description": "The rule body, verbatim. The whole list this record sits in is null below Pro, so a record that is present always carries its body."
          },
          "bodyContentHash": {
            "type": "string",
            "maxLength": 128,
            "description": "sha256 of the body, hex."
          },
          "fileSize": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 1073741824,
            "description": "Body size in bytes."
          },
          "exploitUuid": {
            "type": "string",
            "maxLength": 64,
            "description": "The ingested PoC exploit this defence was derived from."
          },
          "exploitId": {
            "type": "string",
            "maxLength": 256
          },
          "exploitSource": {
            "type": "string",
            "maxLength": 64,
            "description": "Source slug of the originating exploit, for example `exploit-db` or `github-poc`."
          },
          "exploitUrl": {
            "type": "string",
            "maxLength": 2048
          },
          "matchedCve": {
            "type": "string",
            "maxLength": 226,
            "description": "The lowest advisory id, among those the inputs resolved to, that this defence is linked to. Absent without inputs, and for a defence reached only through the software its exploit names."
          },
          "archiveUrl": {
            "type": "string",
            "maxLength": 128,
            "description": "Path to the rule body served as its own file: `/v2/virtual-patches/{uuid}/archive`."
          },
          "consoleUrl": {
            "type": "string",
            "format": "uri",
            "maxLength": 256,
            "description": "Opens the defence in the console: `https://www.vulnes.is/resolve/virtual-patching?dc=<uuid>#catalogue`."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "maxLength": 32
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "maxLength": 32
          }
        }
      },
      "VulnAffectedEntry": {
        "type": "object",
        "required": [
          "vendor",
          "product",
          "packageName",
          "ecosystem",
          "purl",
          "cloudLocators",
          "versions"
        ],
        "additionalProperties": false,
        "properties": {
          "vendor": {
            "type": "string",
            "maxLength": 512,
            "description": "As the source names it; filled from CISA KEV when the source has none."
          },
          "product": {
            "type": "string",
            "maxLength": 512
          },
          "packageName": {
            "type": "string",
            "maxLength": 512,
            "description": "The package name, else the product."
          },
          "collectionURL": {
            "type": "string",
            "maxLength": 2048
          },
          "ecosystem": {
            "type": "string",
            "maxLength": 64,
            "description": "Derived from `collectionURL` (`npm`, `pypi`, `maven` and the rest, `unknown` when there is none); `microsoft`, `kev` and `cloud` for the rows built from MSRC, CISA KEV and the title when the source lists nothing."
          },
          "purl": {
            "type": "string",
            "maxLength": 4096
          },
          "generatedCpe": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1024,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). A CPE 2.3 built from vendor and product when the source gives none; absent when the source gives one."
          },
          "cloudLocators": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CloudLocatorResult"
              }
            ],
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature full-enrichment). Cloud resource identifier templates for the product; null when there is no cloud mapping."
          },
          "defaultStatus": {
            "type": "string",
            "maxLength": 32
          },
          "repo": {
            "type": "string",
            "maxLength": 2048
          },
          "platforms": {
            "description": "The source's platforms list as stored."
          },
          "cpes": {
            "description": "The CPEs the source record lists, deduplicated. Never includes the generated CPE; see `generatedCpe`."
          },
          "modules": {
            "description": "As stored."
          },
          "programFiles": {
            "description": "As stored."
          },
          "programRoutines": {
            "description": "As stored."
          },
          "source": {
            "type": "string",
            "maxLength": 64
          },
          "derivedBy": {
            "type": "string",
            "maxLength": 64
          },
          "versions": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10000,
            "items": {
              "$ref": "#/components/schemas/VulnAffectedVersion"
            },
            "description": "Version ranges, de-duplicated. Null when the source lists none, and on the MSRC, KEV and title-derived rows."
          },
          "versionRange": {
            "type": "string",
            "maxLength": 8192,
            "description": "The affected ranges as one range string."
          },
          "unaffectedVersions": {
            "type": "string",
            "maxLength": 8192,
            "description": "The unaffected ranges as one range string."
          },
          "versionRanges": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 1024
            }
          }
        }
      },
      "VulnAffectedVersion": {
        "type": "object",
        "required": [
          "version",
          "status",
          "lessThan",
          "lessThanOrEqual"
        ],
        "additionalProperties": false,
        "properties": {
          "version": {
            "type": "string",
            "maxLength": 256
          },
          "status": {
            "type": "string",
            "maxLength": 32,
            "description": "`affected`, `unaffected` or `unknown` as the source wrote it."
          },
          "versionType": {
            "type": "string",
            "maxLength": 64
          },
          "lessThan": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "lessThanOrEqual": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256
          },
          "changes": {
            "description": "The CVE JSON 5 `changes` list as stored."
          }
        }
      },
      "VulnCheckKevEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "kevId"
        ],
        "properties": {
          "kevId": {
            "type": "string",
            "maxLength": 64
          },
          "reportedExploitations": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "maxLength": 2048
                },
                "dateAdded": {
                  "type": "integer",
                  "format": "int64",
                  "minimum": 0,
                  "maximum": 32503680000000,
                  "description": "Unix milliseconds. Absent when unknown."
                }
              }
            },
            "description": "Absent when none."
          },
          "xdbEntries": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "xdbId",
                "xdbUrl"
              ],
              "properties": {
                "xdbId": {
                  "type": "string",
                  "maxLength": 128
                },
                "xdbUrl": {
                  "type": "string",
                  "maxLength": 2048
                },
                "exploitType": {
                  "type": "string",
                  "maxLength": 64,
                  "description": "Absent when unknown."
                }
              }
            },
            "description": "Absent when none."
          }
        }
      },
      "VulnCheckReportedEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "dateAdded": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35,
            "description": "Absent when unknown."
          }
        }
      },
      "VulnCheckXDBEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "xdbId",
          "exploitType"
        ],
        "properties": {
          "xdbId": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 128
          },
          "exploitType": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 64
          },
          "dateAdded": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35,
            "description": "Absent when unknown."
          }
        }
      },
      "VulnId": {
        "type": "string",
        "description": "An advisory id of any family: CVE, GHSA, CNVD, OSV, PYSEC, RUSTSEC, GO, DSA, EUVD and the rest. Case-insensitive; aliases are followed both ways.",
        "minLength": 3,
        "maxLength": 226,
        "pattern": "^[A-Za-z][A-Za-z0-9.]{0,23}[-:/_][A-Za-z0-9][A-Za-z0-9._:/-]{0,200}$",
        "examples": [
          "CVE-2021-44228",
          "GHSA-jfh8-c2jp-5v3q",
          "PYSEC-2021-19"
        ]
      },
      "VulnIdList": {
        "type": "string",
        "description": "One advisory id, or up to 100 separated by commas.",
        "minLength": 3,
        "maxLength": 22700,
        "pattern": "^[A-Za-z][A-Za-z0-9.]{0,23}[-:/_][A-Za-z0-9][A-Za-z0-9._:/-]{0,200}(?:,[A-Za-z][A-Za-z0-9.]{0,23}[-:/_][A-Za-z0-9][A-Za-z0-9._:/-]{0,200})*$",
        "examples": [
          "CVE-2021-44228",
          "CVE-2021-44228,GHSA-jfh8-c2jp-5v3q"
        ]
      },
      "VulnIdentifier": {
        "type": "string",
        "description": "A vulnerability, named by advisory id, or in its place a URL-encoded purl, CPE, TEI or base64 SWID tag. Named by anything other than an advisory id, the operation answers once per resolved vulnerability under `results` (at most 50, known-exploited first).",
        "minLength": 3,
        "maxLength": 4096,
        "pattern": "^(?:[A-Za-z][A-Za-z0-9.]{0,23}[-:/_][A-Za-z0-9][A-Za-z0-9._:/-]{0,200}|pkg:[A-Za-z][A-Za-z0-9.+-]{0,31}/[!-~]+|cpe:(?:2\\.3:|/)[!-~]+|urn:tei:[!-~]+|[A-Za-z0-9+/]{16,}={0,2})$",
        "examples": [
          "CVE-2021-44228",
          "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1",
          "cpe:2.3:a:apache:log4j:2.14.1:*:*:*:*:*:*:*"
        ]
      },
      "VulnKevEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "source",
          "vendorProject",
          "product",
          "vulnerabilityName",
          "requiredAction",
          "dateAdded",
          "dueDate",
          "overdue",
          "daysUntilDue",
          "knownRansomwareCampaignUse",
          "notes"
        ],
        "properties": {
          "source": {
            "type": "string",
            "maxLength": 32,
            "description": "The catalogue: `CISA`, `enisa` or `vulnetix`."
          },
          "vendorProject": {
            "type": "string",
            "maxLength": 512
          },
          "product": {
            "type": "string",
            "maxLength": 512
          },
          "vulnerabilityName": {
            "type": "string",
            "maxLength": 1024
          },
          "requiredAction": {
            "type": "string",
            "maxLength": 2048
          },
          "dateAdded": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35
          },
          "dueDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "maxLength": 35,
            "description": "Null when the catalogue set no deadline."
          },
          "overdue": {
            "type": "boolean"
          },
          "daysUntilDue": {
            "type": "integer",
            "format": "int32",
            "minimum": -2147483648,
            "maximum": 2147483647,
            "description": "0 when there is no due date."
          },
          "knownRansomwareCampaignUse": {
            "type": "string",
            "maxLength": 32
          },
          "cwes": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "string",
              "maxLength": 32
            },
            "description": "Absent when none."
          },
          "notes": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 65536
          }
        }
      },
      "VulnKevExploitationSignals": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "inCisaKev",
          "inVulnCheckKev",
          "crowdSecActive",
          "totalExploitSources",
          "summary"
        ],
        "properties": {
          "inCisaKev": {
            "type": "boolean",
            "description": "True when `entries` is not empty (any of the CISA, ENISA and Vulnesis catalogues)."
          },
          "inVulnCheckKev": {
            "type": "boolean"
          },
          "crowdSecActive": {
            "type": "boolean",
            "description": "`crowdSecSummary.isActive`; always false today (see `CrowdSecSummary.isActive`)."
          },
          "totalExploitSources": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 3,
            "description": "How many of `inCisaKev`, `inVulnCheckKev` and `crowdSecActive` are true."
          },
          "summary": {
            "type": "string",
            "maxLength": 256
          }
        }
      },
      "VulnNotFoundBody": {
        "type": "object",
        "description": "No record of the vulnerability.",
        "required": [
          "error",
          "identifier"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "maxLength": 256
          },
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The id looked up, normalised and alias-resolved."
          }
        }
      },
      "VulnRecordsFanout": {
        "type": "object",
        "description": "The answer to GET /vuln/{identifier} when the identifier is a purl, CPE, TEI or SWID tag: the route run once per resolved vulnerability (at most 50, known-exploited first), each run's CVE JSON 5 records under `results[].records`.",
        "required": [
          "identifier",
          "resolved",
          "count",
          "total",
          "hasMore",
          "results"
        ],
        "additionalProperties": false,
        "properties": {
          "identifier": {
            "type": "string",
            "maxLength": 4096,
            "description": "The identifier as given."
          },
          "resolved": {
            "$ref": "#/components/schemas/ResolvedInputs"
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 50,
            "description": "Results in this answer."
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Vulnerabilities the identifier resolved to, before the cap of 50. Unbounded: a product or CPE can resolve to thousands."
          },
          "hasMore": {
            "type": "boolean",
            "description": "More vulnerabilities resolved than the 50 answered."
          },
          "results": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/VulnRecordsFanoutResult"
            }
          },
          "skipped": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 226
            },
            "description": "Resolved ids whose family this route does not take."
          },
          "_pro_data": {
            "$ref": "#/components/schemas/ProDataPaths"
          },
          "_entitlements": {
            "$ref": "#/components/schemas/Entitlements"
          }
        }
      },
      "VulnRecordsFanoutResult": {
        "type": "object",
        "description": "One vulnerability's run. A 200 run carries `records`; any other carries `status` and that run's error body.",
        "required": [
          "vulnId"
        ],
        "additionalProperties": false,
        "properties": {
          "vulnId": {
            "$ref": "#/components/schemas/VulnId"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "minimum": 100,
            "maximum": 599,
            "description": "The run's HTTP status, when it was not 200."
          },
          "records": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "$ref": "#/components/schemas/CVEListV5Record"
            },
            "description": "The run's answer: one CVE JSON 5 record per source."
          },
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "maxLength": 2048
          },
          "details": {
            "type": "string",
            "maxLength": 2048
          },
          "identifier": {
            "type": "string",
            "maxLength": 4096
          }
        }
      },
      "VulnSearchErrorBody": {
        "type": "object",
        "description": "Search could not answer. This is not a statement that nothing matches.",
        "required": [
          "success",
          "error",
          "query",
          "warnings"
        ],
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "maxLength": 512
          },
          "query": {
            "type": "string",
            "maxLength": 120
          },
          "warnings": {
            "type": "array",
            "maxItems": 8,
            "items": {
              "type": "string",
              "maxLength": 256
            }
          }
        }
      },
      "VulnSearchResponse": {
        "type": "object",
        "required": [
          "query",
          "timestamp",
          "limit",
          "offset",
          "hasMore",
          "warnings",
          "data",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 120,
            "minLength": 3,
            "description": "The query, trimmed."
          },
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Unix seconds."
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 50
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 1000
          },
          "hasMore": {
            "type": "boolean"
          },
          "warnings": {
            "type": "array",
            "maxItems": 8,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Indexes that failed or ran out of time, a skipped description search, or a capped result window. A non-empty list means the page may be incomplete."
          },
          "data": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/VulnSearchResult"
            }
          },
          "_links": {
            "type": "array",
            "maxItems": 2,
            "items": {
              "$ref": "#/components/schemas/APILink"
            }
          }
        }
      },
      "VulnSearchResult": {
        "type": "object",
        "required": [
          "cveId",
          "title",
          "titles",
          "matchFields",
          "score",
          "sources",
          "aliases",
          "_links"
        ],
        "additionalProperties": false,
        "properties": {
          "cveId": {
            "type": "string",
            "maxLength": 226,
            "description": "The matched advisory id (any family)."
          },
          "title": {
            "type": "string",
            "maxLength": 4096,
            "description": "The first non-empty title, else the description cut to 140 characters, else the matched text, else the id."
          },
          "titles": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "$ref": "#/components/schemas/VulnSearchTitle"
            }
          },
          "description": {
            "type": "string",
            "maxLength": 1048576,
            "description": "One description, in `lang` when there is one, else English. Absent when there is none."
          },
          "matchFields": {
            "type": "array",
            "maxItems": 4,
            "items": {
              "type": "string",
              "enum": [
                "alias",
                "description",
                "identifier",
                "title"
              ]
            },
            "description": "Which indexes matched, sorted."
          },
          "matchExcerpt": {
            "type": "string",
            "maxLength": 4096,
            "description": "The matched text. Absent when empty."
          },
          "score": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Rank: 100 for an id match, 96 for an alias, 80-100 for a title and 45-65 for a description by trigram similarity."
          },
          "sources": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "string",
              "maxLength": 64
            }
          },
          "state": {
            "type": "string",
            "maxLength": 32
          },
          "datePublished": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Latest publication time across sources, Unix seconds."
          },
          "dateUpdated": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 4102444800,
            "description": "Latest update time across sources, Unix seconds."
          },
          "aliases": {
            "type": "array",
            "maxItems": 1000,
            "items": {
              "type": "string",
              "maxLength": 226
            }
          },
          "_links": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/APILink"
            },
            "description": "Links to the other answers about this vulnerability."
          }
        }
      },
      "VulnSearchTitle": {
        "type": "object",
        "required": [
          "lang",
          "value"
        ],
        "additionalProperties": false,
        "properties": {
          "lang": {
            "type": "string",
            "enum": [
              "en"
            ]
          },
          "value": {
            "type": "string",
            "maxLength": 4096
          },
          "source": {
            "type": "string",
            "maxLength": 64,
            "description": "The source whose title this is."
          }
        }
      },
      "VulnSightingEvent": {
        "type": "object",
        "description": "One observation on the timeline. Lane-specific keys are absent when they do not apply.",
        "required": [
          "lane",
          "at"
        ],
        "additionalProperties": false,
        "properties": {
          "lane": {
            "type": "string",
            "enum": [
              "shadowserver",
              "vulncheck-reported",
              "ai-in-wild"
            ]
          },
          "at": {
            "type": "string",
            "format": "date-time",
            "maxLength": 35
          },
          "count": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "maximum": 1E+12,
            "description": "shadowserver: hosts that day."
          },
          "source": {
            "type": "string",
            "maxLength": 256,
            "description": "shadowserver: `<statistic>:<hostType>`; vulncheck-reported: `vulncheck`; ai-in-wild: the source label."
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "observedBy": {
            "type": "string",
            "maxLength": 256
          },
          "timeToExploit": {
            "type": "string",
            "maxLength": 64
          }
        }
      },
      "VulnTimelineEvent": {
        "type": "object",
        "required": [
          "time",
          "type",
          "label",
          "icon",
          "color",
          "sourceRef"
        ],
        "additionalProperties": false,
        "properties": {
          "time": {
            "type": "integer",
            "format": "int64",
            "minimum": -62135596800000,
            "maximum": 4102444800000,
            "description": "Unix milliseconds. An event whose source gave no date reads -62135596800000 (Go's zero time)."
          },
          "type": {
            "type": "string",
            "enum": [
              "source",
              "exploit",
              "score-change",
              "patch",
              "advisory",
              "scorecard"
            ]
          },
          "label": {
            "type": "string",
            "maxLength": 1024
          },
          "description": {
            "type": "string",
            "maxLength": 8192
          },
          "icon": {
            "type": "string",
            "maxLength": 64,
            "description": "A Material Design icon name (`mdi-...`)."
          },
          "color": {
            "type": "string",
            "maxLength": 32,
            "description": "A colour name or hex value for display."
          },
          "sourceRef": {
            "type": "string",
            "maxLength": 4096,
            "description": "Where the event came from: a source name or URL."
          },
          "exploitType": {
            "type": "string",
            "maxLength": 64
          },
          "kevCisa": {
            "type": "boolean"
          },
          "kevVulncheck": {
            "type": "boolean"
          },
          "xdbId": {
            "type": "string",
            "maxLength": 128
          },
          "exploitDbId": {
            "type": "string",
            "maxLength": 64
          },
          "exploitDbAuthor": {
            "type": "string",
            "maxLength": 512
          },
          "exploitDbPlatform": {
            "type": "string",
            "maxLength": 128
          },
          "exploitDbType": {
            "type": "string",
            "maxLength": 128
          },
          "exploitDbVerified": {
            "type": "boolean"
          },
          "repository": {
            "type": "string",
            "maxLength": 2048
          },
          "cvssScore": {
            "type": "string",
            "maxLength": 16
          },
          "epssScore": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "epssPercentile": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "cessScore": {
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "scorecardScore": {
            "type": "number",
            "minimum": -1,
            "maximum": 10
          },
          "scorecardCommit": {
            "type": "string",
            "maxLength": 64
          },
          "scorecardRepo": {
            "type": "string",
            "maxLength": 2048
          },
          "fixedVersion": {
            "type": "string",
            "maxLength": 256
          },
          "prUrl": {
            "type": "string",
            "maxLength": 4096
          },
          "commitSha": {
            "type": "string",
            "maxLength": 64
          },
          "advisoryUrl": {
            "type": "string",
            "maxLength": 4096
          },
          "advisoryTitle": {
            "type": "string",
            "maxLength": 4096
          }
        }
      },
      "VulnetixKevItem": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "cveId",
          "source",
          "vendorProject",
          "product",
          "vulnerabilityName",
          "shortDescription",
          "requiredAction",
          "dateAdded",
          "dueDate",
          "overdue",
          "daysUntilDue",
          "knownRansomwareCampaignUse",
          "reasons",
          "lastEvaluatedAt"
        ],
        "properties": {
          "cveId": {
            "type": "string",
            "maxLength": 226
          },
          "source": {
            "type": "string",
            "enum": [
              "vulnetix",
              "cisa",
              "enisa"
            ],
            "description": "The catalogue: `vulnetix`, or `cisa`/`enisa` for rows added by `include`."
          },
          "vendorProject": {
            "type": "string",
            "maxLength": 512
          },
          "product": {
            "type": "string",
            "maxLength": 512
          },
          "vulnerabilityName": {
            "type": "string",
            "maxLength": 1024
          },
          "shortDescription": {
            "type": "string",
            "maxLength": 65536,
            "description": "Empty when not recorded."
          },
          "requiredAction": {
            "type": "string",
            "maxLength": 2048
          },
          "dateAdded": {
            "type": "string",
            "format": "date",
            "maxLength": 10
          },
          "dueDate": {
            "type": "string",
            "maxLength": 10,
            "pattern": "^([0-9]{4}-[0-9]{2}-[0-9]{2})?$",
            "description": "`YYYY-MM-DD`, or empty for an authority row with no deadline."
          },
          "overdue": {
            "type": "boolean"
          },
          "daysUntilDue": {
            "type": "integer",
            "format": "int32",
            "minimum": -2147483648,
            "maximum": 2147483647,
            "description": "Whole days to the due date, negative when past; 0 when there is no due date."
          },
          "knownRansomwareCampaignUse": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 32
          },
          "reasons": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "type": "string",
              "enum": [
                "crowdsec_sighting",
                "misp_sighting",
                "shadowserver_sighting",
                "shadowserver_surge",
                "multi_source_sighting",
                "snort_rule",
                "nuclei_template",
                "metasploit_module",
                "nse_script",
                "yara_rule",
                "exploitdb_verified",
                "known_ransomware",
                "vendor_exploited",
                "zero_day_itw",
                "reported_itw",
                "demonstrated_exploit",
                "critical_cvss"
              ]
            },
            "description": "Evidence labels from the Vulnesis analysis. Empty on `cisa` and `enisa` rows."
          },
          "lastEvaluatedAt": {
            "type": "string",
            "maxLength": 35,
            "description": "RFC 3339 time of the last evaluation; empty on `cisa` and `enisa` rows."
          },
          "references": {
            "$ref": "#/components/schemas/VulnetixKevRefSets",
            "description": "Present with `include-references=1` when the CVE has references."
          }
        },
        "description": "One catalogue entry."
      },
      "VulnetixKevRefSets": {
        "type": "object",
        "additionalProperties": false,
        "required": [],
        "properties": {
          "snort": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "maxLength": 256
            },
            "description": "Snort rule ids as `source:snortId`."
          },
          "nuclei": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "maxLength": 1024
            },
            "description": "Nuclei template paths."
          },
          "metasploit": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "Metasploit module URLs."
          },
          "exploitdb": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "Exploit-DB URLs."
          },
          "advisories": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "Advisory and issue-tracking URLs."
          },
          "fixes": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "maxLength": 2048
            },
            "description": "Patch and mitigation URLs."
          }
        },
        "description": "References by kind, at most 5 each. A kind with none is absent."
      },
      "VulnetixKevResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "generatedAt",
          "license",
          "total",
          "count",
          "limit",
          "offset",
          "items"
        ],
        "properties": {
          "generatedAt": {
            "type": "integer",
            "format": "int64",
            "minimum": 0,
            "maximum": 32503680000,
            "description": "Unix seconds when this answer was built. Each query variant is held for an hour, so this can be up to an hour old."
          },
          "license": {
            "type": "string",
            "enum": [
              "Apache-2.0"
            ]
          },
          "total": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Entries matching the filters."
          },
          "count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 5000
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "minimum": 1,
            "maximum": 5000
          },
          "offset": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          },
          "items": {
            "type": "array",
            "maxItems": 5000,
            "items": {
              "$ref": "#/components/schemas/VulnetixKevItem"
            }
          }
        },
        "description": "One page of the Vulnesis KEV catalogue."
      },
      "YaraRule": {
        "type": "object",
        "additionalProperties": false,
        "description": "A YARA rule linked to the vulnerability.",
        "required": [
          "ruleName",
          "source",
          "sourceUrl",
          "sourceFilePath",
          "rawText"
        ],
        "properties": {
          "ruleName": {
            "type": "string",
            "maxLength": 256
          },
          "source": {
            "type": "string",
            "maxLength": 256,
            "description": "Where the rule came from (for example `yara-forge`, `yarahub`, `vulnetix`)."
          },
          "sourceUrl": {
            "type": "string",
            "maxLength": 2048
          },
          "sourceFilePath": {
            "type": "string",
            "maxLength": 1024
          },
          "rawText": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1048576,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The full rule text."
          },
          "meta": {
            "type": "object",
            "maxProperties": 256,
            "additionalProperties": {
              "type": "string",
              "maxLength": 8192
            },
            "description": "The rule's `meta:` section as key/value pairs; absent when empty or unparseable."
          },
          "strings": {
            "type": [
              "array",
              "null"
            ],
            "maxItems": 10000,
            "items": {
              "$ref": "#/components/schemas/YaraRuleString"
            },
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The `strings:` section parsed; absent when empty."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 65536,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The `condition:` section; absent when not stored."
          },
          "tags": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 128
            },
            "description": "Rule tags; absent when none."
          },
          "imports": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Imported modules (`pe`, `math`, ...); absent when none."
          },
          "author": {
            "type": "string",
            "maxLength": 512
          },
          "description": {
            "type": "string",
            "maxLength": 8192
          },
          "reference": {
            "type": "string",
            "maxLength": 4096
          },
          "datePublished": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "RFC 3339, UTC, second precision."
          },
          "dateUpdated": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "RFC 3339, UTC, second precision."
          },
          "fileSize": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Size in bytes of the source file the rule came from."
          }
        }
      },
      "YaraRuleSearchRow": {
        "type": "object",
        "additionalProperties": false,
        "description": "A YARA rule found by the catalogue search. Unlike `YaraRule`, `meta`, `strings` and `condition` are the stored text: `meta` and `strings` are JSON documents serialised as strings, not parsed. Empty optional fields are absent.",
        "required": [
          "uuid",
          "ruleName",
          "source",
          "rawText"
        ],
        "properties": {
          "uuid": {
            "$ref": "#/components/schemas/Uuid"
          },
          "ruleName": {
            "type": "string",
            "maxLength": 256
          },
          "source": {
            "type": "string",
            "maxLength": 256
          },
          "sourceUrl": {
            "type": "string",
            "maxLength": 2048
          },
          "sourceFilePath": {
            "type": "string",
            "maxLength": 1024
          },
          "rawText": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1048576,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The full rule text."
          },
          "bodyContentHash": {
            "type": "string",
            "maxLength": 128,
            "description": "Hash of the rule body, for de-duplication across sources."
          },
          "meta": {
            "type": "string",
            "maxLength": 65536,
            "description": "The `meta:` section as JSON text (an object of strings)."
          },
          "strings": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 1048576,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The `strings:` section as JSON text (an array of `{id, value, modifiers}`)."
          },
          "condition": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 65536,
            "description": "Pro and above. Null below Pro; listed in `_pro_data` and `_entitlements` (feature `detection-rules-catalog`). The `condition:` section."
          },
          "tags": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "type": "string",
              "maxLength": 128
            }
          },
          "imports": {
            "type": "array",
            "maxItems": 64,
            "items": {
              "type": "string",
              "maxLength": 64
            }
          },
          "author": {
            "type": "string",
            "maxLength": 512
          },
          "description": {
            "type": "string",
            "maxLength": 8192
          },
          "reference": {
            "type": "string",
            "maxLength": 4096
          },
          "datePublished": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "RFC 3339, UTC, second precision."
          },
          "dateUpdated": {
            "type": "string",
            "format": "date-time",
            "maxLength": 25,
            "description": "RFC 3339, UTC, second precision."
          },
          "fileSize": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 2147483647
          }
        }
      },
      "YaraRuleString": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "value"
        ],
        "description": "One entry of the rule's `strings:` section.",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 128,
            "description": "String identifier (for example `$s1`)."
          },
          "value": {
            "type": "string",
            "maxLength": 8192
          },
          "modifiers": {
            "type": "array",
            "maxItems": 16,
            "items": {
              "type": "string",
              "maxLength": 32
            },
            "description": "Modifiers (`ascii`, `wide`, `nocase`, ...); absent when none."
          }
        }
      },
      "YearMonth": {
        "type": "string",
        "description": "A calendar month, `YYYY-MM`.",
        "minLength": 7,
        "maxLength": 7,
        "pattern": "^[0-9]{4}-(?:0[1-9]|1[0-2])$",
        "examples": [
          "2024-06"
        ]
      }
    },
    "responses": {
      "BadRequest": {
        "description": "A malformed or out-of-range parameter.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            }
          }
        }
      },
      "Conflict": {
        "description": "The credential's account belongs to more than one organisation and cannot be resolved to one.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            }
          }
        }
      },
      "DefenceInputTooLarge": {
        "description": "An input is over its limit: more than 100 vulnerability ids, a field over 512 characters, a SWID tag over 64 KiB or a CEL expression over 4 KiB. `field` names the input.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            }
          }
        }
      },
      "DefenceInputUnauthorized": {
        "description": "No valid credential (the `Authorization` header is missing or malformed, the API key does not verify, or the session token is expired or invalid), or a uuid TEI or a CEL expression was given and needs the caller's organisation (`field` names the input).",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            }
          }
        }
      },
      "DefenceInputUnavailable": {
        "description": "The transparency log behind a TEI or CEL input could not be read (an `InputError` naming the input; retry), or a dependency did not answer in time, or the service is in maintenance (retry after `Retry-After` seconds).",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "X-Maintenance-Mode": {
            "$ref": "#/components/headers/X-Maintenance-Mode"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/InputError"
                },
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/MaintenanceError"
                }
              ]
            }
          }
        }
      },
      "DefenceInputUnresolvable": {
        "description": "An input is well-formed but cannot be resolved here, for example a SWID tag with no name or a hash TEI. `field` names the input.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            }
          }
        }
      },
      "DetectionVexInputTooLarge": {
        "description": "An input is over its limit: a field longer than its maximum, a CEL expression over its byte limit, or more than 100 vulnerability ids.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            },
            "example": {
              "error": "at most 100 vulnerability ids per request",
              "field": "vulnId"
            }
          }
        }
      },
      "DetectionVexInputUnresolvable": {
        "description": "An input is well formed but cannot be resolved (for example a CPE or purl naming nothing the resolver knows how to read).",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            }
          }
        }
      },
      "DetectionVexInternalError": {
        "description": "A database query failed. Body `{\"error\": \"Internal Server Error\"}`.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            },
            "example": {
              "error": "Internal Server Error"
            }
          }
        }
      },
      "DetectionVexSearchBadRequest": {
        "description": "An input kind is malformed (a purl, CPE, TEI, SWID tag, CEL expression or vulnerability id that does not parse, or an unknown ecosystem). The handler never rejects its own filters: an unusable value is ignored. When request validation runs in enforce mode (the `oas_validation_mode` flag), a query or path value outside this document's constraints is also a 400 `{error, field}`; in the default log mode it reaches the handler, which ignores or clamps it as described.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            },
            "example": {
              "error": "unknown ecosystem \"foo\"",
              "field": "ecosystem"
            }
          }
        }
      },
      "DetectionVexUnauthorized": {
        "description": "No valid credential (the `Authorization` header is missing or malformed, the API key does not verify, or the session token is expired), or an input reads the organisation's own transparency log (a uuid TEI or a CEL expression) and the request is not authenticated to an organisation (`InputError`, `field` names the input).",
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/InputError"
                },
                {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              ]
            }
          }
        }
      },
      "DetectionVexUnavailable": {
        "description": "A dependency did not answer in time, the service is in maintenance (retry after `Retry-After` seconds), or the organisation's transparency log or release could not be read while resolving a uuid TEI or CEL input (`InputError`; try again).",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "X-Maintenance-Mode": {
            "$ref": "#/components/headers/X-Maintenance-Mode"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/InputError"
                },
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/MaintenanceError"
                }
              ]
            }
          }
        }
      },
      "ExploitKevInputBadRequest": {
        "description": "An input in the identifier's or query's place is malformed (`InputError`, naming the field), or the route rejected the identifier itself (`ErrorBody`).",
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/InputError"
                },
                {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              ]
            },
            "example": {
              "error": "purl must start with pkg:",
              "field": "purl"
            }
          }
        }
      },
      "ExploitKevInputTooLarge": {
        "description": "An input is over its size limit: a field over 4096 characters, a SWID tag over 64 KiB, a CEL expression over its byte limit, or more than 100 vulnerability ids.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            }
          }
        }
      },
      "ExploitKevInputUnauthorized": {
        "description": "No valid credential (`ErrorBody`), or a TEI or CEL input reads an organisation's transparency log and the request is not authenticated to an organisation (`InputError`).",
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/InputError"
                }
              ]
            }
          }
        }
      },
      "ExploitKevInputUnavailable": {
        "description": "A dependency did not answer in time or the service is in maintenance (`ErrorBody` or `MaintenanceError`; retry after `Retry-After` seconds), or a TEI or CEL input's transparency log could not be read (`InputError`).",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "X-Maintenance-Mode": {
            "$ref": "#/components/headers/X-Maintenance-Mode"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/MaintenanceError"
                },
                {
                  "$ref": "#/components/schemas/InputError"
                }
              ]
            }
          }
        }
      },
      "ExploitKevInputUnresolvable": {
        "description": "An input is well-formed but cannot be resolved here (a SWID tag id, a hash TEI).",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            }
          }
        }
      },
      "Forbidden": {
        "description": "The organisation or account is inactive.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            }
          }
        }
      },
      "InternalError": {
        "description": "An unexpected server error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            }
          }
        }
      },
      "NotFound": {
        "description": "The resource does not exist, or the caller's organisation was not found.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            }
          }
        }
      },
      "RateLimited": {
        "description": "The Community plan's daily request quota is spent. Soft-limited plans (Pro and above) are never refused.",
        "headers": {
          "RateLimit-DayLimit": {
            "$ref": "#/components/headers/RateLimit-DayLimit"
          },
          "RateLimit-Remaining": {
            "$ref": "#/components/headers/RateLimit-Remaining"
          },
          "RateLimit-Reset": {
            "$ref": "#/components/headers/RateLimit-Reset"
          },
          "X-VDB-Plan": {
            "$ref": "#/components/headers/X-VDB-Plan"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RateLimitError"
            }
          }
        }
      },
      "RemediationBadRequest": {
        "description": "An identifier purl, CPE, TEI or SWID tag that does not parse (`{error, field}`), or an empty identifier.",
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/InputError"
                },
                {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              ]
            }
          }
        }
      },
      "RemediationPayloadTooLarge": {
        "description": "A purl, CPE or TEI identifier over 512 characters, or a SWID tag over 64 KiB.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            }
          }
        }
      },
      "RemediationUnauthorized": {
        "description": "No valid credential, or a uuid TEI identifier from a caller with no organisation (`{error, field}`).",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            }
          }
        }
      },
      "RemediationUnavailable": {
        "description": "Maintenance or a dependency timeout (see `Retry-After`), or a TEI transparency log could not be read (`{error, field}`).",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "X-Maintenance-Mode": {
            "$ref": "#/components/headers/X-Maintenance-Mode"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/MaintenanceError"
                }
              ]
            }
          }
        }
      },
      "RemediationUnprocessable": {
        "description": "The identifier is well formed but cannot be resolved here, for example a purl of an unknown type.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            }
          }
        }
      },
      "RemediationVulnNotFound": {
        "description": "No source holds a record (`{error, identifier}`), or the caller's organisation was not found.",
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/RemediationNotFoundError"
                },
                {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              ]
            }
          }
        }
      },
      "ThreatActivityInputBadRequest": {
        "description": "A malformed input kind (`field` names it), or, on a `/vuln/{identifier}` route, an empty identifier (`Missing vulnerability ID`). When request validation is enforced, a request that does not fit this document is refused with `{error, field}`.",
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/InputError"
                }
              ]
            },
            "example": {
              "error": "purl must start with pkg:",
              "field": "purl"
            }
          }
        }
      },
      "ThreatActivityInputTooLarge": {
        "description": "An input kind over its size limit: a field over its length cap, a CEL expression over its byte cap, or more than 100 vulnerability ids.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            },
            "example": {
              "error": "at most 100 vulnerability ids per request",
              "field": "vulnId"
            }
          }
        }
      },
      "ThreatActivityInputUnauthorized": {
        "description": "No valid credential (the `Authorization` header is missing or malformed, the API key does not verify, or the session token is expired), or an input kind that needs the caller's tenant to resolve.",
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/InputError"
                }
              ]
            }
          }
        }
      },
      "ThreatActivityInputUnavailable": {
        "description": "A dependency did not answer in time, the service is in maintenance, or an input kind could not be resolved because the transparency log or release could not be read (`field` names it). Retry after `Retry-After` seconds when it is set.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "X-Maintenance-Mode": {
            "$ref": "#/components/headers/X-Maintenance-Mode"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/MaintenanceError"
                },
                {
                  "$ref": "#/components/schemas/InputError"
                }
              ]
            }
          }
        }
      },
      "ThreatActivityInputUnresolvable": {
        "description": "A well-formed input kind this API cannot resolve.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/InputError"
            }
          }
        }
      },
      "Unauthorized": {
        "description": "No valid credential: the `Authorization` header is missing or malformed, the API key does not verify, or the session token is expired or invalid.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            }
          }
        }
      },
      "Unavailable": {
        "description": "A dependency did not answer in time, or the service is in maintenance. Retry after `Retry-After` seconds. Maintenance mode refuses only writes to `/v2/cli.*` and `/v2/scan/*` (POST and the like), with the `MaintenanceError` body, `Cache-Control: no-store` and `X-Maintenance-Mode` and `X-Vulnetix-Maintenance` set to `true`.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "X-Maintenance-Mode": {
            "$ref": "#/components/headers/X-Maintenance-Mode"
          },
          "X-Vulnetix-Maintenance": {
            "$ref": "#/components/headers/X-Vulnetix-Maintenance"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                {
                  "$ref": "#/components/schemas/MaintenanceError"
                }
              ]
            }
          }
        }
      },
      "VendorArchiveBadRequest": {
        "description": "`month` is not `YYYY-MM` (`Invalid month. Use YYYY-MM`) or is not a real month (`Invalid month`).",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            },
            "example": {
              "error": "Invalid month. Use YYYY-MM"
            }
          }
        }
      },
      "VendorArchiveMonthNotFound": {
        "description": "No advisories are recorded for the month (`{error: \"No <Vendor> advisories found\", month}`), or the caller's organisation was not found. A failed advisory lookup is 500, not 404.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/VendorArchiveNotFound"
            },
            "example": {
              "error": "No Cisco advisories found",
              "month": "2024-03"
            }
          }
        }
      },
      "VendorArchiveSnapshotUnavailable": {
        "description": "The vendor's archive snapshot has not been produced yet (`{error, vendor}`; retry later, no `Retry-After` is sent), or the authentication backend did not answer (`Retry-After` is sent).",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/VendorArchiveUnavailable"
            },
            "example": {
              "error": "broadcom archive snapshot is not yet available, please retry shortly",
              "vendor": "broadcom"
            }
          }
        }
      }
    },
    "parameters": {
      "DefenceConfidence": {
        "name": "confidence",
        "in": "query",
        "required": false,
        "description": "Keep defences of this confidence. Matched case-insensitively.",
        "schema": {
          "type": "string",
          "enum": [
            "HIGH",
            "MEDIUM",
            "LOW",
            "high",
            "medium",
            "low"
          ],
          "description": "Matched case-insensitively."
        },
        "example": "HIGH"
      },
      "DefenceDeployMode": {
        "name": "deployMode",
        "in": "query",
        "required": false,
        "description": "Keep defences whose recommended starting mode is this. Matched case-insensitively.",
        "schema": {
          "type": "string",
          "enum": [
            "log",
            "block",
            "LOG",
            "BLOCK"
          ],
          "description": "Matched case-insensitively."
        },
        "example": "block"
      },
      "DefenceExploitSource": {
        "name": "exploitSource",
        "in": "query",
        "required": false,
        "description": "Keep defences derived from an exploit of this source, for example `exploit-db` or `github-poc`. Matched exactly.",
        "schema": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64,
          "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
        },
        "example": "exploit-db"
      },
      "DefenceLimit": {
        "name": "limit",
        "in": "query",
        "required": false,
        "description": "Defences per page. Default 100. Values above 200 are clamped to 200; a value below 1 or not a number is read as the default.",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": 1,
          "maximum": 200,
          "default": 100
        },
        "example": 50
      },
      "DefenceOffset": {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "Defences to skip. Default 0; a negative or non-numeric value is read as 0.",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": 0,
          "maximum": 100000,
          "default": 0
        },
        "example": 0
      },
      "DefenceQuery": {
        "name": "q",
        "in": "query",
        "required": false,
        "description": "Free text. Each whitespace-separated token must appear (case-insensitively) in the title, the description or the rule body. Below Pro the rule body still takes part in the match although the body itself is withheld.",
        "schema": {
          "$ref": "#/components/schemas/SafeText"
        },
        "example": "jndi"
      },
      "DetectionRuleIdentifier": {
        "name": "identifier",
        "in": "path",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/VulnIdentifier"
        },
        "description": "A vulnerability, by advisory id (aliases are followed, so a GHSA finds rows filed under its CVE), or in its place a URL-encoded purl, CPE, TEI or SWID tag. Given anything other than an advisory id, the operation runs once per resolved vulnerability (at most 50, known-exploited first) and answers the fan-out envelope with each answer under `results`; ids of a family this operation does not take are listed in `skipped`. Advisory ids must be CVE, GHSA or CNVD.",
        "example": "CVE-2021-44228"
      },
      "DetectionVexCveId": {
        "name": "cveId",
        "in": "query",
        "required": false,
        "style": "form",
        "explode": true,
        "description": "Advisory id the row is linked to; repeat for OR. Upper-cased before matching; no alias is followed when `cveId` is the only input given. Given together with another input kind it is read as `vulnId` (aliases followed). The handler sets no count limit; 100 is the documented ceiling.",
        "schema": {
          "type": "array",
          "maxItems": 100,
          "items": {
            "$ref": "#/components/schemas/VulnId"
          }
        },
        "example": [
          "CVE-2021-44228"
        ]
      },
      "DetectionVexIdentifier": {
        "name": "identifier",
        "in": "path",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/VulnIdentifier"
        },
        "description": "A vulnerability, by advisory id (aliases are followed, so a GHSA finds rows filed under its CVE), or in its place a URL-encoded purl, CPE, TEI or SWID tag. Given anything other than an advisory id, the operation runs once per resolved vulnerability (at most 50, known-exploited first) and answers the fan-out envelope with each answer under `results`; ids of a family this operation does not take are listed in `skipped`.",
        "example": "CVE-2021-44228"
      },
      "DetectionVexLimit200": {
        "name": "limit",
        "in": "query",
        "required": false,
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": 1,
          "maximum": 200,
          "default": 100
        },
        "description": "Rows per page, default 100. A larger value is clamped to 200; zero, a negative or a non-integer value falls back to the default.",
        "example": 50
      },
      "DetectionVexLimit500": {
        "name": "limit",
        "in": "query",
        "required": false,
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": 1,
          "maximum": 500,
          "default": 100
        },
        "description": "Rows per page, default 100. A larger value is clamped to 500; zero, a negative or a non-integer value falls back to the default.",
        "example": 50
      },
      "DetectionVexOffset": {
        "name": "offset",
        "in": "query",
        "required": false,
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": 0,
          "maximum": 100000,
          "default": 0
        },
        "description": "Rows to skip. A negative or non-integer value falls back to 0. The handler sets no upper bound; 100000 is the documented ceiling.",
        "example": 0
      },
      "InputCEL": {
        "name": "cel",
        "in": "query",
        "required": false,
        "description": "A TEA Insights CEL predicate selecting components from your organisation's transparency log. At most 4 KiB.",
        "schema": {
          "$ref": "#/components/schemas/Cel"
        }
      },
      "InputCPE": {
        "name": "cpe",
        "in": "query",
        "required": false,
        "description": "A CPE 2.3 string or CPE 2.2 URI.",
        "schema": {
          "$ref": "#/components/schemas/Cpe"
        },
        "example": "cpe:2.3:a:apache:log4j:2.14.1:*:*:*:*:*:*:*"
      },
      "InputEcosystem": {
        "name": "ecosystem",
        "in": "query",
        "required": false,
        "description": "The package's ecosystem, case-insensitive, canonicalised to its purl type. Accepted: npm (node, nodejs, javascript, yarn, pnpm), pypi (pip, python), maven (java, gradle), golang (go), cargo (crates.io, crates, rust), gem (rubygems, ruby), nuget (dotnet, .net), composer (packagist, php), deb (debian, ubuntu), rpm (redhat, rhel, fedora, centos, rocky, almalinux, suse), apk (alpine), hex (erlang, elixir), pub (dart), swift, cocoapods, github, docker (oci), conan, conda, cran, hackage, bitbucket and generic. Any other value is 400 `{error: \"unknown ecosystem ...\", field: \"ecosystem\"}`. Needs `package`.",
        "schema": {
          "$ref": "#/components/schemas/Ecosystem"
        },
        "example": "npm"
      },
      "InputPURL": {
        "name": "purl",
        "in": "query",
        "required": false,
        "description": "A Package URL. Its type is its ecosystem.",
        "schema": {
          "$ref": "#/components/schemas/Purl"
        },
        "example": "pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1"
      },
      "InputPackage": {
        "name": "package",
        "in": "query",
        "required": false,
        "description": "A package name as its ecosystem writes it; a Maven `group/artifact` becomes `group:artifact`. Also accepted as `packageName`.",
        "schema": {
          "$ref": "#/components/schemas/PackageName"
        },
        "example": "lodash"
      },
      "InputProduct": {
        "name": "product",
        "in": "query",
        "required": false,
        "description": "A product as CVE records and CPEs name it.",
        "schema": {
          "$ref": "#/components/schemas/ProductName"
        },
        "example": "log4j"
      },
      "InputSWID": {
        "name": "swid",
        "in": "query",
        "required": false,
        "description": "A SWID tag, as XML or base64 of it. A tag over 64 KiB is 413; send a long tag in a POST body where the operation has one. Invalid XML, a DOCTYPE, or a root element other than `SoftwareIdentity` is 400; a tag with no `name` attribute (or a bare tag id) names no product and is 422.",
        "schema": {
          "$ref": "#/components/schemas/Swid"
        }
      },
      "InputTEI": {
        "name": "tei",
        "in": "query",
        "required": false,
        "description": "A Transparency Exchange Identifier. A uuid TEI reads your organisation's transparency log.",
        "schema": {
          "$ref": "#/components/schemas/Tei"
        },
        "example": "urn:tei:purl:vulnes.is:pkg:npm/lodash@4.17.20"
      },
      "InputVendor": {
        "name": "vendor",
        "in": "query",
        "required": false,
        "description": "A vendor, with `product`; or alone, to narrow a package to that vendor's advisories.",
        "schema": {
          "$ref": "#/components/schemas/VendorName"
        },
        "example": "apache"
      },
      "InputVersion": {
        "name": "version",
        "in": "query",
        "required": false,
        "description": "The version of the package, product, CPE or SWID tag. Also accepted as `packageVersion` or `currentVersion`.",
        "schema": {
          "$ref": "#/components/schemas/Version"
        },
        "example": "4.17.20"
      },
      "InputVulnId": {
        "name": "vulnId",
        "in": "query",
        "required": false,
        "style": "form",
        "explode": true,
        "description": "Advisory id of any family (CVE, GHSA, OSV, PYSEC, RUSTSEC, GO, DSA, EUVD, CNVD and the rest). Repeat the parameter, or separate ids with commas; more than 100 in all is 413. Also accepted as `vulnIds`, `cveId` or `identifier`. Aliases are followed both ways, so a GHSA finds what was filed under its CVE.",
        "schema": {
          "type": "array",
          "maxItems": 100,
          "items": {
            "$ref": "#/components/schemas/VulnIdList"
          }
        },
        "example": [
          "CVE-2021-44228"
        ]
      },
      "RemediationCurrentVersion": {
        "name": "currentVersion",
        "in": "query",
        "required": false,
        "description": "The version you run. Also accepted as `version`.",
        "schema": {
          "$ref": "#/components/schemas/Version"
        },
        "example": "2.14.1"
      },
      "RemediationLimit": {
        "name": "limit",
        "in": "query",
        "required": false,
        "description": "Page size (default 100, clamped to 500; invalid values revert to 100).",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": 1,
          "maximum": 500,
          "default": 100
        },
        "example": 100
      },
      "RemediationOffset": {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "Items to skip (default 0; invalid values revert to 0).",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": 0,
          "maximum": 100000,
          "default": 0
        },
        "example": 0
      },
      "RemediationOs": {
        "name": "os",
        "in": "query",
        "required": false,
        "description": "`<distro>[-<version>]`; distro one of ubuntu, debian, redhat, rhel, centos, fedora, almalinux, rockylinux, rocky, alpine, suse, opensuse, amzn, oracle. Unknown ids are ignored.",
        "schema": {
          "type": "string",
          "minLength": 3,
          "maxLength": 64,
          "pattern": "^[A-Za-z]+(?:-[A-Za-z0-9.]+)?$"
        },
        "example": "ubuntu-22.04"
      },
      "RemediationPackageName": {
        "name": "packageName",
        "in": "query",
        "required": false,
        "description": "Only registry fixes for this package (exact, ignoring case). Also accepted as `package`.",
        "schema": {
          "$ref": "#/components/schemas/PackageName"
        },
        "example": "org.apache.logging.log4j:log4j-core"
      },
      "RemediationVulnIdentifier": {
        "name": "identifier",
        "in": "path",
        "required": true,
        "description": "An advisory id (aliases followed), or a URL-encoded purl, CPE, TEI or base64 SWID tag, which fans out.",
        "schema": {
          "$ref": "#/components/schemas/VulnIdentifier"
        },
        "example": "CVE-2021-44228"
      },
      "VendorArchiveMonth": {
        "name": "month",
        "in": "path",
        "required": true,
        "description": "The calendar month, `YYYY-MM`. A value that is not `YYYY-MM`, or names month 00 or 13, answers 400.",
        "schema": {
          "$ref": "#/components/schemas/YearMonth"
        },
        "example": "2024-03"
      },
      "VulnIdentifierPath": {
        "name": "identifier",
        "in": "path",
        "required": true,
        "description": "The vulnerability: an advisory id of any family (CVE, GHSA, OSV, PYSEC, EUVD, CNVD and the rest), case-insensitive and alias-resolved. In its place a URL-encoded purl, CPE or TEI, or a base64 (or base64url) SWID tag, answers once per resolved vulnerability under `results` (at most 50, known-exploited first).",
        "schema": {
          "$ref": "#/components/schemas/VulnIdentifier"
        },
        "example": "CVE-2021-44228"
      }
    },
    "headers": {
      "AiFeedCacheControl": {
        "description": "Set by the handler: the answer does not depend on the caller's plan, so browsers may keep it 5 minutes and the CDN an hour.",
        "schema": {
          "type": "string",
          "enum": [
            "public, max-age=300, s-maxage=3600, stale-while-revalidate=3600"
          ]
        }
      },
      "DetectionVexCacheControl": {
        "description": "Always `private, no-store`: the answer depends on the caller's credential and plan, so no shared cache may keep it.",
        "schema": {
          "type": "string",
          "enum": [
            "private, no-store"
          ]
        }
      },
      "DetectionVexVary": {
        "description": "`Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
        "schema": {
          "type": "string",
          "maxLength": 512
        }
      },
      "ETag": {
        "description": "Entity tag of the body; send it back in `If-None-Match` to get `304` when unchanged.",
        "schema": {
          "type": "string",
          "pattern": "^(W/)?\"[0-9a-f]{1,128}\"$",
          "maxLength": 132
        }
      },
      "MalwareCheckCacheControl": {
        "description": "The answer depends on the caller's plan, so it is never stored by a shared cache.",
        "schema": {
          "type": "string",
          "enum": [
            "private, no-store"
          ]
        }
      },
      "MsrcXCache": {
        "description": "Whether the answer came from the in-process cache (`HIT`) or was built for this request (`MISS`). Set by the API; CloudFront may rewrite it.",
        "schema": {
          "type": "string",
          "maxLength": 512
        }
      },
      "RateLimit-DayLimit": {
        "description": "The organisation's daily request quota, or `unlimited`.",
        "schema": {
          "type": "string",
          "pattern": "^([0-9]{1,10}|unlimited)$",
          "maxLength": 10
        }
      },
      "RateLimit-Remaining": {
        "description": "Requests left in the current window, or `unlimited`.",
        "schema": {
          "type": "string",
          "pattern": "^([0-9]{1,10}|unlimited)$",
          "maxLength": 10
        }
      },
      "RateLimit-Reset": {
        "description": "Unix seconds of the next 00:00 UTC, when the window resets.",
        "schema": {
          "type": "string",
          "pattern": "^[0-9]{1,12}$",
          "maxLength": 12
        }
      },
      "RemediationCacheControl": {
        "description": "`private, no-store`: answers depend on the caller's credential and plan.",
        "schema": {
          "type": "string",
          "enum": [
            "private, no-store"
          ]
        }
      },
      "RemediationXCache": {
        "description": "`HIT` from the 5-minute plan cache, else `MISS`. Set by the API; CloudFront may rewrite it.",
        "schema": {
          "type": "string",
          "maxLength": 512
        }
      },
      "Retry-After": {
        "description": "Seconds to wait before retrying.",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": 0,
          "maximum": 86400
        }
      },
      "SummaryFeedCacheControl": {
        "description": "Set by the handler: the daily snapshot does not depend on the caller's plan, so browsers may keep it 5 minutes and the CDN a day.",
        "schema": {
          "type": "string",
          "enum": [
            "public, max-age=300, s-maxage=86400, stale-while-revalidate=86400"
          ]
        }
      },
      "ThreatActivityCacheControl": {
        "description": "Cache policy. Every authenticated answer is `private, no-store`: the same URL answers each plan differently, so no shared cache may keep it.",
        "schema": {
          "type": "string",
          "enum": [
            "private, no-store"
          ]
        }
      },
      "VendorArchiveCacheControl": {
        "description": "Always `private, no-store` (set by the authentication layer); the answer is not cached at the edge.",
        "schema": {
          "type": "string",
          "enum": [
            "private, no-store"
          ]
        }
      },
      "VendorArchiveVary": {
        "description": "`Authorization, Accept-Encoding`. Set by the API; CloudFront may rewrite it.",
        "schema": {
          "type": "string",
          "maxLength": 512
        }
      },
      "VendorArchiveXCache": {
        "description": "`HIT` when the body came from the API's in-process cache, `MISS` when it was built for this request. Set by the API; CloudFront may rewrite it.",
        "schema": {
          "type": "string",
          "maxLength": 512
        }
      },
      "VulnApiCacheControl": {
        "description": "`private, no-store`, set by the authentication middleware on every protected answer: the answer depends on the caller's credential and plan.",
        "schema": {
          "type": "string",
          "enum": [
            "private, no-store"
          ]
        }
      },
      "VulnApiVary": {
        "description": "`Authorization, Accept-Encoding`, set by the authentication middleware. Set by the API; CloudFront may rewrite it.",
        "schema": {
          "type": "string",
          "maxLength": 512
        }
      },
      "VulnApiXCache": {
        "description": "`HIT` when the answer came from the server's in-process response cache, `MISS` when it was built for this request. Set by the API; CloudFront may rewrite it.",
        "schema": {
          "type": "string",
          "maxLength": 512
        }
      },
      "X-Maintenance-Mode": {
        "description": "Present, as `true`, while the service is in maintenance.",
        "schema": {
          "type": "string",
          "enum": [
            "true"
          ]
        }
      },
      "X-Softlimits": {
        "description": "Present, as `true`, when the plan's daily quota is soft: usage is counted but requests are never refused.",
        "schema": {
          "type": "string",
          "enum": [
            "true"
          ]
        }
      },
      "X-VDB-Plan": {
        "description": "The caller's plan. Fields and answers above it are gated (see `x-vulnetix-plan`).",
        "schema": {
          "type": "string",
          "enum": [
            "community",
            "pro",
            "teams",
            "enterprise"
          ]
        }
      },
      "X-Vulnetix-Maintenance": {
        "description": "Present, as `true`, while the service is in maintenance (sent with `X-Maintenance-Mode`).",
        "schema": {
          "type": "string",
          "enum": [
            "true"
          ]
        }
      }
    }
  },
  "externalDocs": {
    "description": "VDB API guide",
    "url": "https://docs.vulnes.is/vdb-api/get-started/overview/"
  },
  "security": [
    {
      "ApiKeyAuth": []
    },
    {
      "BearerAuth": []
    }
  ],
  "x-tagGroups": [
    {
      "name": "Getting started",
      "tags": [
        "Authentication",
        "Service"
      ]
    },
    {
      "name": "Vulnerabilities",
      "tags": [
        "Vulnerabilities",
        "Inputs"
      ]
    },
    {
      "name": "Remediation",
      "tags": [
        "Remediation"
      ]
    },
    {
      "name": "Exploits and threat activity",
      "tags": [
        "Exploit Intelligence",
        "Threat Activity",
        "KEV",
        "AI Threat Intelligence"
      ]
    },
    {
      "name": "Detection and defence",
      "tags": [
        "Detection Rules",
        "Defences",
        "VEX"
      ]
    },
    {
      "name": "Software supply chain",
      "tags": [
        "Packages",
        "Malware Intelligence",
        "SBOM Scanning",
        "End-of-Life"
      ]
    },
    {
      "name": "Vendor advisories",
      "tags": [
        "MSRC Patch Tuesday",
        "Vendor Archives",
        "Raw Archives"
      ]
    },
    {
      "name": "Reference data",
      "tags": [
        "Enumerations",
        "Statistics",
        "Cloud"
      ]
    }
  ]
}
