Skip to main content
GET
/
v1.0.0
/
batteries
All batteries
curl --request GET \
  --url https://api.energy-hub.io/v1.0.0/batteries \
  --header 'X-API-KEY: <api-key>'
{
  "totalPages": 1,
  "content": [
    {
      "vendor": "FRONIUS",
      "isOnline": true,
      "model": "Charge",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "userId": "896f9d5a-b618-48a2-98ae-957059bf1bc9",
      "lastUpdated": "2023-11-07T05:31:56Z",
      "name": "My device",
      "chargingState": "CHARGING"
    }
  ],
  "totalElements": 1
}

Authorizations

​
X-API-KEY
string
header
required

API key used for authorization and authentication.

Query Parameters

​
sortField
enum<string>
required

Sorting field. Default value is USER_ID

Available options:
USER_ID,
VENDOR,
IS_ONLINE,
LAST_UPDATED
​
uuid
string<uuid>

Search by battery UUID

​
userId
string

Search by user ID (partial match, case-insensitive)

​
isOnline
boolean

Filter by online status

​
name
string

Search by battery display name (partial match, case-insensitive)

​
vendor
enum<string>

Filter by vendor

Available options:
FRONIUS,
TESLA,
HUAWEI,
SMA,
ENPHASE
​
model
string

Search by battery model (partial match, case-insensitive)

​
lastUpdatedFrom
string<date-time>

Filter by UTC last updated date (from this date onwards).

​
lastUpdatedTo
string<date-time>

Filter by UTC last updated date (To this date).

​
chargingState
string

The state of the battery.

​
sortOrder
enum<string>
required

Sorting order. Default value is DESC.

Available options:
ASC,
DESC
​
page
integer<int32>
required

Zero-based page index (0..N)

Required range: x >= 0
​
size
integer<int32>
required

The size of the page to be returned. Default value is 10. Maximum value is 100.

Required range: 1 <= x <= 100

Response

Successful operation

​
totalPages
integer<int64>
required

Total number of pages.

Example:

1

​
content
object[]
required

Elements in the page. If there is no elements the list will be empty.

​
totalElements
integer<int64>
required

Total number of elements.

Example:

1