---
title: "Retrieve a private location"
method: GET
path: "/v1/private-locations/{id}"
tags: ["Private locations"]
---

# Retrieve a private location

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

Show details of a specific private location.

## Path parameters

- `id` string, required

## Headers

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

## Response `200`

Successful

- PrivateLocationsSchema
  - `id` string, required
  - `name` string, required — The name assigned to the private location.
  - `slugName` string, required — Valid slug name.
  - `icon` string — The private location icon.
  - `created_at` string, date, required
  - `updated_at` string, date, nullable
  - `keys` PrivateLocationKeys[]
    - `id` string, required
    - `rawKey` string, required
    - `maskedKey` string, required — The masked key value.
    - `created_at` string, date, required
    - `updated_at` string, date, nullable
  - `proxyUrl` string, nullable — A proxy for outgoing API check HTTP calls from your private location.
  - `lastSeen` string, date, nullable
  - `agentCount` number, nullable
  - `minAgentVersion` string, nullable — The lowest agent version currently connected to this private location.
  - `runningAgents` RunningAgent[] — A list of agent versions and their counts currently connected to this private location.
    - `version` string, required
    - `isOutdated` boolean, required
    - `count` number, required
    - `agents` RunningAgentInfo[], required
      - `id` string, required
      - `lastSeenAt` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `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)