Read the daily risk report of a trading day
The risk findings of one trading day, computed once after the session closes (in the evening, Chicago time). Pull it once per trading day; it does not change afterwards. Every row names the accounts with your customerId, your trader record (traderId) and the trader’s login (userId), so you can match it without a lookup.
- hedge_pairs: two different traders holding opposite positions on the same market at the same time. Micro and full-size contracts count as one market (MNQ with NQ, MES with ES, MYM with YM, M2K with RTY, MCL with CL, MGC with GC; a micro is a tenth of the full size). A pair is two positions opened within 5 minutes of each other, closed within 5 minutes of each other and overlapping for at least 10 seconds, with both positions’ open and close times, size and profit or loss. A wider rule also lists positions opened within 60 seconds of each other and held against each other for at least 3 minutes, however far apart they closed (
rule: open_overlap); those rows flag nobody and send no webhook event. - copy_pairs: two different traders opening the same market and side within 30 seconds, with positions overlapping at least 1 second.
daysSeencounts the days in the last 30 on which the two matched;flaggedis true from 2 days on. - copy_groups: 3 or more different traders opening the same market and side within 5 seconds, with
daysSeen. - shared_devices: a device or address used by more than one of your traders on the day: their sign-ins, apps and versions when the app sent them, country, whether a sign-in came from a hosting or VPN network, whether their sessions overlapped, and the minutes in which both traded. An address shared by more than 50 traders (a mobile carrier, a VPN exit) is left out.
- news_window_fills: every executed order inside one of your news windows (
PUT /risk/news-windows) that applies to the account’s plan, and whether it opened or reduced a position. Report only; nothing is blocked.
From 14 November 2026 hedge_pairs, copy_pairs and copy_groups hold only the medium and high findings, one per trader pair and day (a hedge row carries the pair’s other hedges in rows and its wider-rule overlaps in overlapRows), each with its measures (pair) and assessment. A pair is medium when the two traders made tight matches (copies opened within 3 seconds, hedges opened and closed within 30 seconds with similar size, while at most 10 traders did the same) that cover a meaningful share of their trading that day, or shared a device or address; high when it repeats on another day or they shared a device. A group is a finding when it is small (up to 10 traders), most of a quiet moment, and closed together or repeated. Every other match is listed with GET /risk/reports/{tradingDay}/matches.
Moments when very many traders open the same market at once (a market open, a news print) are not used for pairing; stats counts them. Platform copy trading a trader sets up across their own accounts is never reported. The shared device and news reports hold at most 2000 rows, the largest first (truncated). Findings flag accounts for review; they are not proof. The order source (manual, bracket, API, copier) is not part of these reports yet.
curl "https://api.hyperprop.com/platform/v1/organization/risk/reports/2026-11-12?report=hedge_pairs,copy_groups" \
-H "X-API-Key: hp_live_your_key_here"
Permissions: requires view access to “Traders & accounts”.
Access: read-only and full-access API keys. Dashboard members need view access to Traders & accounts.
curl --request GET \
--url https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}', 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.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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 := "https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"organizationId": "<string>",
"tradingDay": "2026-11-12",
"thresholds": {},
"reports": {
"hedge_pairs": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"id": "<string>",
"underlying": "NQ",
"overlapFrom": "<string>",
"overlapTo": "<string>",
"overlapSeconds": 412,
"openGapSeconds": 95,
"closeGapSeconds": 3,
"legs": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"contract": "NQZ6",
"side": "long",
"openedAt": "2026-11-12T14:31:02.000Z",
"closedAt": "2026-11-12T14:38:10.000Z",
"quantity": 1,
"size": 1,
"pnl": 1250,
"costs": 4.2
}
],
"rule": "open_close",
"pair": {
"tight": 3,
"matches": 5,
"positionsA": 12,
"positionsB": 40,
"followerShare": 0.25,
"leaderShare": 0.075,
"weight": 2.5,
"daysSeen": 2,
"tightPnlA": 123,
"tightPnlB": 123,
"tightSimilar": 123
},
"rows": [
{}
],
"overlapRows": [
{}
],
"assessment": {
"level": "medium",
"reasons": [
{
"code": "<string>",
"text": "<string>"
}
]
}
}
],
"redacted": false
},
"copy_pairs": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"id": "<string>",
"traderA": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "<string>",
"traderEmail": "<string>",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com"
}
]
},
"traderB": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "<string>",
"traderEmail": "<string>",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com"
}
]
},
"underlyings": [
"ES"
],
"matches": 6,
"avgSecondsApart": 2.4,
"similarSizeShare": 0.83,
"firstAt": "<string>",
"lastAt": "<string>",
"samples": [
{
"atA": "<string>",
"atB": "<string>",
"accountA": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountB": "9d1e6679-7425-40de-944b-e07fc1f90ae8",
"underlying": "ES",
"side": "long",
"secondsApart": 2,
"overlapSeconds": 240
}
],
"daysSeen": 3,
"flagged": true,
"pair": {
"tight": 3,
"matches": 5,
"positionsA": 12,
"positionsB": 40,
"followerShare": 0.25,
"leaderShare": 0.075,
"weight": 2.5,
"daysSeen": 2,
"tightPnlA": 123,
"tightPnlB": 123,
"tightSimilar": 123
},
"assessment": {
"level": "medium",
"reasons": [
{
"code": "<string>",
"text": "<string>"
}
]
}
}
],
"redacted": false
},
"copy_groups": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"id": "<string>",
"underlying": "NQ",
"side": "long",
"traders": 4,
"firstAt": "<string>",
"lastAt": "<string>",
"spanSeconds": 3.1,
"members": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"contract": "NQZ6",
"openedAt": "2026-11-12T14:31:02.000Z",
"closedAt": "2026-11-12T14:38:10.000Z",
"quantity": 1,
"size": 1,
"pnl": 1250,
"costs": 4.2
}
],
"daysSeen": 2,
"crowd": 6,
"exitsMatched": true,
"assessment": {
"level": "medium",
"reasons": [
{
"code": "<string>",
"text": "<string>"
}
]
}
}
],
"redacted": false
},
"shared_devices": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"id": "<string>",
"type": "device",
"value": "d_8f2c41e09a",
"traderCount": 2,
"firstSeen": "<string>",
"lastSeen": "<string>",
"traders": [
{
"userId": "<string>",
"traderId": "8a2e1d0f-3c4b-4d5e-9f6a-7b8c9d0e1f2a",
"traderName": "<string>",
"traderEmail": "<string>",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com"
}
],
"firstSeen": "<string>",
"lastSeen": "<string>",
"signIns": 3,
"apps": [
"web"
],
"versions": [
"3.14.0"
],
"countries": [
"US"
],
"hostingNetwork": true
}
],
"pairs": [
{
"userA": "<string>",
"userB": "<string>",
"sessionOverlapSeconds": 1800,
"signInGapSeconds": 40,
"tradingOverlapMinutes": 12
}
],
"overlapping": true
}
],
"redacted": false
},
"news_window_fills": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"id": "<string>",
"windowId": "nfp-2026-12-04",
"windowName": "Non-Farm Payrolls",
"eventAt": "<string>",
"secondsFromEvent": -35,
"opening": true,
"contract": "ESZ6",
"side": "buy",
"quantity": 2,
"price": 6012.25,
"filledAt": "<string>",
"pnl": 0
}
],
"redacted": false
}
}
}
}{
"success": false,
"statusCode": 400,
"error": "Bad Request",
"message": "Invalid request data",
"code": "BAD_REQUEST"
}{
"success": false,
"statusCode": 401,
"error": "Unauthorized",
"message": "Authentication required",
"code": "UNAUTHORIZED"
}{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "This API key does not have admin permissions",
"code": "INSUFFICIENT_PERMISSIONS"
}{
"statusCode": 504,
"error": "Gateway Timeout",
"message": "The request did not complete within 25 seconds. Try again, or narrow it (for example a shorter date range).",
"code": "REQUEST_TIMEOUT"
}Authorizations
Organization API key (hp_live_...), sent in the X-API-Key header. Create, rotate and restrict keys in the dashboard or with the API keys endpoints; an organization can have two active keys, so you can rotate without downtime. A full-access key can call every endpoint in this reference. A read-only key can call GET endpoints (and create a trading stream token); any other request returns 403 READ_ONLY_KEY. A key with an IP allowlist returns 403 IP_NOT_ALLOWED from any other address. Each endpoint lists which keys can call it under Access.
Headers
Path Parameters
Query Parameters
curl --request GET \
--url https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}', 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.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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 := "https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hyperprop.com/platform/v1/organization/risk/reports/{tradingDay}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"organizationId": "<string>",
"tradingDay": "2026-11-12",
"thresholds": {},
"reports": {
"hedge_pairs": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"id": "<string>",
"underlying": "NQ",
"overlapFrom": "<string>",
"overlapTo": "<string>",
"overlapSeconds": 412,
"openGapSeconds": 95,
"closeGapSeconds": 3,
"legs": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"contract": "NQZ6",
"side": "long",
"openedAt": "2026-11-12T14:31:02.000Z",
"closedAt": "2026-11-12T14:38:10.000Z",
"quantity": 1,
"size": 1,
"pnl": 1250,
"costs": 4.2
}
],
"rule": "open_close",
"pair": {
"tight": 3,
"matches": 5,
"positionsA": 12,
"positionsB": 40,
"followerShare": 0.25,
"leaderShare": 0.075,
"weight": 2.5,
"daysSeen": 2,
"tightPnlA": 123,
"tightPnlB": 123,
"tightSimilar": 123
},
"rows": [
{}
],
"overlapRows": [
{}
],
"assessment": {
"level": "medium",
"reasons": [
{
"code": "<string>",
"text": "<string>"
}
]
}
}
],
"redacted": false
},
"copy_pairs": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"id": "<string>",
"traderA": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "<string>",
"traderEmail": "<string>",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com"
}
]
},
"traderB": {
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "<string>",
"traderEmail": "<string>",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com"
}
]
},
"underlyings": [
"ES"
],
"matches": 6,
"avgSecondsApart": 2.4,
"similarSizeShare": 0.83,
"firstAt": "<string>",
"lastAt": "<string>",
"samples": [
{
"atA": "<string>",
"atB": "<string>",
"accountA": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountB": "9d1e6679-7425-40de-944b-e07fc1f90ae8",
"underlying": "ES",
"side": "long",
"secondsApart": 2,
"overlapSeconds": 240
}
],
"daysSeen": 3,
"flagged": true,
"pair": {
"tight": 3,
"matches": 5,
"positionsA": 12,
"positionsB": 40,
"followerShare": 0.25,
"leaderShare": 0.075,
"weight": 2.5,
"daysSeen": 2,
"tightPnlA": 123,
"tightPnlB": 123,
"tightSimilar": 123
},
"assessment": {
"level": "medium",
"reasons": [
{
"code": "<string>",
"text": "<string>"
}
]
}
}
],
"redacted": false
},
"copy_groups": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"id": "<string>",
"underlying": "NQ",
"side": "long",
"traders": 4,
"firstAt": "<string>",
"lastAt": "<string>",
"spanSeconds": 3.1,
"members": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"contract": "NQZ6",
"openedAt": "2026-11-12T14:31:02.000Z",
"closedAt": "2026-11-12T14:38:10.000Z",
"quantity": 1,
"size": 1,
"pnl": 1250,
"costs": 4.2
}
],
"daysSeen": 2,
"crowd": 6,
"exitsMatched": true,
"assessment": {
"level": "medium",
"reasons": [
{
"code": "<string>",
"text": "<string>"
}
]
}
}
],
"redacted": false
},
"shared_devices": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"id": "<string>",
"type": "device",
"value": "d_8f2c41e09a",
"traderCount": 2,
"firstSeen": "<string>",
"lastSeen": "<string>",
"traders": [
{
"userId": "<string>",
"traderId": "8a2e1d0f-3c4b-4d5e-9f6a-7b8c9d0e1f2a",
"traderName": "<string>",
"traderEmail": "<string>",
"accounts": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com"
}
],
"firstSeen": "<string>",
"lastSeen": "<string>",
"signIns": 3,
"apps": [
"web"
],
"versions": [
"3.14.0"
],
"countries": [
"US"
],
"hostingNetwork": true
}
],
"pairs": [
{
"userA": "<string>",
"userB": "<string>",
"sessionOverlapSeconds": 1800,
"signInGapSeconds": 40,
"tradingOverlapMinutes": 12
}
],
"overlapping": true
}
],
"redacted": false
},
"news_window_fills": {
"status": "ready",
"computedAt": "<string>",
"rowCount": 3,
"truncated": false,
"stats": {},
"rows": [
{
"accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"accountNumber": "ACC-50K-000123",
"customerId": "cust-4471",
"accountType": "sim_funded",
"status": "in_progress",
"planId": "<string>",
"traderId": "2b1f0c9e-4d3a-4e5f-8a7b-6c5d4e3f2a1b",
"userId": "<string>",
"traderName": "Jane Trader",
"traderEmail": "jane@example.com",
"id": "<string>",
"windowId": "nfp-2026-12-04",
"windowName": "Non-Farm Payrolls",
"eventAt": "<string>",
"secondsFromEvent": -35,
"opening": true,
"contract": "ESZ6",
"side": "buy",
"quantity": 2,
"price": 6012.25,
"filledAt": "<string>",
"pnl": 0
}
],
"redacted": false
}
}
}
}{
"success": false,
"statusCode": 400,
"error": "Bad Request",
"message": "Invalid request data",
"code": "BAD_REQUEST"
}{
"success": false,
"statusCode": 401,
"error": "Unauthorized",
"message": "Authentication required",
"code": "UNAUTHORIZED"
}{
"success": false,
"statusCode": 403,
"error": "Forbidden",
"message": "This API key does not have admin permissions",
"code": "INSUFFICIENT_PERMISSIONS"
}{
"statusCode": 504,
"error": "Gateway Timeout",
"message": "The request did not complete within 25 seconds. Try again, or narrow it (for example a shorter date range).",
"code": "REQUEST_TIMEOUT"
}