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

# Get alert

> Retrieve alerts. Omit the alert ID to fetch all alerts, or include it to retrieve a specific alert.

Retrieve alerts from your workspace. If you don't include an alert ID in the path, the endpoint returns all alerts.

***

### Request structure

<RequestExample>
  ```bash cURL theme={"system"}
  # Get all alerts
  curl -X GET 'https://api.cloud.blnkfinance.com/alerts' \
    -H 'Authorization: Bearer YOUR_API_KEY'

  # Get specific alert by ID
  curl -X GET 'https://api.cloud.blnkfinance.com/alerts/ano_8a380fd1-0289-46d1-bc76-aa17a510a64e' \
    -H 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ParamField path="alert_id" type="string">
  Optional. Unique identifier for a specific alert to retrieve. Omit to retrieve all alerts.
</ParamField>

### Response structure

<ResponseExample>
  ```json Success theme={"system"}
  {
    "anomaly_id": "ano_8a380fd1-0289-46d1-bc76-aa17a510a64e",
    "title": "An identity has been flagged in a sanction list.",
    "description": "this is a test",
    "type": "Balance",
    "assigned_to": "jerrys enebeli",
    "escalated_to": [
      "user_01K4EX0BRXHNNGCRVT2TPNK07W"
    ],
    "status": "FLAGGED",
    "created_at": "2026-01-15T09:22:37.55763+01:00",
    "updated_at": "2026-01-15T09:26:03.094425+01:00",
    "affected_balances": [
      "bln_20f02af6-3728-4d37-9b5a-c7ed080f09df"
    ],
    "affected_identities": [],
    "affected_transactions": []
  }
  ```
</ResponseExample>

<ResponseField name="anomaly_id" type="string" required>
  Unique identifier for the alert.
</ResponseField>

<ResponseField name="title" type="string">
  The title of the alert, if provided.
</ResponseField>

<ResponseField name="description" type="string" required>
  The description of the alert.
</ResponseField>

<ResponseField name="type" type="string" required>
  The type or category of the alert (e.g., "Balance", "Transaction", "Identity").
</ResponseField>

<ResponseField name="assigned_to" type="string">
  The name or identifier of the user assigned to handle the alert.
</ResponseField>

<ResponseField name="escalated_to" type="array">
  Array of user identifiers to whom the alert has been escalated.
</ResponseField>

<ResponseField name="status" type="string" required>
  The current status of the alert (e.g., "FLAGGED").
</ResponseField>

<ResponseField name="created_at" type="timestamp" required>
  ISO 8601 formatted timestamp of when the alert was created.
</ResponseField>

<ResponseField name="updated_at" type="timestamp" required>
  ISO 8601 formatted timestamp of when the alert was last updated.
</ResponseField>

<ResponseField name="affected_balances" type="array" required>
  Array of balance IDs affected by this alert.
</ResponseField>

<ResponseField name="affected_identities" type="array" required>
  Array of identity IDs affected by this alert.
</ResponseField>

<ResponseField name="affected_transactions" type="array" required>
  Array of transaction IDs affected by this alert.
</ResponseField>

***

## Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).

**Need help with your product?**

Get dedicated support for architecture reviews, integration planning, ledger workflows, and production deployment.