openapi: 3.0.3
info:
title: EUVD API
description: API for querying recent vulnerabilities from the ENISA EUVD database.
version: 0.2.0
license:
name: MIT OR Apache-2.0
url: https://opensource.org/licenses/MIT
externalDocs:
description: Official EUVD API documentation
url: https://euvd.enisa.europa.eu/apidoc
servers:
- url: https://euvdservices.enisa.europa.eu
paths:
/api/lastvulnerabilities:
get:
summary: Show latest vulnerabilities
operationId: getLastVulnerabilities
responses:
'200':
description: Successful response (max 8 records)
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Vulnerability'
/api/exploitedvulnerabilities:
get:
summary: Show latest exploited vulnerabilities
operationId: getExploitedVulnerabilities
responses:
'200':
description: Successful response (max 8 records)
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Vulnerability'
/api/criticalvulnerabilities:
get:
summary: Show latest critical vulnerabilities
operationId: getCriticalVulnerabilities
responses:
'200':
description: Successful response (max 8 records)
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Vulnerability'
/api/vulnerabilities:
get:
summary: Query vulnerabilities with flexible filters
operationId: queryVulnerabilities
parameters:
- name: fromScore
in: query
schema:
type: number
format: float
- name: toScore
in: query
schema:
type: number
format: float
- name: fromEpss
in: query
schema:
type: number
format: float
- name: toEpss
in: query
schema:
type: number
format: float
- name: fromDate
in: query
schema:
type: string
format: date
- name: toDate
in: query
schema:
type: string
format: date
- name: product
in: query
schema:
type: string
- name: vendor
in: query
schema:
type: string
- name: assigner
in: query
schema:
type: string
- name: exploited
in: query
schema:
type: boolean
- name: page
in: query
schema:
type: integer
- name: text
in: query
schema:
type: string
- name: size
in: query
schema:
type: integer
default: 10
maximum: 100
responses:
'200':
description: Successful response (max 100 records)
content:
application/json:
schema:
$ref: '#/components/schemas/Vulnerabilities'
/api/enisaid:
get:
summary: Show EUVD by ID
operationId: getByEnisaId
parameters:
- name: id
in: query
required: true
schema:
type: string
responses:
'200':
description: Successful response with EUVD record
content:
application/json:
schema:
$ref: '#/components/schemas/VulnerabilityWithRelations'
/api/vulnerability:
get:
summary: Show vulnerability by ID
operationId: getVulnerabilityById
parameters:
- name: id
in: query
required: true
schema:
type: string
responses:
'200':
description: Successful response with vulnerability data
content:
application/json:
schema:
$ref: '#/components/schemas/VulnerabilityWithComponents'
/api/advisory:
get:
summary: Show advisory by ID
operationId: getAdvisoryById
parameters:
- name: id
in: query
required: true
schema:
type: string
responses:
'200':
description: Successful response with advisory data
content:
application/json:
schema:
$ref: '#/components/schemas/Advisory'
components:
schemas:
VulnerabilityBase:
type: object
properties:
id:
type: string
description:
type: string
datePublished:
type: string
format: date-time
dateUpdated:
type: string
format: date-time
baseScore:
type: number
format: float
baseScoreVersion:
type: string
baseScoreVector:
type: string
references:
type: string
aliases:
type: string
assigner:
type: string
epss:
type: number
format: float
Vulnerability:
allOf:
- $ref: '#/components/schemas/VulnerabilityBase'
- type: object
properties:
exploitedSince:
type: string
format: date-time
enisaIdProduct:
type: array
items:
type: object
properties:
id:
type: string
product:
type: object
properties:
name:
type: string
product_version:
type: string
enisaIdVendor:
type: array
items:
type: object
properties:
id:
type: string
vendor:
type: object
properties:
name:
type: string
Vulnerabilities:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/Vulnerability'
total:
type: integer
VulnerabilityWithRelations:
allOf:
- $ref: '#/components/schemas/Vulnerability'
- type: object
properties:
enisaIdVulnerability:
type: array
items:
$ref: '#/components/schemas/EnisaIdVulnerabilityEntry'
enisaIdAdvisory:
type: array
items:
type: object EnisaIdVulnerabilityEntry:
type: object
properties:
id:
type: string
vulnerability:
$ref: '#/components/schemas/NestedVulnerability'
NestedVulnerability:
allOf:
- $ref: '#/components/schemas/VulnerabilityBase'
- type: object
properties:
status:
type: string
enisa_id:
type: string
vulnerabilityProduct:
type: array
items:
type: object
properties:
id:
type: string
product:
$ref: '#/components/schemas/NestedProduct'
product_version:
type: string
vulnerabilityVendor:
type: array
items:
type: object
properties:
id:
type: string
vendor:
$ref: '#/components/schemas/NestedVendor'
NestedProduct:
type: object
properties:
name:
type: string
NestedVendor:
type: object
properties:
name:
type: string
VulnerabilityWithComponents:
allOf:
- $ref: '#/components/schemas/VulnerabilityBase'
- type: object
properties:
status:
type: string
enisa_id:
type: string
vulnerabilityProduct:
type: array
items:
type: object
properties:
id:
type: string
product:
$ref: '#/components/schemas/NestedProduct'
product_version:
type: string
vulnerabilityVendor:
type: array
items:
type: object
properties:
id:
type: string
vendor:
$ref: '#/components/schemas/NestedVendor'
vulnerabilityAdvisory:
type: array
items:
type: object Advisory:
type: object
properties:
id:
type: string
description:
type: string
summary:
type: string
datePublished:
type: string
format: date-time
dateUpdated:
type: string
format: date-time
baseScore:
type: number
format: float
references:
type: string
aliases:
type: string
source:
type: object
properties:
id:
type: integer
name:
type: string
advisoryProduct:
type: array
items:
type: object
properties:
id:
type: string
product:
$ref: '#/components/schemas/NestedProduct'
enisaIdAdvisories:
type: array
items:
type: object
properties:
id:
type: string
enisaId:
$ref: '#/components/schemas/NestedVulnerability'
vulnerabilityAdvisory:
type: array
items:
type: object
properties:
id:
type: string
vulnerability:
$ref: '#/components/schemas/NestedVulnerability'