---
title: "ICMP monitors"
method: GET
path: "/v1/analytics/icmp/{id}"
tags: ["Analytics"]
---

# ICMP monitors

`GET /v1/analytics/icmp/{id}`

Fetch detailed availability metrics and aggregated or non-aggregated ICMP Monitor metrics across custom time ranges. For example, you can get the p99 and p95 of latency metrics together with the packet loss percentage for any time range.
**Rate-limiting is applied to this endpoint, you can send 30 requests / 60 seconds at most.**

## Path parameters

- `id` string, required

## Query parameters

- `from` string, date — Custom start time of reporting window in unix timestamp format. Setting a custom "from" timestamp overrides the use of any "quickRange".
- `to` string, date — Custom end time of reporting window in unix timestamp format. Setting a custom "to" timestamp overrides the use of any "quickRange".
- `quickRange` 'last24Hours' | 'last7Days' | 'last30Days' | 'thisWeek' | 'thisMonth' | 'lastWeek' | 'lastMonth' — Preset reporting windows are used for quickly generating report on commonly used windows. Can be overridden by using a custom "to" and "from" timestamp.
- `aggregationInterval` number — The time interval to use for aggregating metrics in minutes. For example, five minutes is 5, 24 hours is 1440.
- `filterByStatus` string[] — Filter based on whether a check result was either failing or passing
- `groupBy` 'runLocation' — Determines how the series data is grouped. Note that grouped queries are a bit more expensive and might take longer.
- `metrics` string[], required — Available metrics for ICMP Monitors. You can pass multiple metrics as a comma separated string.
- `limit` integer — Limit the number of results
- `page` number — Page number

## Headers

- `x-checkly-account` string — Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Response `200`

Successful

- Model25
  - `checkId` string
  - `name` string
  - `checkType` 'AGENTIC' | 'API' | 'BROWSER' | 'HEARTBEAT' | 'ICMP' | 'MULTI_STEP' | 'TCP' | 'PLAYWRIGHT' | 'TRACEROUTE' | 'URL' | 'DNS' | 'SSL' | 'GRPC'
  - `activated` boolean
  - `muted` boolean
  - `frequency` number
  - `from` string, date
  - `to` string, date
  - `tags` string[]
  - `series` string[]
  - `pagination` Pagination
    - `page` number
    - `limit` number
  - `metadata` object
    - `string` String
      - `unit` 'milliseconds' | 'score' | 'count' | 'percentage'
      - `label` string
      - `aggregation` 'avg' | 'max' | 'median' | 'min' | 'p50' | 'p90' | 'p95' | 'p99' | 'stddev' | 'sum'

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests

---

[API](https://skmtc.net/checklyhq/apis/checkly-public-api.md) · [All operations](https://skmtc.net/checklyhq/apis/checkly-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/checklyhq/checkly-public-api/versions/9e903da4f3da/schema)