List assets

curl --request GET \
  --url https://api.nomos.energy/assets \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.nomos.energy/assets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nomos.energy/assets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.nomos.energy/assets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.nomos.energy/assets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "items": [
    {
      "object": "asset",
      "id": "ha_b7q2m1k8v4n0x3c9l5p2r7td",
      "household": "dom_k3v9x2m7n1b4v8c2x6z0q5wd",
      "parent_inverter": "ha_i9k3l7w2e5r8t1y4u6o0p3as",
      "external_id": "partner-bat-1",
      "status": "active",
      "is_steerable": true,
      "manufacturer": "BYD",
      "model": "Battery-Box Premium HVS 10.2",
      "installed_at": null,
      "metadata": {
        "serial_number": "34118573"
      },
      "decommissioned_at": null,
      "created_at": "2026-10-06T09:12:44Z",
      "type": "battery",
      "battery": {
        "capacity_kwh": 10.2,
        "max_in_kw": 5,
        "max_out_kw": 5,
        "min_soc": 0.1,
        "max_soc": 0.95
      }
    }
  ],
  "next_page": "eyJsYXN0X2NyZWF0ZWRfYXQiOiIyMDI1LTAxLTE1VDEwOjMwOjAwLjAwMFoiLCJsYXN0X2lkIjoic3ViX21pNGYwb2RhNng5bTdnY3N2amswb2xlMSIsImxpbWl0IjoyMH0=",
  "has_more": false
}

GET

assets

List assets

curl --request GET \
  --url https://api.nomos.energy/assets \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.nomos.energy/assets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nomos.energy/assets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.nomos.energy/assets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.nomos.energy/assets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "items": [
    {
      "object": "asset",
      "id": "ha_b7q2m1k8v4n0x3c9l5p2r7td",
      "household": "dom_k3v9x2m7n1b4v8c2x6z0q5wd",
      "parent_inverter": "ha_i9k3l7w2e5r8t1y4u6o0p3as",
      "external_id": "partner-bat-1",
      "status": "active",
      "is_steerable": true,
      "manufacturer": "BYD",
      "model": "Battery-Box Premium HVS 10.2",
      "installed_at": null,
      "metadata": {
        "serial_number": "34118573"
      },
      "decommissioned_at": null,
      "created_at": "2026-10-06T09:12:44Z",
      "type": "battery",
      "battery": {
        "capacity_kwh": 10.2,
        "max_in_kw": 5,
        "max_out_kw": 5,
        "min_soc": 0.1,
        "max_soc": 0.95
      }
    }
  ],
  "next_page": "eyJsYXN0X2NyZWF0ZWRfYXQiOiIyMDI1LTAxLTE1VDEwOjMwOjAwLjAwMFoiLCJsYXN0X2lkIjoic3ViX21pNGYwb2RhNng5bTdnY3N2amswb2xlMSIsImxpbWl0IjoyMH0=",
  "has_more": false
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

cursor

string | null

limit

number

default:10

Required range: 1 <= x <= 100

filter[field][operator]

any | null

Filterable fields:

household (string)
external_id (string)
type (enum): household_net, household_residual, inverter, solar, battery, wallbox, heat_pump
status (enum): active, decommissioned
parent_inverter (string)

See Filtering Documentation for supported operators and syntax.

Example:

"value"

Response

List the assets of your households.

object

enum<string>

required

Available options:

list

items

required

A device in a household, or one of the two assets Nomos creates per household. It carries the type data object named like its type, with every field present and null where unknown.

Show child attributes

next_page

string | null

Example:

"eyJsYXN0X2NyZWF0ZWRfYXQiOiIyMDI1LTAxLTE1VDEwOjMwOjAwLjAwMFoiLCJsYXN0X2lkIjoic3ViX21pNGYwb2RhNng5bTdnY3N2amswb2xlMSIsImxpbWl0IjoyMH0="

has_more

boolean

default:false