---
title: "GET /sites"
method: GET
path: "/sites"
---

# GET /sites

`GET /sites`

Return all sites linked to your account

## Response `200`

A list of sites.

- Site[]
  - `id` string, required — Unique Site Identifier
  - `nmi` string, required — National Metering Identifier (NMI) for the site
  - `channels` Channel[], required — List of channels that are readable from your meter
    - `identifier` string, required — Identifier of the channel
    - `type` 'general' | 'controlledLoad' | 'feedIn', required — Meter channel type
    - `tariff` string, required — The tariff code of the channel
  - `network` string, required — The name of the site's network
  - `status` 'pending' | 'active' | 'closed', required — Site status. Pending sites are still in the process of being transferred. Note: We only include sites that have correct address details. If you expect to see a site, but don't, you may need to contact [info@amber.com.au](mailto:info@amber.com.au) to check that the address is correct. Active sites are ones that we actively supply electricity to. Closed sites are old sites that we no longer supply.
  - `activeFrom` string — Date the site became active. This date will be in the future for pending sites. It may also be undefined, though if it is, contact [info@amber.com.au](mailto:info@amber.com.au) - there may be an issue with your address. Formatted as a ISO 8601 date when present.
  - `closedOn` string — Date the site closed. Undefined if the site is pending or active. Formatted as a ISO 8601 date when present.

## Other responses

- `401` — API key is missing or invalid
- `500` — Internal Server Error

## Changes

- **2024-02-19** `8adde3b15a39` — 1 info
  - api operation id `getSites` was added
- **2024-02-16** `171418be692b` — 5 breaking, 2 warning
  - removed the required property `channels` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `network` from the response with the `200` status
  - removed the required property `nmi` from the response with the `200` status
  - …3 more
- **2024-02-16** `ecefb836e757` — 7 info
  - added the optional property `activeFrom` to the response with the `200` status
  - added the optional property `closedOn` to the response with the `200` status
  - added the required property `channels` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - …3 more
- **2024-02-16** `d5a4727e69d5` — 5 breaking, 2 warning
  - removed the required property `channels` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `network` from the response with the `200` status
  - removed the required property `nmi` from the response with the `200` status
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/amberelectric/apis/amber-electric-public-api/changes/sites/get.md)

---

[API](https://skmtc.dev/amberelectric/apis/amber-electric-public-api.md) · [All operations](https://skmtc.dev/amberelectric/apis/amber-electric-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/amberelectric/amber-electric-public-api/revisions/1f80cddf9ed6/schema)