> ## 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 Findings

List and query all findings in a given organization.

<Note>
  External Documentation

  To learn more, visit the [Cobalt documentation](https://cobalt-public-api.netlify.app/v2/#get-all-findings).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter       | Description                                                                                          |
  | --------------- | ---------------------------------------------------------------------------------------------------- |
  | Asset ID        | Returns findings scoped to the asset id. Can be obtained by the `List Assets` action.                |
  | Organization ID | The ID of the organization the assets belong to. Can be obtained by the `List Organizations` action. |
  | Pentest ID      | Returns findings scoped to this pentest id. Can be obtained by the `List Pentests` action.           |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter             | Description                                                                                      |
  | --------------------- | ------------------------------------------------------------------------------------------------ |
  | Created after         | Returns findings that were created after the given date.                                         |
  | Created before        | Returns findings that were created before the given date.                                        |
  | Cursor                | Specifies the pagination cursor for the next page.                                               |
  | Image Attachment Type | Returns image attachments with the specified render format.                                      |
  | Label                 | Returns findings with specified labels. Multiple labels can be passed in a comma separated list. |
  | Limit                 | Number of results per page, valid range is 1-100.                                                |
  | Severity              | Returns findings at the chosen severity.                                                         |
  | Sort                  | Returns findings sorted by chosen property.                                                      |
  | State                 | Returns findings at the chosen state.                                                            |
  | Updated after         | Returns findings that were updated after the given date.                                         |
  | Updated before        | Returns findings that were updated before the given date.                                        |
</div>

## Example Output

```json theme={"dark"}
{
	"data": [
		{
			"resource": {
				"id": "vl_3sP2RCWWUajc3oRXmbQ4j9",
				"tag": "#PT3334_37",
				"title": "XSS vulnerability",
				"description": "Cross-Site Scripting (XSS) attacks are a type of injection, in which malicious scripts...",
				"type_category": "Cross-Site Scripting (XSS)",
				"labels": [
					{
						"name": "Your label"
					}
				],
				"impact": 5,
				"likelihood": 4,
				"severity": "high",
				"affected_targets": [
					"https://example.com",
					"192.168.1.1"
				],
				"proof_of_concept": "Here you can see...",
				"severity_justification": "The vulnerability can cause a lot of damage",
				"suggested_fix": "Ensure this...",
				"prerequisites": "Credentials are needed",
				"pentest_id": "pt_PEtv4dqnwGV2efZhLw3BM5",
				"http_request": "HTTP GET / ...",
				"asset_id": "as_HcChCMueiPQQgvckmZtRSd",
				"log": [
					{
						"action": "created",
						"timestamp": "2021-04-01T15:13:24.322Z"
					},
					{
						"action": "likelihood_changed",
						"value": 4,
						"timestamp": "2021-04-01T15:14:05.856Z"
					},
					{
						"action": "impact_changed",
						"value": 5,
						"timestamp": "2021-04-01T15:14:05.856Z"
					},
					{
						"action": "state_changed",
						"value": "need_fix",
						"timestamp": "2021-04-01T15:14:06.757Z"
					},
					{
						"action": "state_changed",
						"value": "check_fix",
						"timestamp": "2021-04-01T15:14:57.845Z"
					}
				],
				"state": "check_fix",
				"created_at": "2022-09-26T18:35:18.759Z",
				"updated_at": "2022-09-26T18:36:57.462Z",
				"attachments": [
					{
						"id": "at_LA5GcEL4HRitFGCHREqmzL",
						"file_name": "rainbow.jpeg",
						"download_url": "https://s3.amazonaws.com/acmecorp/uploads/attachment/file/12345/rainbow.jpeg?something=1"
					}
				]
			},
			"links": {
				"ui": {
					"url": "https://api.us.cobalt.io/links/eyJ0eXBlIjoic29tZXRoaW5nIiwib3JnU2x1ZyI6ImNvYmFsdCIsInBlbnRlc3RUYWciOiJz="
				}
			}
		}
	],
	"pagination": {
		"next_page": "/findings?cursor=a1b2c3d4",
		"prev_page": "/findings?cursor=4d3c2b1a"
	}
}
```

## Workflow Library Example

[List Findings with Cobalt and Send Results Via Email](https://library.blinkops.com/workflows/list-findings-with-cobalt-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-findings-with-cobalt-and-send-results-via-email/canvas" />
</div>