---
title: "List issues"
method: GET
path: "/issues"
tags: ["Issues"]
---

# List issues

`GET /issues`

List issues on a domain (paginated).
Returns a paginated list of issues that the authenticated app has
permission to view, optionally filtered and sorted.

## Query parameters

- `pageSize` integer — Controls the maximum number of items returned in one response from the API.
- `pageCursor` string — A marker or pointer, telling the API where to start fetching items for the subsequent page in a paginated dataset. Note that the requested page will not include the item that corresponds to this cursor but will start from the one immediately after this cursor.
- `search` string
- `readableIssueIdMatchesAny` string[]
- `statusMatchesAny` IssueStatus[]
- `severityMatchesAny` IssueSeverity[]
- `sourceMatchesAny` SourceType[]
- `typeMatchesAny` StandardIssueType[]
- `ownerIdMatchesAny` string[]
- `templateMatchesAny` IssueTemplate[]
- `closeReasonMatchesAny` ClosedReason[]
- `closedAfterDate` string, date-time
- `closedBeforeDate` string, date-time
- `includeIssuesWithoutDueDate` boolean
- `includeOnlyIssuesWithoutDueDate` boolean
- `dueAfterDate` string, date-time
- `dueBeforeDate` string, date-time
- `detectedAfterDate` string, date-time
- `detectedBeforeDate` string, date-time
- `createdAfterDate` string, date-time
- `createdBeforeDate` string, date-time
- `auditIdMatchesAny` string[]
- `controlIdMatchesAny` string[]
- `orderBy` 'dueDate' | 'createdDate' | 'detectedDate' | 'lastModifiedDate' | 'status' | 'severity'
- `orderDirection` 'asc' | 'desc' — `"asc"` for ascending, `"desc"` for descending.

## Response `200`

Ok

- PaginatedResponseIssue
  - `results` object, required
    - `data` Issue[], required
      - union
        - StandardIssue
          - `id` string, required
          - `readableIssueId` string, required
          - `createdDate` string, date-time, required
          - `createdBy` Actor, required
            - `actorType` 'USER' | 'WORKFLOW_GENERATED', required
            - `actorId` string, required
          - `lastModifiedBy` Actor, required
            - `actorType` 'USER' | 'WORKFLOW_GENERATED', required
            - `actorId` string, required
          - `lastModifiedDate` string, date-time, required
          - `title` string, required
          - `description` string, required
          - `owners` IssueOwner[], required
            - `ownerType` 'USER' | 'TEAM', required
            - `ownerId` string, required
          - `severity` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW' | 'NO_SEVERITY', required
          - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'CLOSED', required
          - `rootCause` string, nullable, required
          - `correctiveAction` string, nullable, required
          - `dueDate` string, date-time, nullable, required
          - `source` Source, required
            - `sourceType` 'AUDIT' | 'AUDIT_EXTERNAL' | 'INCIDENT' | 'EXTERNAL_PARTY' | 'SELF_ASSESSMENT' | 'OTHER', required
            - `sourceId` string
          - `controlDomain` string, nullable, required
          - `closedMetadata` ClosedMetadata, required
            - `reason` 'RESOLVED' | 'DUPLICATE' | 'ACCEPTED' | 'OTHER', required
            - `comment` string, required
            - `closedAt` string, date-time, required
          - `detectedDate` string, date-time, required
          - `mappedControlIds` string[], required
          - `mappedRiskScenarioIds` string[], required
          - `mappedPolicyIds` string[], required
          - `customFields` IssueCustomField[], required
            - `label` string, required
            - `value` union, required
              - …
          - `template` 'STANDARD_ISSUE', required — Extract from T those types that are assignable to U
          - `type` 'AREA_OF_CONCERN' | 'MAJOR_NONCONFORMITY' | 'MINOR_NONCONFORMITY' | 'OPP_FOR_IMPROVEMENT' | 'EXCEPTION' | 'PROCESS_FOR_IMPROVEMENT', required
        - StandardPOAM
          - `id` string, required
          - `readableIssueId` string, required
          - `createdDate` string, date-time, required
          - `createdBy` Actor, required
            - `actorType` 'USER' | 'WORKFLOW_GENERATED', required
            - `actorId` string, required
          - `lastModifiedBy` Actor, required
            - `actorType` 'USER' | 'WORKFLOW_GENERATED', required
            - `actorId` string, required
          - `lastModifiedDate` string, date-time, required
          - `title` string, required
          - `description` string, required
          - `owners` IssueOwner[], required
            - `ownerType` 'USER' | 'TEAM', required
            - `ownerId` string, required
          - `severity` 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW' | 'NO_SEVERITY', required
          - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'CLOSED', required
          - `rootCause` string, nullable, required
          - `correctiveAction` string, nullable, required
          - `dueDate` string, date-time, nullable, required
          - `source` Source, required
            - `sourceType` 'AUDIT' | 'AUDIT_EXTERNAL' | 'INCIDENT' | 'EXTERNAL_PARTY' | 'SELF_ASSESSMENT' | 'OTHER', required
            - `sourceId` string
          - `controlDomain` string, nullable, required
          - `closedMetadata` ClosedMetadata, required
            - `reason` 'RESOLVED' | 'DUPLICATE' | 'ACCEPTED' | 'OTHER', required
            - `comment` string, required
            - `closedAt` string, date-time, required
          - `detectedDate` string, date-time, required
          - `mappedControlIds` string[], required
          - `mappedRiskScenarioIds` string[], required
          - `mappedPolicyIds` string[], required
          - `customFields` IssueCustomField[], required
            - `label` string, required
            - `value` union, required
              - …
          - `template` 'STANDARD_POAM', required — Extract from T those types that are assignable to U
          - `requiredResources` string, nullable, required
          - `systemsDescription` string, nullable, required
    - `pageInfo` PageInfo, required — Provides information about the pagination of a dataset.
      - `endCursor` string, nullable, required — The cursor that points to the end of the current page, or null if there is no such cursor.
      - `hasNextPage` boolean, required — Indicates if there is another page after the current page.
      - `hasPreviousPage` boolean, required — Indicates if there is a page before the current page.
      - `startCursor` string, nullable, required — The cursor that points to the start of the current page, or null if there is no such cursor.

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/revisions/6c1f7590538b/schema)