List Alerts
curl --request GET \
--url http://api.gu1.ai/intelligence/alerts \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/intelligence/alerts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/intelligence/alerts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/intelligence/alerts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/intelligence/alerts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/intelligence/alerts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/intelligence/alerts")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"alerts": [
{}
],
"count": 123
}API Reference
List Alerts
Get alerts for entities or organizations with filtering and pagination β using the gu1 alerts API for risk and compliance workflows.
GET
/
intelligence
/
alerts
List Alerts
curl --request GET \
--url http://api.gu1.ai/intelligence/alerts \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/intelligence/alerts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/intelligence/alerts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/intelligence/alerts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/intelligence/alerts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/intelligence/alerts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/intelligence/alerts")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"alerts": [
{}
],
"count": 123
}Overview
Retrieves alerts for specific entities or across the organization. Alerts are generated automatically by rules when conditions are met.Endpoint
GET http://api.gu1.ai/intelligence/alerts
Authentication
Requires a valid API key in the Authorization header:Authorization: Bearer YOUR_API_KEY
Query Parameters
string
required
Entity ID to filter alerts (person, company, or transaction)
string
Filter by status:
PENDING, ACKNOWLEDGED, RESOLVEDstring
Filter by severity:
LOW, MEDIUM, HIGH, CRITICALstring
Filter by alert category
Response
boolean
Whether the request was successful
array
Array of alert objects
number
Total number of alerts matching filters
Example Requests
Get Alerts for Entity
curl -X GET "http://api.gu1.ai/intelligence/alerts?entityId=550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'http://api.gu1.ai/intelligence/alerts?entityId=550e8400-e29b-41d4-a716-446655440000',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(`Found ${data.count} alerts`);
import requests
response = requests.get(
'http://api.gu1.ai/intelligence/alerts',
headers={
'Authorization': 'Bearer YOUR_API_KEY'
},
params={
'entityId': '550e8400-e29b-41d4-a716-446655440000'
}
)
data = response.json()
print(f"Found {data['count']} alerts")
Filter by Severity and Status
curl -X GET "http://api.gu1.ai/intelligence/alerts?entityId=550e8400-e29b-41d4-a716-446655440000&severity=CRITICAL&status=PENDING" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'http://api.gu1.ai/intelligence/alerts?' + new URLSearchParams({
entityId: '550e8400-e29b-41d4-a716-446655440000',
severity: 'CRITICAL',
status: 'PENDING'
}),
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(`Critical pending alerts: ${data.count}`);
response = requests.get(
'http://api.gu1.ai/intelligence/alerts',
headers={
'Authorization': 'Bearer YOUR_API_KEY'
},
params={
'entityId': '550e8400-e29b-41d4-a716-446655440000',
'severity': 'CRITICAL',
'status': 'PENDING'
}
)
data = response.json()
print(f"Critical pending alerts: {data['count']}")
Response Example
{
"success": true,
"alerts": [
{
"id": "alert-uuid-123",
"name": "High Risk Transaction Pattern",
"category": "transaction_monitoring",
"severity": "CRITICAL",
"status": "PENDING",
"createdAt": "2024-12-23T10:00:00.000Z",
"updatedAt": "2024-12-23T10:00:00.000Z",
"riskContribution": 25,
"miniAnalysis": "Multiple high-value transactions detected within short timeframe",
"investigationId": null,
"targetEntityId": "550e8400-e29b-41d4-a716-446655440000",
"triggerCondition": {
"ruleName": "Rapid Transaction Detection",
"threshold": 5,
"actual": 8
},
"sourceSystem": "rules_engine"
}
],
"count": 1
}
Alert Severity Levels
- LOW: Informational, requires review
- MEDIUM: Moderate risk, should be investigated
- HIGH: Significant risk, requires immediate attention
- CRITICAL: Severe risk, urgent action required
Alert Status Workflow
- PENDING: Alert just created, awaiting review
- ACKNOWLEDGED: Alert has been reviewed by compliance team
- RESOLVED: Alert has been addressed and closed
See Also
Was this page helpful?