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

# Get Issue Details

> Retrieve detailed information about a specific issue/finding



## OpenAPI

````yaml api-reference/openapi.json get /api/org/projects/{shortcode}/findings/{ref}
openapi: 3.0.3
info:
  title: Dvuln Organisation API
  description: API for managing projects, issues, and comments in Dvuln platform
  version: 1.0.0
servers:
  - url: https://{host}
    description: Dvuln API Server
    variables:
      host:
        default: console.dvuln.com
        description: The API host domain
security:
  - ApiKeyAuth: []
paths:
  /api/org/projects/{shortcode}/findings/{ref}:
    get:
      summary: Get Issue Details
      description: Retrieve detailed information about a specific issue/finding
      operationId: getIssueDetails
      parameters:
        - name: shortcode
          in: path
          required: true
          description: Project shortcode identifier
          schema:
            type: string
        - name: ref
          in: path
          required: true
          description: Issue/finding reference identifier
          schema:
            type: string
      responses:
        '200':
          description: Successful response with issue details
          content:
            application/json:
              schema:
                type: object
                properties:
                  ref:
                    type: string
                    example: '1'
                  title:
                    type: string
                    example: Cross-Site Scripting (XSS) Vulnerability
                  shortcode:
                    type: string
                    example: DVPT-ABC-EXAMPLE-1
                  fromProject:
                    type: string
                    example: Example Project Penetration Test
                  dateReported:
                    type: string
                    example: 29 Jan 2025
                  dateUpdated:
                    type: string
                    example: Jul 21 05:00 PM
                  severity:
                    type: string
                    enum:
                      - critical
                      - high
                      - medium
                      - low
                      - informational
                    example: critical
                  severityNum:
                    type: integer
                    minimum: 1
                    maximum: 5
                    description: >-
                      Numeric severity (1=informational, 2=low, 3=medium,
                      4=high, 5=critical)
                    example: 5
                  creator:
                    type: object
                    properties:
                      displayName:
                        type: string
                        example: john-doe
                      firstName:
                        type: string
                        example: John
                      lastName:
                        type: string
                        example: Doe
                      fullName:
                        type: string
                        example: John Doe
                      profileImgUuid:
                        type: string
                        example: a1b2c3d4e5f6g7h8i9j0
                  reviewer:
                    type: string
                    example: John Doe (john-doe)
                  status:
                    type: object
                    properties:
                      ID:
                        type: string
                        example: '3'
                      name:
                        type: string
                        example: Open
                      showReportDetails:
                        type: string
                        example: '1'
                      description:
                        type: string
                        example: >-
                          Issue has been reviewed and details are available to
                          the client.
                      canMoveToId:
                        type: string
                        nullable: true
                        example: '4'
                  commentCount:
                    type: integer
                    minimum: 0
                    example: 3
                  content:
                    type: string
                    description: >-
                      Markdown content describing the issue details including
                      Description, Impact, Affected Assets, Remediation, and
                      Testing Process
                    example: |-
                      ###### Description

                      A detailed description of the vulnerability...

                      ###### Impact

                      The business impact...
                  cvssVector:
                    type: string
                    example: N/A
                  cvssScore:
                    type: string
                    example: N/A
                  activity:
                    type: array
                    description: Activity history including comments and status changes
                    items:
                      type: object
                      properties:
                        who:
                          type: object
                          properties:
                            displayName:
                              type: string
                              example: john-doe
                            firstName:
                              type: string
                              example: John
                            lastName:
                              type: string
                              example: Doe
                            fullName:
                              type: string
                              example: John Doe
                            profileImgUuid:
                              type: string
                              nullable: true
                              example: a1b2c3d4e5f6g7h8i9j0
                        what:
                          type: string
                          description: HTML formatted activity description
                          example: >-
                            posted a comment<br><span class="text-muted">This
                            needs immediate attention</span>
                        isComment:
                          type: boolean
                          example: true
                        date:
                          type: string
                          description: Human-readable relative or absolute time
                          example: 23 hours ago
                        dateRaw:
                          type: string
                          description: Unix timestamp
                          example: '1753081254'
        '403':
          description: Forbidden - Invalid or missing API key
        '404':
          description: Issue not found
        '500':
          description: Internal server error
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Token
      description: API key for authentication

````