---
title: "List Sites"
method: GET
path: "/v1/sites"
---

# List Sites

`GET /v1/sites`

## Request

- Base URL: `https://api.ui.com`
- URL: `https://api.ui.com/v1/sites`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/ubiquiti/apis/unifi-site-manager-api/docs/v1/sites/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of all sites (from hosts running the UniFi Network application) associated with the UI account making the API call. <br/><br/>**Note**: The structure of the `meta` and `statistics` fields may vary depending on the UniFi Network version. The example provided is based on UniFi OS 4.1.13.

## Query parameters

- `pageSize` string
- `nextToken` string

## Response `200`

200

- object
  - `code` unknown
  - `data` object[]: Generic response data, specific schema depends on the endpoint
    - `siteId` string: Unique identifier of the site
    - `hostId` string: Unique identifier of the host device managing this site
    - `meta` unknown
    - `statistics` unknown
    - `permission` string: Permission level of the current user for this site (admin, readonly, etc.)
    - `isOwner` boolean: Indicates if the current user is the owner of this site
  - `httpStatusCode` integer: HTTP status code
  - `traceId` string: Request trace identifier
  - `nextToken` string: Pagination token for fetching the next set of results

## Other responses

- `401`: 401
- `429`: 429
- `500`: 500
- `502`: 502

---

[API](https://skmtc.dev/ubiquiti/apis/unifi-site-manager-api.md) - [All operations](https://skmtc.dev/ubiquiti/apis/unifi-site-manager-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ubiquiti/apis/unifi-site-manager-api/revisions/16daa37f17c9?raw)