---
title: "Get monitor location stats"
method: GET
path: "/api/monitors/{id}/location-stats"
tags: ["Monitors"]
---

# Get monitor location stats

`GET /api/monitors/{id}/location-stats`

## Request

- Base URL: `https://demo.supercheck.dev`
- URL: `https://demo.supercheck.dev/api/monitors/{id}/location-stats`
- Auth: HTTP bearer

Return per-location aggregated statistics (uptime, response times) for a monitor over the requested window.

## Response `200`

Per-location statistics

- MonitorLocationStats[]
  - `location` string
  - `totalChecks` integer, nullable
  - `upChecks` integer, nullable
  - `uptimePercentage` number, nullable
  - `avgResponseTime` number, nullable
  - `minResponseTime` number, nullable
  - `maxResponseTime` number, nullable

## Other responses

- `400`: Days must be between 1 and 90
- `401`: Authentication required or token invalid
- `403`: Insufficient permissions
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-09-15** `27d0aac76359`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/monitors/:id/location-stats/get.md)

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) - [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) - [OpenAPI document](https://skmtc.dev/supercheck-io/apis/supercheck-api/revisions/7fa0162c07bd?raw)