# Issues#ListIssues

List a collection of Security Issues

Endpoint: GET /sto/api/v2/issues
Version: 1.0
Security: 

## Query parameters:

  - `accountId` (string, required)
    Harness Account ID
    Example: "abcdef1234567890ghijkl"

  - `page` (integer)
    Page number to fetch (starting from 0)
    Example: 4

  - `pageSize` (integer)
    Number of results per page
    Example: 50

  - `productId` (string)
    Issue product ID
    Example: "abcdef1234567890ghijkl"

  - `key` (string)
    Compression/deduplication key
    Example: "json-schema@0.2.3"

  - `excludeOccurrences` (boolean)
    Example: true

## Header parameters:

  - `X-Api-Key` (string)
    Harness personal or service access token
    Example: "Consequuntur adipisci dicta adipisci sequi alias quasi."

## Response 200 fields (application/json):

  - `pagination` (object, required)
    Example: {"link":"","page":4,"pageSize":20,"totalItems":230,"totalPages":12}

  - `pagination.link` (string)
    Link-based paging

  - `pagination.page` (integer, required)
    Page number (starting from 0)
    Example: 4

  - `pagination.pageSize` (integer, required)
    Requested page size
    Example: 20

  - `pagination.totalItems` (integer, required)
    Total results available
    Example: 230

  - `pagination.totalPages` (integer, required)
    Total pages available
    Example: 12

  - `results` (array, required)
    Example: [{"baseImageName":"baseImageName","baselineVariantId":"abcdef1234567890ghijkl","created":1651578240,"currentStatus":"Approved","details":{"package":"json-schema","version":"v0.2.3"},"epssLastModified":"2025-05-01","epssPercentile":0.15,"epssScore":0.035,"exemptionCoverage":"PartiallyExempted","exemptionId":"abcdef1234567890ghijkl","exemptionStatusAtScan":"Expired","exploitability":"yes","fallbackSeverityCode":"High","gracePeriodDays":13,"harnessAugmentation":{"Eius vero necessitatibus id reiciendis error facere.":"Non facilis reiciendis sed."},"id":"abcdef1234567890ghijkl","key":"json-schema@0.2.3","numOccurrences":10,"occurrenceId":12345,"occurrences":[{"line":"42"},{"line":"666"}],"originStatus":"approved","origins":["app","base"],"overrides":[{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"}],"overridesAtScan":[{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"}],"productId":"product1234567890abcde","reachability":"reachable","severity":8.5,"severityCode":"High","status":"Remediated","subproduct":"product","targetId":"abcdef1234567890ghijkl","targetName":"abcdef1234567890ghijkl","targetType":"repository","targetVariantId":"abcdef1234567890ghijkl","targetVariantName":"nodegoat:master","title":"Semgrep Finding: generic.secrets.security.detected-bcrypt-hash.detected-bcrypt-hash","type":"SAST"},{"baseImageName":"baseImageName","baselineVariantId":"abcdef1234567890ghijkl","created":1651578240,"currentStatus":"Approved","details":{"package":"json-schema","version":"v0.2.3"},"epssLastModified":"2025-05-01","epssPercentile":0.15,"epssScore":0.035,"exemptionCoverage":"PartiallyExempted","exemptionId":"abcdef1234567890ghijkl","exemptionStatusAtScan":"Expired","exploitability":"yes","fallbackSeverityCode":"High","gracePeriodDays":13,"harnessAugmentation":{"Eius vero necessitatibus id reiciendis error facere.":"Non facilis reiciendis sed."},"id":"abcdef1234567890ghijkl","key":"json-schema@0.2.3","numOccurrences":10,"occurrenceId":12345,"occurrences":[{"line":"42"},{"line":"666"}],"originStatus":"approved","origins":["app","base"],"overrides":[{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"}],"overridesAtScan":[{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"}],"productId":"product1234567890abcde","reachability":"reachable","severity":8.5,"severityCode":"High","status":"Remediated","subproduct":"product","targetId":"abcdef1234567890ghijkl","targetName":"abcdef1234567890ghijkl","targetType":"repository","targetVariantId":"abcdef1234567890ghijkl","targetVariantName":"nodegoat:master","title":"Semgrep Finding: generic.secrets.security.detected-bcrypt-hash.detected-bcrypt-hash","type":"SAST"}]

  - `results.baseImageName` (string)
    base image name of the issue
    Example: "baseImageName"

  - `results.baselineVariantId` (string)
    The Baseline Target Variant related to this Security Issue
    Example: "abcdef1234567890ghijkl"

  - `results.created` (integer, required)
    Unix timestamp at which the resource was created
    Example: 1651578240

  - `results.currentStatus` (string)
    Current status of the Exemption
    Enum: "Pending", "Approved", "Rejected", "Expired"

  - `results.details` (object, required)
    Issue details common to all occurrences
    Example: {"package":"json-schema","version":"v0.2.3"}

  - `results.epssLastModified` (string)
    Last date the issue EPSS data was last modified
    Example: "2025-05-01"

  - `results.epssPercentile` (number)
    EPSS percentile of the issue CVE identifier
    Example: 0.15

  - `results.epssScore` (number)
    EPSS score of the issue CVE identifier
    Example: 0.035

  - `results.exemptionCoverage` (string)
    Indicates if the Security Issue was found to be Exempted or PartiallyExempted.
    Example: "PartiallyExempted"

  - `results.exemptionId` (string)
    ID of Security Test Exemption
    Example: "abcdef1234567890ghijkl"

  - `results.exemptionStatusAtScan` (string)
    Exemption's status at the Security Scan created time
    Enum: "Pending", "Approved", "Rejected", "Expired"

  - `results.exploitability` (string)
    Exploitability status of the issue (yes or no)
    Example: "yes"

  - `results.fallbackSeverityCode` (string)
    Issue-table severity code used as occurrence fallback at read time; omitted from API responses
    Enum: "Critical", "High", "Medium", "Low", "Info", "Unassigned"

  - `results.gracePeriodDays` (integer)
    Issue-level grace period rollup in days. Only populated when scan honorGracePeriod is enabled.
    Example: 13

  - `results.harnessAugmentation` (object)
    Harness Augmentation details
    Example: {"Assumenda qui totam eveniet quidem doloremque.":"Et qui officiis distinctio.","Eum occaecati.":"Dolorem cum aut commodi consequatur voluptatem quia.","Perspiciatis odio laborum odio quasi hic.":"Occaecati rerum molestiae facere."}

  - `results.id` (string, required)
    Resource identifier
    Example: "abcdef1234567890ghijkl"

  - `results.key` (string, required)
    Compression/deduplication key
    Example: "json-schema@0.2.3"

  - `results.numOccurrences` (integer)
    Indicates the number of Occurrences on the Issue
    Example: 10

  - `results.occurrenceId` (integer)
    Example: 12345

  - `results.occurrences` (array)
    Array of details unique to each occurrence
    Example: [{"line":"42"},{"line":"666"}]

  - `results.originStatus` (string)
    The status of the origin, either 'approved' or 'unapproved'
    Example: "approved"

  - `results.origins` (array)
    The origins of the issue
    Example: ["app","base"]

  - `results.overrides` (array)
    List of issue overrides
    Example: [{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"}]

  - `results.overrides.created` (integer, required)
    Unix timestamp at which the resource was created
    Example: 1651578240

  - `results.overrides.fieldName` (string, required)
    Name of the field that is being overridden
    Example: "severityCode"

  - `results.overrides.impactedTargetId` (string)
    ID of the impacted target
    Example: "target1111111111111111"

  - `results.overrides.originalFieldValue` (string, required)
    Original value of the field that is being overridden
    Example: "Low"

  - `results.overrides.overrideFieldValue` (string, required)
    Value of the field that is being overridden
    Example: "Low"

  - `results.overrides.overrideId` (string)
    Override Id of the override
    Example: "override1234"

  - `results.overrides.reason` (string, required)
    Text describing why this override is necessary
    Example: "Waiting on upstream bug fix"

  - `results.overrides.requesterEmail` (string)
    Email of the user who requested this Exemption
    Example: "user@harness.io"

  - `results.overrides.requesterId` (string)
    User ID of the user who requested the override
    Example: "user111111111111111111"

  - `results.overrides.requesterName` (string)
    Name of the user who requested this Exemption
    Example: "firstname lastname"

  - `results.overridesAtScan` (array)
    List of issue overrides at scan time
    Example: [{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"},{"created":1651578240,"fieldName":"severityCode","impactedTargetId":"target1111111111111111","originalFieldValue":"Low","overrideFieldValue":"Low","overrideId":"override1234","reason":"Waiting on upstream bug fix","requesterEmail":"user@harness.io","requesterId":"user111111111111111111","requesterName":"firstname lastname"}]

  - `results.productId` (string, required)
    The scan tool that identified this Security Issue
    Example: "product1234567890abcde"

  - `results.reachability` (string)
    Reachability status of the issue (reachable or unreachable)
    Example: "reachable"

  - `results.severity` (number, required)
    Numeric severity, from 0 (lowest) to 10 (highest)
    Example: 8.5

  - `results.severityCode` (string, required)
    Severity code
    Enum: "Critical", "High", "Medium", "Low", "Info", "Unassigned"

  - `results.status` (string)
    Indicates if the Security Issue was found to be remediated, ignored, etc.
    Enum: "Remediated", "Compensating Controls", "Acceptable Use", "Acceptable Risk", "False Positive", "Fix Unavailable", "Exempted"

  - `results.subproduct` (string)
    The subproduct that identified this Security Issue
    Example: "product"

  - `results.targetId` (string)
    The Target that this Security Issue affects
    Example: "abcdef1234567890ghijkl"

  - `results.targetName` (string)
    The Name of the Target that this Security Issue affects
    Example: "abcdef1234567890ghijkl"

  - `results.targetType` (string)
    The type of the Target that this Security Issue affects
    Enum: "container", "repository", "instance", "configuration"

  - `results.targetVariantId` (string)
    The Target Variant that this Security Issue affects
    Example: "abcdef1234567890ghijkl"

  - `results.targetVariantName` (string)
    Name of the associated Target and Variant
    Example: "nodegoat:master"

  - `results.title` (string, required)
    Title of the Security Issue
    Example: "Semgrep Finding: generic.secrets.security.detected-bcrypt-hash.detected-bcrypt-hash"

  - `results.type` (string)
    The type of vulnerability or quality issue for this Issue
    Enum: "SAST", "DAST", "SCA", "IAC", "SECRET", "MISCONFIG", "BUG_SMELLS", "CODE_SMELLS", "CODE_COVERAGE", "EXTERNAL_POLICY"

## Response 400 fields (application/json):

  - `message` (string, required)
    Example: "Not Found"

  - `status` (integer)
    Example: 404


