Sites

Site management endpoints — create and manage physical locations with energy resources.

A Site represents a physical location with energy resources — typically a home, building, or facility. Sites belong to an organization and contain devices and DERs.

Endpoints

List Sites

GET /sites

Returns all sites across orgs the authenticated identity has access to.

Query Parameters:

ParameterDescription
org_idFilter by organization

Response:

[
  {
    "id": "sit-abc123",
    "org_id": "org-xyz789",
    "name": "Home",
    "created_at": "2026-03-06T10:00:00Z"
  }
]

Create Site

POST /sites

Request Body:

{
  "org_id": "org-xyz789",
  "name": "Home"
}

Get Site

GET /sites/{site_id}

Returns site details including connected devices.

Update Site

PUT /sites/{site_id}

Request Body:

{
  "name": "Updated Name"
}

Delete Site

DELETE /sites/{site_id}

List Site Devices

GET /sites/{site_id}/devices

Returns all devices provisioned to this site.

Response:

[
  {
    "id": "dev-abc123",
    "name": "Sungrow Inverter",
    "type": "inverter",
    "state": "active",
    "hardware_id": "SN12345",
    "ders": [
      { "id": "der-001", "name": "pv-array", "type": "solar" },
      { "id": "der-002", "name": "battery_1", "type": "battery" }
    ]
  }
]

Knowledge gap for Johan: Verify exact endpoint paths and response schemas. Does a site have additional fields like location, timezone, or grid connection metadata? What is the full site object structure?

Related Documentation