> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectdiscovery.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Vulnerability Timeline

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



## OpenAPI

````yaml get /v2/vulnerability/{id}/timeline
openapi: 3.1.0
info:
  title: PDCP API
  version: '1.0'
  summary: ProjectDiscovery Cloud Platform
  description: >-
    For more details, checkout
    https://docs.projectdiscovery.io/api-reference/editor/scan
servers:
  - url: https://api.projectdiscovery.io
    description: Production
  - url: https://api.dev.projectdiscovery.io
    description: Development
  - url: http://localhost:8085
    description: Localhost
security:
  - X-API-Key: []
paths:
  /v2/vulnerability/{id}/timeline:
    parameters:
      - schema:
          type: string
        name: id
        in: path
        required: true
    get:
      tags:
        - vulnerability
      summary: Get Vulnerability Timeline
      description: >-
        Get timeline of events for a vulnerability including template release
        date, first detection, status changes, and severity changes
      operationId: get-vulnerability-timeline
      parameters:
        - schema:
            type: array
            items:
              type: string
              enum:
                - detected
                - status_change
                - resolved
                - reopened
                - severity_change
                - template_released
                - template_updated
          name: event_type
          in: query
          required: false
          description: >-
            Filter by event types (comma-separated). If not provided, returns
            all events.
          style: form
          explode: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VulnTimelineResponse'
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '404':
          $ref: '#/components/responses/ErrorResponse'
        '500':
          $ref: '#/components/responses/ErrorResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
components:
  schemas:
    VulnTimelineResponse:
      title: VulnTimelineResponse
      type: object
      properties:
        template_released_at:
          type: string
          format: date-time
          description: Date when the template was first released (created)
        template_updated_at:
          type: string
          format: date-time
          description: Date when the template was last updated
        template_raw:
          type: string
          description: Raw template content (YAML) for public templates
        first_detected_at:
          type: string
          format: date-time
        last_seen_at:
          type: string
          format: date-time
        current_status:
          type: string
        events:
          type: array
          items:
            $ref: '#/components/schemas/TimelineEvent'
    TimelineEvent:
      title: TimelineEvent
      type: object
      required:
        - timestamp
        - event_type
      properties:
        timestamp:
          type: string
          format: date-time
        event_type:
          type: string
          description: >-
            Type of event (template_released, detected, status_change,
            severity_change, reopened)
        old_value:
          type: string
        new_value:
          type: string
        description:
          type: string
  responses:
    ErrorResponse:
      description: Example response
      content:
        application/json:
          schema:
            type: object
            required:
              - message
            properties:
              message:
                type: string
              kind:
                type: string
              code:
                type: string
              error:
                type: string
              error_id:
                type: string
              param:
                type: string
              status:
                type: integer
  securitySchemes:
    X-API-Key:
      name: X-API-Key
      type: apiKey
      in: header

````