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

# List issues

> List issues with optional filters and pagination.



## OpenAPI

````yaml https://neo.api.projectdiscovery.io/api/openapi.json get /api/v1/issues
openapi: 3.1.0
info:
  contact:
    name: ProjectDiscovery
    url: https://neo.projectdiscovery.io
  description: Neo API Server - Security agent orchestration platform
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  title: Neo API
  version: 1.0.0
servers:
  - description: Production
    url: https://neo.api.projectdiscovery.io
  - description: Local development
    url: http://localhost:8080
security: []
tags:
  - description: Task execution and management
    name: Tasks
  - description: Agent listing and management
    name: Agents
  - description: Public agent directory
    name: Agent Directory
  - description: User file storage management
    name: Files
  - description: User working memory management
    name: Memory
  - description: Scheduled and recurring task management
    name: Schedules
  - description: Knowledge base and semantic search
    name: Knowledge
  - description: Encrypted user credentials and API keys
    name: Secrets
  - description: Neo API key management for programmatic access
    name: API Keys
  - description: User profile and account information
    name: User
  - description: Task and LLM usage tracking
    name: Usage
  - description: Bring Your Own Key provider management
    name: BYOK
  - description: Model discovery and capabilities
    name: Models
  - description: Third-party integrations
    name: Integrations
  - description: Skill knowledge documents for agent prompts
    name: Skills
  - description: Team management and member invitations
    name: Teams
  - description: Prompt library management and discovery
    name: Prompts
  - description: Slack bot integration for workspace installation and OAuth
    name: Slack
  - description: GitHub integration for PR reviews and repository management
    name: GitHub
  - description: Vulnerability issue tracking and management
    name: Issues
  - description: Subscription billing and plans
    name: Billing
  - description: Project management and member assignments
    name: Projects
  - description: SSH key pair generation and management for remote server access
    name: SSH Keys
  - description: Codebase structural analysis and mapping
    name: Codemaps
  - description: AI-generated codebase documentation and security analysis
    name: CodeWiki
  - description: Captured HTTP traffic query and replay
    name: Network Events
paths:
  /api/v1/issues:
    get:
      tags:
        - Issues
      summary: List issues
      description: List issues with optional filters and pagination.
      operationId: get-v1-issues
      parameters:
        - description: Filter by severity (OR within)
          explode: true
          in: query
          name: severity
          required: false
          schema:
            items:
              $ref: '#/components/schemas/IssueSeverity'
            type: array
          style: form
        - description: Filter by status (OR within)
          explode: true
          in: query
          name: status
          required: false
          schema:
            items:
              $ref: '#/components/schemas/IssueStatus'
            type: array
          style: form
        - description: Filter by type (OR within)
          explode: true
          in: query
          name: type
          required: false
          schema:
            items:
              $ref: '#/components/schemas/IssueType'
            type: array
          style: form
        - description: Filter by source (OR within, any string value)
          explode: true
          in: query
          name: source
          required: false
          schema:
            items:
              type: string
            type: array
          style: form
        - description: Filter by priority (OR within)
          explode: true
          in: query
          name: priority
          required: false
          schema:
            items:
              $ref: '#/components/schemas/IssuePriority'
            type: array
          style: form
        - description: Filter by confidence (OR within)
          explode: true
          in: query
          name: confidence
          required: false
          schema:
            items:
              $ref: '#/components/schemas/IssueConfidence'
            type: array
          style: form
        - description: Filter by host (partial match)
          in: query
          name: host
          required: false
          schema:
            type: string
        - description: Filter by IP address (partial match)
          in: query
          name: ip_address
          required: false
          schema:
            type: string
        - description: Filter by template ID (partial match)
          in: query
          name: template_id
          required: false
          schema:
            type: string
        - description: Filter by component (partial match)
          in: query
          name: component
          required: false
          schema:
            type: string
        - description: Filter by assignee (partial match)
          in: query
          name: assignee
          required: false
          schema:
            type: string
        - description: Filter by port (exact match)
          in: query
          name: port
          required: false
          schema:
            type: integer
        - description: Filter by tags (must have ALL)
          explode: true
          in: query
          name: tags
          required: false
          schema:
            items:
              type: string
            type: array
          style: form
        - description: Full-text search across title, description, host, template
          in: query
          name: search
          required: false
          schema:
            type: string
        - description: >-
            Filter by external ticket id (exact match). Pairs with source +
            fingerprint for cross-run dedup lookup.
          in: query
          name: ticket_id
          required: false
          schema:
            type: string
        - description: >-
            Filter by content-stable fingerprint (exact match). Used by github
            review flow to find an existing issue before re-filing.
          in: query
          name: fingerprint
          required: false
          schema:
            type: string
        - description: Filter issues created after this timestamp
          in: query
          name: created_after
          required: false
          schema:
            format: date-time
            type: string
        - description: Filter issues created before this timestamp
          in: query
          name: created_before
          required: false
          schema:
            format: date-time
            type: string
        - description: Page number
          in: query
          name: page
          required: false
          schema:
            default: 1
            minimum: 1
            type: integer
        - description: Items per page
          in: query
          name: per_page
          required: false
          schema:
            default: 50
            maximum: 200
            minimum: 1
            type: integer
        - description: Filter by target field (partial match)
          in: query
          name: target
          required: false
          schema:
            type: string
        - description: Filter by target_type (exact match)
          in: query
          name: target_type
          required: false
          schema:
            type: string
        - description: Show only issues that include an affected asset with this host
          in: query
          name: affected_host
          required: false
          schema:
            type: string
        - description: Show only issues with at least this many affected assets
          in: query
          name: min_affected
          required: false
          schema:
            type: integer
        - description: >-
            Filter issues that contain this CVE ID in their cve_ids array (exact
            match)
          in: query
          name: cve_id
          required: false
          schema:
            type: string
        - description: >-
            Filter issues that contain this CWE ID in their cwe_ids array (exact
            match)
          in: query
          name: cwe_id
          required: false
          schema:
            type: string
        - description: Filter issues with CVSS score >= this value
          in: query
          name: min_cvss
          required: false
          schema:
            format: float
            type: number
        - description: Filter issues with CVSS score <= this value
          in: query
          name: max_cvss
          required: false
          schema:
            format: float
            type: number
        - description: Filter issues that have (true) or don't have (false) a linked ticket
          in: query
          name: has_ticket
          required: false
          schema:
            type: boolean
        - description: Sort field
          in: query
          name: sort_by
          required: false
          schema:
            default: created_at
            enum:
              - created_at
              - severity
              - priority
              - updated_at
              - affected_count
              - cvss_score
              - last_seen_at
            type: string
        - description: Sort direction
          in: query
          name: sort_order
          required: false
          schema:
            default: desc
            enum:
              - asc
              - desc
            type: string
        - description: Filter to issues belonging to this project
          in: query
          name: project_id
          required: false
          schema:
            format: uuid
            type: string
        - description: Filter to issues associated with this task ID
          in: query
          name: task_id
          required: false
          schema:
            type: string
        - description: Filter by creator email (exact match, useful for team-scoped views)
          in: query
          name: created_by
          required: false
          schema:
            format: email
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IssueListResponse'
          description: Paginated list of issues
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal server error
components:
  schemas:
    IssueSeverity:
      enum:
        - critical
        - high
        - medium
        - low
        - info
        - unknown
      type: string
    IssueStatus:
      enum:
        - unverified
        - open
        - confirmed
        - in_progress
        - resolved
        - false_positive
        - accepted_risk
        - duplicate
      type: string
    IssueType:
      enum:
        - vulnerability
        - misconfiguration
        - exposure
        - information
        - compliance
        - other
      type: string
    IssuePriority:
      enum:
        - critical
        - high
        - medium
        - low
        - none
      type: string
    IssueConfidence:
      enum:
        - confirmed
        - firm
        - tentative
      type: string
    IssueListResponse:
      properties:
        has_more:
          type: boolean
        issues:
          items:
            $ref: '#/components/schemas/Issue'
          type: array
        page:
          type: integer
        per_page:
          type: integer
        total:
          type: integer
      required:
        - issues
        - total
        - page
        - per_page
        - has_more
      type: object
    ErrorResponse:
      properties:
        code:
          description: >
            Stable machine-readable error code — branch on this rather than

            matching the human `error`/`message` strings. Domain codes include

            `user_spending_cap_reached`, `project_spending_cap_reached`, and

            `insufficient_neo_credits`; otherwise it mirrors the error kind

            (e.g. `forbidden`, `invalid_request`, `not_exists`,
            `already_exists`).
          example: user_spending_cap_reached
          type: string
        error:
          example: Bad request
          type: string
        error_id:
          description: Correlation id for a specific error instance, when present.
          type: string
        kind:
          description: Coarse error category (e.g. "forbidden request", "invalid request").
          example: forbidden request
          type: string
        message:
          description: |
            Human-readable detail (the kind prefixed to the error). For display,
            not for branching.
          type: string
      required:
        - error
      type: object
    Issue:
      properties:
        affected_assets:
          description: Populated on detail view (GET /issues/:id). NULL on list view.
          items:
            $ref: '#/components/schemas/IssueAsset'
          nullable: true
          type: array
        affected_count:
          default: 0
          description: Number of affected assets tracked for the issue.
          type: integer
        assignee:
          nullable: true
          type: string
        component:
          nullable: true
          type: string
        confidence:
          $ref: '#/components/schemas/IssueConfidence'
        created_at:
          format: date-time
          type: string
        created_by:
          description: Email of the user who created this issue
          type: string
        cve_ids:
          items:
            type: string
          type: array
        cvss_score:
          description: CVSS score 0.0-10.0 as string (numeric)
          nullable: true
          type: string
        cwe_ids:
          items:
            type: string
          type: array
        description:
          nullable: true
          type: string
        due_date:
          format: date-time
          nullable: true
          type: string
        evidence:
          items:
            $ref: '#/components/schemas/IssueEvidenceItem'
          type: array
        evidence_schema_version:
          $ref: '#/components/schemas/IssueEvidenceSchemaVersion'
        false_positive_reason:
          description: Reason this issue was marked as false positive.
          nullable: true
          type: string
        fingerprint:
          description: >-
            Content-stable hash for cross-run dedup. Server matches (source,
            ticket_id, fingerprint) tuple on bulk insert.
          nullable: true
          type: string
        host:
          nullable: true
          type: string
        id:
          format: uuid
          type: string
        impact:
          description: Business and technical impact of the finding.
          nullable: true
          type: string
        ip_address:
          nullable: true
          type: string
        labels:
          additionalProperties: true
          type: object
        last_seen_at:
          description: When the issue was last observed or re-confirmed by a scan.
          format: date-time
          nullable: true
          type: string
        metadata:
          additionalProperties: true
          type: object
        port:
          nullable: true
          type: integer
        priority:
          $ref: '#/components/schemas/IssuePriority'
        project_id:
          description: Project this issue belongs to (null = personal/unscoped).
          format: uuid
          nullable: true
          type: string
        protocol:
          nullable: true
          type: string
        raw_data:
          additionalProperties: true
          type: object
        reference_urls:
          items:
            type: string
          type: array
        remediation:
          description: Actionable remediation guidance.
          nullable: true
          type: string
        reproduction_steps:
          description: Ordered steps to reproduce the finding.
          items:
            type: string
          type: array
        resolved_at:
          format: date-time
          nullable: true
          type: string
        resolved_by:
          nullable: true
          type: string
        risk_acceptance_reason:
          description: Reason the risk was accepted.
          nullable: true
          type: string
        severity:
          $ref: '#/components/schemas/IssueSeverity'
        slug:
          description: >-
            Human-readable sequential identifier (e.g. ISSUE-1, ISSUE-2).
            Auto-assigned on creation.
          example: ISSUE-42
          type: string
        source:
          description: Source of the issue (e.g. nuclei, agent, burp, snyk, manual, etc.)
          type: string
        status:
          $ref: '#/components/schemas/IssueStatus'
        tags:
          items:
            type: string
          type: array
        target:
          description: What is affected (host, ARN, app, file:line, etc.)
          nullable: true
          type: string
        target_type:
          default: host
          description: >-
            Category of target (host, cloud_resource, app, code, container,
            dependency, api, certificate)
          type: string
        task_id:
          nullable: true
          type: string
        task_title:
          nullable: true
          type: string
        template_id:
          nullable: true
          type: string
        ticket_id:
          description: External ticket ID or key.
          nullable: true
          type: string
        ticket_url:
          description: Link to external ticket (Jira, Linear, GitHub issue, etc.)
          nullable: true
          type: string
        title:
          type: string
        type:
          $ref: '#/components/schemas/IssueType'
        updated_at:
          format: date-time
          type: string
        url:
          nullable: true
          type: string
      required:
        - id
        - created_by
        - title
        - severity
        - priority
        - confidence
        - status
        - type
        - source
        - created_at
        - updated_at
      type: object
    IssueAsset:
      properties:
        asset_owner:
          description: >-
            Who is responsible for this asset — email address, team name, cloud
            account ID, or any identifier that helps track down the right
            person/team to remediate it
          nullable: true
          type: string
        created_by:
          description: Email of the user who added this asset
          type: string
        first_seen:
          format: date-time
          type: string
        host:
          nullable: true
          type: string
        id:
          format: uuid
          type: string
        ip_address:
          nullable: true
          type: string
        issue_id:
          format: uuid
          type: string
        last_seen:
          format: date-time
          type: string
        matcher_name:
          description: Template match name (e.g. nuclei matcher)
          nullable: true
          type: string
        metadata:
          additionalProperties: true
          type: object
        port:
          nullable: true
          type: integer
        status:
          default: open
          enum:
            - open
            - fixed
            - ignored
          type: string
        target:
          description: Generic target identifier (ARN, bundle ID, repo path, etc.)
          nullable: true
          type: string
        target_type:
          default: host
          type: string
        url:
          nullable: true
          type: string
      required:
        - id
        - issue_id
        - created_by
        - target_type
        - status
        - first_seen
        - last_seen
      type: object
    IssueEvidenceItem:
      additionalProperties: true
      properties:
        caption:
          description: Human-readable caption for any artifact type.
          type: string
        command:
          description: Shell or tool command (command_output).
          type: string
        file:
          description: Source file path (code_reference).
          type: string
        line:
          description: Line number (code_reference).
          type: integer
        output:
          description: Command or tool output (command_output).
          type: string
        request:
          description: Raw HTTP request (http_exchange).
          type: string
        response:
          description: Raw HTTP response (http_exchange).
          type: string
        snippet:
          description: Code excerpt (code_reference).
          type: string
        type:
          $ref: '#/components/schemas/IssueEvidenceType'
        url:
          description: Screenshot or artifact URL (screenshot).
          type: string
      required:
        - type
      type: object
    IssueEvidenceSchemaVersion:
      default: 1
      description: Version of the structured evidence item format. Supported value is 1.
      enum:
        - 1
      type: integer
    IssueEvidenceType:
      description: Evidence artifact type for structured issue proof bundles.
      enum:
        - http_exchange
        - command_output
        - code_reference
        - screenshot
        - other
      type: string

````