---
title: "List sites"
method: GET
path: "/sites"
tags: ["Sites"]
---

# List sites

`GET /sites`

Returns a list of Edge sites.

## Response `200`

Success

- SiteListResponse — List of Edge sites. The number of sites per environment is expected to remain small, so the full list is always returned in a single response. Pagination is intentionally omitted.
  - `results` Site[], required
    - `id` string, uuid, required — Unique identifier of the Edge site.
    - `name` string, required — Human-readable name of the Edge site.
    - `description` string — Optional description of the Edge site.
    - `createdOn` string, date-time, required — Timestamp when the Edge site was created.
    - `type` string, required — Deployment type of the Edge site. Possible values are: * `ON_PREM` * `COLLIBRA_HOSTED` * `AIR_GAPPED` * `FEDRAMP`
    - `status` string, required — Current status of the Edge site. Values are reported in this precedence order (top-of-list wins): * `PENDING` — installed but has never contacted the platform * `OFFLINE` — no recent heartbeat (overrides `UPGRADING`/`HEALTHY`/`UNHEALTHY`) * `UPGRADING` — an upgrade to `pendingVersion` is in progress (overrides `HEALTHY`/`UNHEALTHY`) * `HEALTHY` * `UNHEALTHY` Note: `pendingVersion` may be set even when `status` is `OFFLINE` or `PENDING` — it reflects the desired version regardless of whether the upgrade is currently active.
    - `currentVersion` string — Currently installed Edge version. Absent if the site has not reported a version yet.
    - `pendingVersion` string — Edge version the site should be upgrading or installing to. Absent when the site is already at its desired version.

## Other responses

- `401` — Unauthorized — authentication is required or the provided credentials are invalid.
- `403` — Forbidden — insufficient permissions.
- `500` — Unexpected error.

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)