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

# List Cases

List all cases with optional filtering.

Required permission to run this action: `cases:view`.

<Note>
  External Documentation

  To learn more, visit the [Artemis documentation](https://docs.goartemis.ai/external-api/cases#list-cases).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                            |
  | ---------------- | ------------------------------------------------------------------------------------------------------ |
  | Cursor           | The cursor used for pagination. Obtain this value from the `next_cursor` field in a previous response. |
  | Judgement        | Select the Artemis judgment to filter results by.                                                      |
  | Limit            | The maximum cases retrieved in a single execution. The valid range is `1`-`200`.                       |
  | Return All Pages | Automatically fetch all resources, page by page.                                                       |
  | Severity         | Select the case severity to filter results by.                                                         |
  | Status           | Select the case status to filter results by.                                                           |
</div>

## Example Output

```json theme={"dark"}
{
	"data": [
		{
			"id": "case-9f8a7b6c",
			"status": "open",
			"severity": "high",
			"title": "Suspicious IAM policy escalation",
			"created_at": "2026-04-07T14:23:00Z",
			"updated_at": "2026-04-08T09:11:42Z",
			"closed_at": null,
			"finding_ids": [
				"finding-1a2b",
				"finding-3c4d"
			],
			"sourcetypes": [
				"aws--cloudtrail"
			],
			"observables": [
				{
					"type": "ip",
					"value": "203.0.113.42",
					"count": 3
				}
			],
			"assets": [
				{
					"type": "user",
					"value": "dev-deploy-role",
					"count": 2
				}
			],
			"verdict": null,
			"artemis_judgement": "True Positive"
		}
	],
	"next_cursor": "eyJvZmZzZXQiOjIwfQ==",
	"has_more": true
}
```

## Workflow Library Example

[List Cases with Artemis and Send Results Via Email](https://library.blinkops.com/workflows/list-cases-with-artemis-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-cases-with-artemis-and-send-results-via-email/canvas" />
</div>