---
title: List New Relic issues
source: https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/newrelic/issue/newrelic-issue-list
---

Queries and lists New Relic Alert Intelligence issues for an account with optional filtering and pagination.

For prerequisites, see [New Relic Issue actions](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/newrelic/issue/newrelic-issue#prerequisites).

## List issues

The action identifier is `newrelic.issue.list`.

Queries and lists New Relic issues (AI Issues) for an account, returning real-time status, timeline, correlated entities, and impact details for active or past issues. Supports filtering by state, priority, source, entity, condition, policy, correlation and acknowledgment status, a time window, and cursor-based pagination. Built on `newrelic.nerdgraph.execute`.

### Inputs

The following table describes all available input fields for this action.

| Input              | Type    | Description                                                                                                                                                      | Example                                                                                                                                                                                    |
| ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **accountId**      | Int     | **Required.** The New Relic account whose issues to list. Must be a positive integer.                                                                            | `123456`                                                                                                                                                                                   |
| **issueIds**       | List    | **Optional.** Issue IDs to include. Must be a JSON array of UUID strings.                                                                                        | `["123e4567-e89b-12d3-a456-426614174000"]`                                                                                                                                                 |
| **states**         | List    | **Optional.** One or more of `ACTIVATED`, `CLOSED`, `CREATED`, `DEACTIVATED`.                                                                                    | `["ACTIVATED", "CREATED"]`                                                                                                                                                                 |
| **priority**       | List    | **Optional.** One or more of `CRITICAL`, `HIGH`, `MEDIUM`, `LOW`.                                                                                                | `["CRITICAL", "HIGH"]`                                                                                                                                                                     |
| **sources**        | List    | **Optional.** One or more of `newrelic` (raised by New Relic's alerting engine) or `rest` (created externally via the REST API).                                 | `["newrelic"]`                                                                                                                                                                             |
| **entityGuids**    | List    | **Optional.** Entity GUIDs to filter by.                                                                                                                         | `["MTIzNDU2..."]`                                                                                                                                                                          |
| **entityTypes**    | List    | **Optional.** Entity types to filter by.                                                                                                                         | `["APPLICATION"]`                                                                                                                                                                          |
| **conditionIds**   | List    | **Optional.** Alert condition IDs to filter by. Must be a JSON array of integers.                                                                                | `[10001, 10002]`                                                                                                                                                                           |
| **policyIds**      | List    | **Optional.** Alert policy IDs to filter by. Must be a JSON array of integers.                                                                                   | `[5001]`                                                                                                                                                                                   |
| **isAcknowledged** | Boolean | **Optional.** Acknowledgment status filter. `true` for acknowledged issues only. `false` for unacknowledged issues only.                                         | `false`                                                                                                                                                                                    |
| **isCorrelated**   | Boolean | **Optional.** Indicates whether New Relic's Applied Intelligence has merged this issue with other related issues to reduce noise.                                | `false`                                                                                                                                                                                    |
| **mutingStates**   | List    | **Optional.** Notification suppression status. One or more of `NOT_MUTED`, `FULLY_MUTED`, or `PARTIALLY_MUTED`.                                                  | `["NOT_MUTED"]`                                                                                                                                                                            |
| **contains**       | String  | **Optional.** Case-sensitive, free-text match on key issue attributes.                                                                                           | `"checkout-service"`                                                                                                                                                                       |
| **startTime**      | Int     | **Optional.** Time window start, epoch milliseconds. Must be non-negative. Requires `endTime` — both fields must be present for the time window filter to apply. | `1785900000000`                                                                                                                                                                            |
| **endTime**        | Int     | **Optional.** Time window end, epoch milliseconds. Must be non-negative. Requires `startTime` — both fields must be present for the time window filter to apply. | `1785998400000`                                                                                                                                                                            |
| **cursor**         | String  | **Optional.** Opaque pagination token from a prior call's `nextCursor` output. Retrieves the next page of results.                                               | `"eyJpZCI6IjE..."`                                                                                                                                                                         |
| **selectors**      | List    | **Optional.** JQ selectors to extract specific values from the response.                                                                                         | ```yaml selectors:   - name: issues     expression: ".data.actor.account.aiIssues.issues.issues"   - name: nextCursor     expression: ".data.actor.account.aiIssues.issues.nextCursor" ``` |

### Outputs

The following table describes all output fields returned by this action.

| Output           | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **success**      | Boolean | `true` when the step executed without an HTTP/transport error.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **errorMessage** | String  | Contains an error message only when the call fails at the HTTP/transport level. `null` on success.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **data**         | Map     | NerdGraph response. Contains `data.actor.account.aiIssues.issues.issues` (array of issue objects) and `data.actor.account.aiIssues.issues.nextCursor` (`null` when no further pages exist). The following is a representative subset of the response — each issue carries the full `AiIssuesIssue` field set: `issueId`, `title`, `description`, `priority`, `state`, `createdAt`, `updatedAt`, `closedAt`, `activatedAt`, `acknowledgedAt/By/ByChannel`, `closedBy/ByChannel`, `investigatedAt/By/ByChannel`, `unAcknowledgedAt/By/ByChannel`, `sources`, `origins`, `entityGuids/Names/Types`, `conditionName/FamilyId/Product`, `policyIds/Name`, `correlationRuleIds/Names/Descriptions`, `correlationStatus`, `correlatedBy`, `isCorrelated`, `isIdle`, `mutingState`, `totalIncidents`, `incidentIds`, `deepLinkUrl`, `accountIds`, `parentMergeId`, `mergeReason`, `eventType`, `wildcard`, `dataMlModules` (list of key/value pairs), and `realIssueCount`. Use `selectors` to extract specific values. ```json {   "data": {     "actor": {       "account": {         "aiIssues": {           "issues": {             "issues": [               {                 "issueId": "123e4567-e89b-12d3-a456-426614174000",                 "title": ["Example issue title"],                 "state": "ACTIVATED",                 "priority": "CRITICAL",                 "entityNames": ["example-entity"]               }             ],             "nextCursor": null           }         }       }     }   } } ``` |

### Example

The following examples show how to use this action with different filter configurations.

| Workflow example                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No filters — list every issue on the account, regardless of state, priority, or other filters. Only `accountId` is required: ```yaml name: newrelic_issue_list_all description: list all issues for an account with no filters steps:   - name: newrelic_issue_list     type: action     action: newrelic.issue.list     version: 1     inputs:       accountId: 123456     next: end ``` The following example uses basic filters to list active, high-priority issues for an account: ```yaml name: newrelic_issue_list_workflow description: list newrelic issues steps:   - name: newrelic_issue_list     type: action     action: newrelic.issue.list     version: 1     inputs:       accountId: 123456       states: ["ACTIVATED", "CREATED"]       priority: ["CRITICAL", "HIGH"]     next: end ``` The following example uses multiple filters for unacknowledged, unmuted, critical issues within a specific time window, with selectors flattening the response for pagination: ```yaml name: newrelic_issue_list_advanced description: list unacknowledged critical issues in a time window steps:   - name: newrelic_issue_list     type: action     action: newrelic.issue.list     version: 1     inputs:       accountId: 123456       states: ["ACTIVATED"]       priority: ["CRITICAL"]       isAcknowledged: false       mutingStates: ["NOT_MUTED"]       startTime: 1785900000000       endTime: 1785998400000       selectors:         - name: issues           expression: ".data.actor.account.aiIssues.issues.issues"         - name: nextCursor           expression: ".data.actor.account.aiIssues.issues.nextCursor"     next: end ``` To page through additional results from the third example, take the `nextCursor` output and pass it back in as the `cursor` input on a follow-up call. |
