curl --request POST \
--url 'https://api.flashcat.cloud/insight/incident/list?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"start_time": 1712000000,
"end_time": 1712604800,
"p": 1,
"limit": 20,
"severities": [
"Critical"
]
}
'import requests
url = "https://api.flashcat.cloud/insight/incident/list?app_key="
payload = {
"start_time": 1712000000,
"end_time": 1712604800,
"p": 1,
"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: 1712000000,
end_time: 1712604800,
p: 1,
limit: 20,
severities: ['Critical']
})
};
fetch('https://api.flashcat.cloud/insight/incident/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/insight/incident/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' => 1712000000,
'end_time' => 1712604800,
'p' => 1,
'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/insight/incident/list?app_key="
payload := strings.NewReader("{\n \"start_time\": 1712000000,\n \"end_time\": 1712604800,\n \"p\": 1,\n \"limit\": 20,\n \"severities\": [\n \"Critical\"\n ]\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/insight/incident/list?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"start_time\": 1712000000,\n \"end_time\": 1712604800,\n \"p\": 1,\n \"limit\": 20,\n \"severities\": [\n \"Critical\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/insight/incident/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\": 1712000000,\n \"end_time\": 1712604800,\n \"p\": 1,\n \"limit\": 20,\n \"severities\": [\n \"Critical\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"total": 2,
"has_next_page": false,
"items": [
{
"incident_id": "67ca560c381a4fedb664f5f8",
"title": "CPU spike on prod-web-01",
"description": "CPU usage exceeded 90% threshold",
"team_id": 4295771902131,
"team_name": "SRE Team",
"channel_id": 4321322010131,
"channel_name": "Production Alerts",
"progress": "Closed",
"severity": "Info",
"created_at": 1741313548,
"closed_by": "manually",
"seconds_to_ack": 1052085,
"seconds_to_close": 1483880,
"engaged_seconds": 1052085,
"hours": "work",
"responders": [
{
"person_id": 3790925372131,
"assigned_at": 1741313548,
"acknowledged_at": 1742365633,
"person_name": "alice",
"email": "alice@example.com"
}
],
"assigned_to": {
"person_ids": [
3790925372131
],
"escalate_rule_id": "000000000000000000000000",
"layer_idx": 0,
"type": "reassign"
},
"labels": {},
"fields": {},
"notifications": 4,
"interruptions": 2,
"assignments": 2,
"reassignments": 1,
"acknowledgements": 1,
"escalations": 0,
"timeout_escalations": 0,
"manual_escalations": 0,
"creator_id": 3790925372131,
"creator_name": "alice"
}
]
}
}{
"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 insight incidents
Return a paged list of incidents with per-incident handling metrics used by the analytics dashboard.
curl --request POST \
--url 'https://api.flashcat.cloud/insight/incident/list?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"start_time": 1712000000,
"end_time": 1712604800,
"p": 1,
"limit": 20,
"severities": [
"Critical"
]
}
'import requests
url = "https://api.flashcat.cloud/insight/incident/list?app_key="
payload = {
"start_time": 1712000000,
"end_time": 1712604800,
"p": 1,
"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: 1712000000,
end_time: 1712604800,
p: 1,
limit: 20,
severities: ['Critical']
})
};
fetch('https://api.flashcat.cloud/insight/incident/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/insight/incident/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' => 1712000000,
'end_time' => 1712604800,
'p' => 1,
'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/insight/incident/list?app_key="
payload := strings.NewReader("{\n \"start_time\": 1712000000,\n \"end_time\": 1712604800,\n \"p\": 1,\n \"limit\": 20,\n \"severities\": [\n \"Critical\"\n ]\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/insight/incident/list?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"start_time\": 1712000000,\n \"end_time\": 1712604800,\n \"p\": 1,\n \"limit\": 20,\n \"severities\": [\n \"Critical\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/insight/incident/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\": 1712000000,\n \"end_time\": 1712604800,\n \"p\": 1,\n \"limit\": 20,\n \"severities\": [\n \"Critical\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"total": 2,
"has_next_page": false,
"items": [
{
"incident_id": "67ca560c381a4fedb664f5f8",
"title": "CPU spike on prod-web-01",
"description": "CPU usage exceeded 90% threshold",
"team_id": 4295771902131,
"team_name": "SRE Team",
"channel_id": 4321322010131,
"channel_name": "Production Alerts",
"progress": "Closed",
"severity": "Info",
"created_at": 1741313548,
"closed_by": "manually",
"seconds_to_ack": 1052085,
"seconds_to_close": 1483880,
"engaged_seconds": 1052085,
"hours": "work",
"responders": [
{
"person_id": 3790925372131,
"assigned_at": 1741313548,
"acknowledged_at": 1742365633,
"person_name": "alice",
"email": "alice@example.com"
}
],
"assigned_to": {
"person_ids": [
3790925372131
],
"escalate_rule_id": "000000000000000000000000",
"layer_idx": 0,
"type": "reassign"
},
"labels": {},
"fields": {},
"notifications": 4,
"interruptions": 2,
"assignments": 2,
"reassignments": 1,
"acknowledgements": 1,
"escalations": 0,
"timeout_escalations": 0,
"manual_escalations": 0,
"creator_id": 3790925372131,
"creator_name": "alice"
}
]
}
}{
"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 | Analytics Read (on-call) |
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
Paged incident list request. Extends InsightFilter with pagination.
Start time, Unix seconds. Must be greater than 0.
End time, Unix seconds. Must be greater than start_time.
Filter by team IDs. At most 100 entries.
Filter by channel IDs. At most 100 entries.
Filter by responder person IDs. At most 100 entries.
Filter by severity. At most 3 entries.
Critical, Warning, Info, Ok Filter by incident IDs (MongoDB ObjectIDs). At most 100 entries.
^[0-9a-fA-F]{24}$Full-text query applied to incident title and description.
Label filters (exact match).
Show child attributes
Show child attributes
Custom-field filters (exact match).
Field to sort the underlying incident set by.
created_at Sort ascending when true, descending otherwise.
Restrict results to teams the caller belongs to. When true and the caller has no teams, the result set is empty.
IANA time zone name used to interpret the time range (e.g. Asia/Shanghai). Defaults to the account time zone.
Lower bound (inclusive) on time-to-close, in seconds.
Upper bound (exclusive) on time-to-close, in seconds. Must be greater than seconds_to_close_from when both are set.
Lower bound (inclusive) on time-to-acknowledge, in seconds.
Upper bound (exclusive) on time-to-acknowledge, in seconds. Must be greater than seconds_to_ack_from when both are set.
Subset of CSV column keys to include in the export. At most 50 entries. Only used by the export endpoints.
incident_id, title, severity, progress, channel_id, channel_name, team_id, team_name, created_at, seconds_to_ack, seconds_to_close, closed_by, engaged_seconds, hours, notifications, interruptions, acknowledgements, assignments, reassignments, escalations, manual_escalations, timeout_escalations, assigned_to, responders, description, labels, fields, creator_id, creator_name Strip HTML markup from the description column when exporting.
Page number, starting at 1. Defaults to 1.
x >= 1Page size, between 1 and 100. Defaults to 20.
1 <= x <= 100Cursor token returned by a previous page. Pass it back to fetch the next page.
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?