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

Returns a paginated list of the observables.
**Note:**
The following permission is required:

* `INTHREAT_READ_OBSERVABLES` (dd62e001-60f5-464f-aa67-371ca9738e67).

<Note>
  External Documentation

  To learn more, visit the [Sekoia.io documentation](https://docs.sekoia.io/developer/api/#tag/Observables/get_observables_resource).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter         | Description                                      |
  | ----------------- | ------------------------------------------------ |
  | Observable ID     | Filter observables by their ID.                  |
  | Observable Name   | Filter observables by their name.                |
  | Observable Source | Filter observables by their source.              |
  | Observable Type   | Filter observables by their type.                |
  | Observable Value  | Filter observables by their value.               |
  | Return All Pages  | Automatically fetch all resources, page by page. |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                | Description                                                                        |
  | ------------------------ | ---------------------------------------------------------------------------------- |
  | Limit                    | The number of items to return. The allowed range is 1-2000. Default value is `20`. |
  | Observable Hash          | Filter observables by their hash.                                                  |
  | Observable Tag           | Filter observables by their tag.                                                   |
  | Observable Valid Tag     | Filter observables by their valid tag.                                             |
  | Offset                   | The number of items to skip when paginating. The allowed range is 0-10000.         |
  | Return Indicated Threats | Set to `True` if you would like to also retrieve indicated threats.                |
</div>

## Example Output

```json theme={"dark"}
{
	"items": [
		{
			"name": "string"
		}
	],
	"has_more": true
}
```

## Workflow Library Example

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