curl --request POST \
--url 'https://api.flashcat.cloud/alert-event/list?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"start_time": 1712620800,
"end_time": 1712707200,
"limit": 20,
"severities": "Critical"
}
'import requests
url = "https://api.flashcat.cloud/alert-event/list?app_key="
payload = {
"start_time": 1712620800,
"end_time": 1712707200,
"limit": 20,
"severities": "Critical"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
start_time: 1712620800,
end_time: 1712707200,
limit: 20,
severities: 'Critical'
})
};
fetch('https://api.flashcat.cloud/alert-event/list?app_key=', 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 => "https://api.flashcat.cloud/alert-event/list?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'start_time' => 1712620800,
'end_time' => 1712707200,
'limit' => 20,
'severities' => 'Critical'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/alert-event/list?app_key="
payload := strings.NewReader("{\n \"start_time\": 1712620800,\n \"end_time\": 1712707200,\n \"limit\": 20,\n \"severities\": \"Critical\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/alert-event/list?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"start_time\": 1712620800,\n \"end_time\": 1712707200,\n \"limit\": 20,\n \"severities\": \"Critical\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/alert-event/list?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"start_time\": 1712620800,\n \"end_time\": 1712707200,\n \"limit\": 20,\n \"severities\": \"Critical\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"total": 1,
"has_next_page": false,
"items": [
{
"event_id": "663a1b2c3d4e5f6789abc001",
"alert_id": "663a1b2c3d4e5f6789abcdef",
"title": "CPU usage > 90%",
"event_severity": "Critical",
"event_time": 1712650000
}
]
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}List raw alert events
Return a cursor-paginated list of raw alert events across all alerts, with filtering by integration, channel, time range, and severity.
curl --request POST \
--url 'https://api.flashcat.cloud/alert-event/list?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"start_time": 1712620800,
"end_time": 1712707200,
"limit": 20,
"severities": "Critical"
}
'import requests
url = "https://api.flashcat.cloud/alert-event/list?app_key="
payload = {
"start_time": 1712620800,
"end_time": 1712707200,
"limit": 20,
"severities": "Critical"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
start_time: 1712620800,
end_time: 1712707200,
limit: 20,
severities: 'Critical'
})
};
fetch('https://api.flashcat.cloud/alert-event/list?app_key=', 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 => "https://api.flashcat.cloud/alert-event/list?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'start_time' => 1712620800,
'end_time' => 1712707200,
'limit' => 20,
'severities' => 'Critical'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/alert-event/list?app_key="
payload := strings.NewReader("{\n \"start_time\": 1712620800,\n \"end_time\": 1712707200,\n \"limit\": 20,\n \"severities\": \"Critical\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/alert-event/list?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"start_time\": 1712620800,\n \"end_time\": 1712707200,\n \"limit\": 20,\n \"severities\": \"Critical\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/alert-event/list?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"start_time\": 1712620800,\n \"end_time\": 1712707200,\n \"limit\": 20,\n \"severities\": \"Critical\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"total": 1,
"has_next_page": false,
"items": [
{
"event_id": "663a1b2c3d4e5f6789abc001",
"alert_id": "663a1b2c3d4e5f6789abcdef",
"title": "CPU usage > 90%",
"event_severity": "Critical",
"event_time": 1712650000
}
]
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Restrictions
| Aspect | Value |
|---|---|
| Rate limits | 1,000 requests/minute; 50 requests/second per account |
| Permissions | Channels Read (on-call) |
Usage
- Results are filtered by the caller’s channel data-access permissions.
severitiesis a comma-separated string, e.g."Critical,Warning".
Authorizations
App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Filter and pagination criteria for the global raw event list.
Start of the search window, Unix epoch seconds. Must be greater than 0 when provided.
End of the search window, Unix epoch seconds. Must be greater than start_time when provided.
Page number, starting at 1. Used when search_after_ctx is not provided.
x >= 0Page size, max 100, default 20.
0 <= x <= 100Pagination cursor: leave empty for the first page, then pass the search_after_ctx returned by the previous response.
Filter by integration IDs.
Filter by integration types (plugin keys).
Filter by channel IDs. At most 100 entries.
100Comma-separated severity filter, e.g. Critical,Warning. Accepted values: Critical, Warning, Info, Ok.
Sort field; only event_time is supported.
event_time Sort ascending when true.
Response
Success
Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.
Was this page helpful?