Skip to main content
GET
https://api.cloud.blnkfinance.com
/
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": []
}
This feature is only available on the Pro plan.
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 [email protected] or send us a message here.