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

# Get Threat

Retrieve threat information for the given threat ID.

**Note:** Requires the `ReadOnly` role or higher.

<Note>
  External Documentation

  To learn more, visit the [Halcyon documentation](https://api.halcyon.ai/docs/index.html#operation/Get%20Threat).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter | Description                       |
  | --------- | --------------------------------- |
  | Threat ID | The ID of the threat to retrieve. |
</div>

## Example Output

```json theme={"dark"}
{
	"data": {
		"allowed": true,
		"available": true,
		"certificate_list": [
			{
				"certificate_chain": [
					{
						"certificate_id": "string",
						"index": 0,
						"issuer": "string",
						"subject": "string"
					}
				],
				"id": "string",
				"type": "CodeSigning",
				"valid_from": "2019-08-24T14:15:22Z",
				"valid_to": "2019-08-24T14:15:22Z"
			}
		],
		"file_size": "string",
		"file_type": "string",
		"id": "string",
		"md5": "string",
		"name": "string",
		"sha1": "string"
	},
	"errors": [
		"string"
	],
	"pagination": {
		"first_page": 0,
		"last_page": 0,
		"next_page": 0,
		"page": 0,
		"previous_page": 0,
		"total": 0,
		"total_pages": 0
	},
	"success": true
}
```

## Workflow Library Example

[Get Threat with Halcyon and Send Results Via Email](https://library.blinkops.com/workflows/get-threat-with-halcyon-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/get-threat-with-halcyon-and-send-results-via-email/canvas" />
</div>