Skip to main content
GET
/
alerts
/
{alert_id}
# 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'

{
  "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": []
}

Documentation Index

Fetch the complete documentation index at: https://guide.cloud.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Request structure

# 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'
​
alert_id
string
Optional. Unique identifier for a specific alert to retrieve. Omit to retrieve all alerts.

​
Response structure

{
  "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": []
}
​
anomaly_id
string
required
Unique identifier for the alert.
​
title
string
The title of the alert, if provided.
​
description
string
required
The description of the alert.
​
type
string
required
The type or category of the alert (e.g., “Balance”, “Transaction”, “Identity”).
​
assigned_to
string
The name or identifier of the user assigned to handle the alert.
​
escalated_to
array
Array of user identifiers to whom the alert has been escalated.
​
status
string
required
The current status of the alert (e.g., “FLAGGED”).
​
created_at
timestamp
required
ISO 8601 formatted timestamp of when the alert was created.
​
updated_at
timestamp
required
ISO 8601 formatted timestamp of when the alert was last updated.
​
affected_balances
array
required
Array of balance IDs affected by this alert.
​
affected_identities
array
required
Array of identity IDs affected by this alert.
​
affected_transactions
array
required
Array of transaction IDs affected by this alert.

​
Need help?

If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at support@blnkfinance.com or send us a message here.