Raw schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"minItems": 0,
"maxItems": 50,
"description": "The versions to check, in order: \"product@version\" strings or {product, version} objects. Needed unless packages is sent",
"items": {
"anyOf": [
{
"type": "string",
"description": "product@version, e.g. nodejs@18.19.0 (GET /v1/eol/index lists products)",
"pattern": "^[^@]+@.+$",
"minLength": 3,
"maxLength": 401
},
{
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "endoflife.date product id or alias, e.g. nodejs, python, ubuntu (GET /v1/eol/index lists them)",
"minLength": 1,
"maxLength": 200
},
"version": {
"type": "string",
"description": "Version string, e.g. 18.19.0 (send \"3.10\" as a string, not a number)",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"product",
"version"
],
"additionalProperties": false
}
]
}
},
"cves": {
"type": "array",
"minItems": 0,
"maxItems": 100,
"items": {
"type": "string",
"description": "CVE id, e.g. CVE-2021-44228",
"pattern": "^[Cc][Vv][Ee]-\\d{4}-\\d{4,}$",
"maxLength": 32
},
"description": "Optional CVE ids to check against CISA KEV; duplicates are merged. Leave out (or send []) to check versions only"
},
"packages": {
"type": "array",
"minItems": 0,
"maxItems": 50,
"description": "Optional package URLs with versions, answered as POST /v1/osv/check answers them (advisories, fixed versions, KEV flag). Types: npm, pypi, golang, cargo, maven (nuget, gem and composer are answered as ecosystem_unavailable until imported)",
"items": {
"type": "string",
"description": "purl with a version, e.g. pkg:npm/lodash@4.17.20 or pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1",
"pattern": "^pkg:",
"minLength": 7,
"maxLength": 512
}
},
"warn_days": {
"type": "integer",
"minimum": 0,
"maximum": 365,
"description": "Start only: report an item as due soon when its EOL date is this many days away or fewer (default 90, 0 = off). Kept in the token"
},
"token": {
"type": "string",
"description": "Re-check only: data.watch.token from your last answer. Nothing else with it but full. It holds your stack in readable form; keep it as you would the stack",
"pattern": "^sfw1\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]{43}$",
"maxLength": 48000
},
"full": {
"type": "boolean",
"description": "Re-check only: also return data.check, the full current stack answer, at the same price (default false)"
}
},
"required": [],
"description": "Send either the stack (items, cves, packages, warn_days: starts a watch) or a token from the last answer (token, full: a re-check), not both",
"additionalProperties": false
}