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,
      "steered_by_nomos": false,
      "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",
      "updated_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,
      "steered_by_nomos": false,
      "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",
      "updated_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

integer

default:10

Required range: 1 <= x <= 100

filter[field][operator]

any | null

Filterable fields:

household (string): eq, in
external_id (string): eq, in
type (enum: household_net, household_residual, inverter, solar, battery, wallbox, heat_pump): eq, ne, in
status (enum: active, decommissioned): eq, ne, in
parent_inverter (string): eq, in
created_at (date): gte, lte
updated_at (date): gte, lte

Any other field or operator returns 400. See Filtering Documentation for the 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