---
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
  - `projectBindings` ProjectBindingsV1 — The Checkly CLI projects that manage this resource. `owner` is null and `references` empty when the resource is not managed by code.
    - `owner` ProjectBindingOwnerV1, nullable, required — The project that owns this resource — the one whose deploy can delete it. Null when no project owns it, including when other projects merely reference it. In the rare case that several projects hold an ownership record for one resource, this reports the preferred one and the rest are omitted.
      - `project` BindingProjectV1, required — The project this binding is to.
        - `id` string, required — The ID of the project.
        - `logicalId` string, required — The logical ID of the project, as declared in code.
        - `name` string, required — The name of the project.
      - `binding` ProjectBindingDetailsV1, required — The resource's side of this binding.
        - `logicalId` string, required — The resource's logical ID within this project, as declared in code.
        - `pending` boolean, required — True when the binding is reserved by an import plan that has not been deployed yet.
    - `references` ProjectBindingV1[], required — Projects that use this resource without owning it; their deploys leave it alone. Empty when there are none.
      - `project` BindingProjectV1, required — The project this binding is to.
        - `id` string, required — The ID of the project.
        - `logicalId` string, required — The logical ID of the project, as declared in code.
        - `name` string, required — The name of the project.
      - `binding` ProjectBindingDetailsV1, required — The resource's side of this binding.
        - `logicalId` string, required — The resource's logical ID within this project, as declared in code.
        - `pending` boolean, required — True when the binding is reserved by an import plan that has not been deployed yet.

## 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/revisions/87d29dc7b4fe/schema)