---
title: "Get the issues tagged with a countermeasure"
method: POST
path: "/api/v2/securityCompass/getLinkedIssues"
tags: ["Security Compass"]
---

# Get the issues tagged with a countermeasure

`POST /api/v2/securityCompass/getLinkedIssues`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/securityCompass/getLinkedIssues`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Requires current repository visibility for the mapped repository; inaccessible mappings return 404. Only issues belonging to that repository are returned. Read the ZeroPath issues currently linked to one SD Elements countermeasure of a mapping. Links are written by the findings results push after each scan, either deterministically (the issue was produced by the countermeasure’s generated natural-language rule) or via a CWE-prefiltered model match. Exactly one link per issue is the primary — the countermeasure the issue was reported against in SD Elements. Empty until a scan completes after the mapping is synced.

## Request body

- SecurityCompassGetLinkedIssuesRequest
  - `organizationId` string, required: Organization that owns the integration.
  - `mappingId` string, required: cuid of the project mapping whose links to read.
  - `taskId` string, required: Project-scoped SD Elements task id (as returned by securityCompass.getMappingAudit entries).

## Response `200`

The linked issues, primaries first

- SecurityCompassLinkedIssuesResponse: Issues tagged with one countermeasure. Tags are written by the findings push after each scan: an issue produced by the countermeasure’s generated natural-language rule links deterministically (matchMethod NL_RULE_FK); other issues are matched by a CWE-prefiltered model call (matchMethod LLM, with its rationale). Exactly one link per issue and mapping is the primary — the countermeasure the issue was reported against in SD Elements.
  - `repositoryId` string, required: ZeroPath repository the mapping targets.
  - `issues` object[], required: Linked issues, primaries first.
    - `issueId` string, required: cuid of the ZeroPath issue.
    - `title` string, required
    - `severity` number, required
    - `score` number, nullable, required
    - `issueStatus` string, required: Issue lifecycle status, e.g. PENDING_REVIEW, RESOLVED.
    - `matchMethod` 'NL_RULE_FK' | 'LLM', required: How the tag was established: deterministic natural-language-rule join, or the model-judged match.
    - `isPrimary` boolean, required: True on the single countermeasure this issue counts against in the SD Elements status push.
    - `rationale` string, nullable, required: Model reasoning for LLM matches; null for NL_RULE_FK links.

## Other responses

- `400`: Error Response
- `401`: Error Response
- `404`: Error Response
- `409`: Error Response

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api/revisions/126e9c80ba0d?raw)