---
title: "Get private location health metrics from a window of time."
method: GET
path: "/v1/private-locations/{id}/metrics"
tags: ["Private locations"]
---

# Get private location health metrics from a window of time.

`GET /v1/private-locations/{id}/metrics`

## Request

- Base URL: `https://api.checklyhq.com`
- URL: `https://api.checklyhq.com/v1/private-locations/{id}/metrics`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v1/private-locations/:id/metrics/get.ts> (a function with typed inputs; its response is checked against the schema)

Get private location health metrics from a window of time.

**Rate-limiting is applied to this endpoint, you can send 300 requests per day at most.**

## Path parameters

- `id` string, required

## Query parameters

- `from` string, date, required: Select metrics beginning with this UNIX timestamp. Must be less than 15 days ago.
- `to` string, date, required: Select metrics up to this UNIX timestamp.

## Headers

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

## Response `200`

Successful

- PrivateLocationsMetricsHistoryResponseSchema
  - `timestamps` string[]
  - `queueSize` number[]
  - `oldestScheduledCheckRun` number[]

## Other responses

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

## Changes

- **2026-10-31** `bc90d1bfa738`: 1 info
  - added the optional property `errorCode` to the response with the `403` status

[Operation history](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/private-locations/:id/metrics/get.md)

---

[API](https://skmtc.dev/checklyhq/apis/checkly-public-api.md) - [All operations](https://skmtc.dev/checklyhq/apis/checkly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checklyhq/apis/checkly-public-api/revisions/bc90d1bfa738?raw)