---
title: "Retrieve a risk detection overview."
method: GET
path: "/api/v1/accounts/{accountId}/riskassessment/statisticsbydate/{period}"
---

# Retrieve a risk detection overview.

`GET /api/v1/accounts/{accountId}/riskassessment/statisticsbydate/{period}`

## Request

- Base URL: `https://api.usa.cloud.watchguard.com/rest/aether-endpoint-security/aether-mgmt`
- URL: `https://api.usa.cloud.watchguard.com/rest/aether-endpoint-security/aether-mgmt/api/v1/accounts/{accountId}/riskassessment/statisticsbydate/{period}`
- Auth: API key in header `WatchGuard-API-Key` and HTTP bearer
- TypeScript: <https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/docs/api/v1/accounts/:accountId/riskassessment/statisticsbydate/:period/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves an overview of the number and types of risks detected over time.

## Path parameters

- `accountId` string, required
- `period` 7 | 30, required

## Response `200`

OK

- RiskStatisticsByDateResult
  - `key` RiskStatisticsByDateKey
    - `date` string, date-time: Date and time of the overview.
    - `device_risk_severity` integer: Risk level associated with the device. - 0: Undefined - 5: Without risk - 20: Medium risk - 30: High risk - 40: Critical risk
  - `value` integer: Number of devices found for the specified key.

## Other responses

- `400`: BAD REQUEST.
- `403`: ACCESS DENIED.
- `404`: NOT FOUND.
- `405`: METHOD NOT ALLOWED.
- `500`: INTERNAL ERROR.

---

[API](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api.md) - [All operations](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/llms.txt) - [OpenAPI document](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/revisions/1376eee70d39?raw)