Get Vulnerability Timeline

Get timeline of events for a vulnerability including template release date, first detection, status changes, and severity changes

GET /v2/vulnerability/{id}/timeline

Get Vulnerability Timeline

cURL

curl --request GET \
  --url https://api.projectdiscovery.io/v2/vulnerability/{id}/timeline \
  --header 'X-API-Key: <api-key>'

200

{
  "template_released_at": "2023-11-07T05:31:56Z",
  "template_updated_at": "2023-11-07T05:31:56Z",
  "template_raw": "<string>",
  "first_detected_at": "2023-11-07T05:31:56Z",
  "last_seen_at": "2023-11-07T05:31:56Z",
  "current_status": "<string>",
  "events": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "event_type": "<string>",
      "old_value": "<string>",
      "new_value": "<string>",
      "description": "<string>"
    }
  ]
}

Authorizations

X-API-Key · string · header · required

Path Parameters

id · string · required

Query Parameters

event_type · enum<string>[]

Filter by event types (comma-separated). If not provided, returns all events.

Available options: detected, status_change, resolved, reopened, severity_change, template_released, template_updated

Response

200

application/json

OK

template_released_at · string<date-time>

Date when the template was first released (created)

template_updated_at · string<date-time>

Date when the template was last updated

template_raw · string

Raw template content (YAML) for public templates

first_detected_at · string<date-time>

last_seen_at · string<date-time>

current_status · string

events · TimelineEvent · object[]

Show child attributes