Inverters

Get inverter overview list

Inverter Overview

Returns a list of all available Inverters however with simplified data properties.

Overview

This endpoint provides a lightweight version of the full inverter list, returning essential inverter information without the complete technical specifications and detailed configuration data. It’s optimized for scenarios where you need a quick overview of available inverters without the overhead of fetching complete inverter records.

Response Fields

The simplified response includes the following fields for each inverter:

Field	Type	Description
`id`	integer	Unique identifier for the inverter
`ownerId`	integer	ID of the user or organization that owns this inverter configuration
`name`	string	Display name for the inverter
`status`	integer	Current status of the inverter record (1=Draft, 2=In Review, 3=Active, 4=Archived)
`lastModified`	string (ISO 8601)	Timestamp of the last modification to this inverter record
`lastModifiedBy`	object	User who last modified the record
`lastModifiedBy.firstName`	string	First name of the user who last modified the record
`lastModifiedBy.lastName`	string	Last name of the user who last modified the record
`model`	string	Manufacturer’s model number/name for the inverter
`manufacturer`	string	Name of the inverter manufacturer
`powerRated`	number	Rated power output of the inverter in kW
`outputVoltage`	number	Output voltage of the inverter in volts
`minVoltage`	number	Minimum operating voltage in volts
`maxMPPVoltage`	number	Maximum Power Point (MPP) voltage in volts
`inverterType`	integer	Type classification of the inverter (1=String Inverter, 2=Central Inverter)

Excluded Fields

Compared to the full inverter endpoint, this simplified overview excludes:

Detailed efficiency curves and performance data
Complete electrical specifications and ratings
Thermal characteristics and derating factors
Advanced configuration parameters
Certification and compliance documentation
Extended metadata and custom fields

Use Cases

When to Use This Endpoint

Dashboard displays - Populating dropdown lists or selection menus
Quick searches - Finding inverters by name or manufacturer without loading full details
List views - Displaying tables of available inverters with basic information
Performance optimization - Reducing payload size and response time for overview screens
Mobile applications - Minimizing data transfer for bandwidth-constrained environments

When to Use the Full Endpoint

Detailed analysis - When you need complete technical specifications for engineering calculations
Configuration management - Setting up or modifying inverter parameters in a project
Reporting - Generating comprehensive reports that require all inverter data
Data export - Extracting complete inverter information for external systems

GET

Inverter

InverterOverview

Get inverter overview list

curl --request GET \
  --url https://api.plantpredict.terabase.energy/Inverter/InverterOverview \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.plantpredict.terabase.energy/Inverter/InverterOverview"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.plantpredict.terabase.energy/Inverter/InverterOverview', 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.plantpredict.terabase.energy/Inverter/InverterOverview",
  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.plantpredict.terabase.energy/Inverter/InverterOverview"

	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.plantpredict.terabase.energy/Inverter/InverterOverview")

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

[
  {
    "id": 8344,
    "ownerId": 5109,
    "name": "Ginlong Technologies Solis-125K-EHV-5G",
    "status": 3,
    "lastModified": "2022-02-04T13:54:22.28",
    "lastModifiedBy": {
      "firstName": "Martin",
      "lastName": "Schneider"
    },
    "model": "Solis-125K-EHV-5G",
    "manufacturer": "Ginlong Technologies",
    "powerRated": 125,
    "outputVoltage": 600,
    "minVoltage": 860,
    "maxMPPVoltage": 1450,
    "inverterType": 1
  },
  {
    "id": 8651,
    "ownerId": 5109,
    "name": "SMA Sunny Central 4200 UP_PV SYST IMPORT",
    "status": 3,
    "lastModified": "2022-01-13T09:01:54.4",
    "lastModifiedBy": {
      "firstName": "Martin",
      "lastName": "Schneider"
    },
    "model": "Sunny Central 4200 UP",
    "manufacturer": "SMA",
    "powerRated": 4200,
    "outputVoltage": 630,
    "minVoltage": 921,
    "maxMPPVoltage": 1325,
    "inverterType": 2
  },
  {
    "id": 8693,
    "ownerId": 4876,
    "name": "Power Electronics FS4200MU CE 20201203",
    "status": 2,
    "lastModified": "2022-02-23T21:33:50.397",
    "lastModifiedBy": {
      "firstName": "Jason",
      "lastName": "Spokes"
    },
    "model": "FS4200MU CE 20201203",
    "manufacturer": "Power Electronics",
    "powerRated": 4200,
    "outputVoltage": 34500,
    "minVoltage": 934,
    "maxMPPVoltage": 1500,
    "inverterType": 2
  },
  {
    "id": 8728,
    "ownerId": 5109,
    "name": "Power Electronics FS4200MU CE 20210422, temp extension",
    "status": 3,
    "lastModified": "2024-10-24T09:45:36.183",
    "lastModifiedBy": {
      "firstName": "Andrija",
      "lastName": "Marusic"
    },
    "model": "FS4200MU CE 20210422",
    "manufacturer": "Power Electronics",
    "powerRated": 4200,
    "outputVoltage": 34500,
    "minVoltage": 934,
    "maxMPPVoltage": 1500,
    "inverterType": 2
  },
  {
    "id": 8736,
    "ownerId": 5032,
    "name": "Huawei Technologies SUN2000-200KTL-H2",
    "status": 3,
    "lastModified": "2022-04-20T07:38:43.21",
    "lastModifiedBy": {
      "firstName": "Claude",
      "lastName": "Deuda"
    },
    "model": "SUN2000-200KTL-H2",
    "manufacturer": "Huawei Technologies",
    "powerRated": 185,
    "outputVoltage": 800,
    "minVoltage": 500,
    "maxMPPVoltage": 1500,
    "inverterType": 1
  },
  {
    "id": 8744,
    "ownerId": 3927,
    "name": "imported-Power Electronics FS3190MU CE 20190927",
    "status": 3,
    "lastModified": "2022-03-17T04:13:27.363",
    "lastModifiedBy": {
      "firstName": "Thang",
      "lastName": "Le"
    },
    "model": "imported-FS3190MU CE 20190927",
    "manufacturer": "Power Electronics",
    "powerRated": 3300,
    "outputVoltage": 34500,
    "minVoltage": 849,
    "maxMPPVoltage": 1310,
    "inverterType": 2
  },
  {
    "id": 8956,
    "ownerId": 5093,
    "name": "TMEIC PVU-L840GR 25C",
    "status": 2,
    "lastModified": "2022-09-16T13:17:12.46",
    "lastModifiedBy": {
      "firstName": "Jesse",
      "lastName": "Milam"
    },
    "model": "PVU-L840GR 25C",
    "manufacturer": "TMEIC",
    "powerRated": 840,
    "outputVoltage": 630,
    "minVoltage": 915,
    "maxMPPVoltage": 1300,
    "inverterType": 2
  },
  {
    "id": 9008,
    "ownerId": 5032,
    "name": "Sungrow SG3125HV-30",
    "status": 3,
    "lastModified": "2022-10-13T01:56:32.4",
    "lastModifiedBy": {
      "firstName": "Carol",
      "lastName": "Aber"
    },
    "model": "SG3125HV-30",
    "manufacturer": "Sungrow",
    "powerRated": 3125,
    "outputVoltage": 600,
    "minVoltage": 875,
    "maxMPPVoltage": 1300,
    "inverterType": 2
  },
  {
    "id": 9011,
    "ownerId": 5032,
    "name": "Huawei Technologies SUN2000-330KTL-H1-Preliminary V0.1",
    "status": 4,
    "lastModified": "2022-10-12T22:28:35.933",
    "lastModifiedBy": {
      "firstName": "Claude",
      "lastName": "Deuda"
    },
    "model": "SUN2000-330KTL-H1-Preliminary V0.1",
    "manufacturer": "Huawei Technologies",
    "powerRated": 300,
    "outputVoltage": 800,
    "minVoltage": 500,
    "maxMPPVoltage": 1500,
    "inverterType": 2
  },
  {
    "id": 9017,
    "ownerId": 4876,
    "name": "Huawei Technologies SUN2000-330KTL-H1-Preliminary V0.1",
    "status": 4,
    "lastModified": "2023-01-23T23:50:02.017",
    "lastModifiedBy": {
      "firstName": "Jason",
      "lastName": "Spokes"
    },
    "model": "SUN2000-330KTL-H1-Preliminary V0.1",
    "manufacturer": "Huawei Technologies",
    "powerRated": 300,
    "outputVoltage": 800,
    "minVoltage": 500,
    "maxMPPVoltage": 1500,
    "inverterType": 1
  }
]

"An error has occurred."

Authorizations

Authorization

string

header

required

Pass Authorization: Bearer <token> on every request. See the Authentication section of the API description for how to fetch a token.

Response

Inverter overviews

integer

ownerId

integer

name

string

status

enum<integer>

LibraryStatusEnum

Available options:

0,

1,

2,

3,

4,

5,

6

lastModified

string

ISO-8601 datetime as returned by the PlantPredict API. May or may not include a timezone offset; treat as server-local when no offset is present.

lastModifiedBy

string

model

string

manufacturer

string

powerRated

number

outputVoltage

number

minVoltage

number

maxMPPVoltage

number

inverterType

enum<integer>

InverterType

Available options:

0,

1,

2

⌘I

Get inverter overview list

curl --request GET \
  --url https://api.plantpredict.terabase.energy/Inverter/InverterOverview \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.plantpredict.terabase.energy/Inverter/InverterOverview"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.plantpredict.terabase.energy/Inverter/InverterOverview', 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.plantpredict.terabase.energy/Inverter/InverterOverview",
  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.plantpredict.terabase.energy/Inverter/InverterOverview"

	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.plantpredict.terabase.energy/Inverter/InverterOverview")

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

[
  {
    "id": 8344,
    "ownerId": 5109,
    "name": "Ginlong Technologies Solis-125K-EHV-5G",
    "status": 3,
    "lastModified": "2022-02-04T13:54:22.28",
    "lastModifiedBy": {
      "firstName": "Martin",
      "lastName": "Schneider"
    },
    "model": "Solis-125K-EHV-5G",
    "manufacturer": "Ginlong Technologies",
    "powerRated": 125,
    "outputVoltage": 600,
    "minVoltage": 860,
    "maxMPPVoltage": 1450,
    "inverterType": 1
  },
  {
    "id": 8651,
    "ownerId": 5109,
    "name": "SMA Sunny Central 4200 UP_PV SYST IMPORT",
    "status": 3,
    "lastModified": "2022-01-13T09:01:54.4",
    "lastModifiedBy": {
      "firstName": "Martin",
      "lastName": "Schneider"
    },
    "model": "Sunny Central 4200 UP",
    "manufacturer": "SMA",
    "powerRated": 4200,
    "outputVoltage": 630,
    "minVoltage": 921,
    "maxMPPVoltage": 1325,
    "inverterType": 2
  },
  {
    "id": 8693,
    "ownerId": 4876,
    "name": "Power Electronics FS4200MU CE 20201203",
    "status": 2,
    "lastModified": "2022-02-23T21:33:50.397",
    "lastModifiedBy": {
      "firstName": "Jason",
      "lastName": "Spokes"
    },
    "model": "FS4200MU CE 20201203",
    "manufacturer": "Power Electronics",
    "powerRated": 4200,
    "outputVoltage": 34500,
    "minVoltage": 934,
    "maxMPPVoltage": 1500,
    "inverterType": 2
  },
  {
    "id": 8728,
    "ownerId": 5109,
    "name": "Power Electronics FS4200MU CE 20210422, temp extension",
    "status": 3,
    "lastModified": "2024-10-24T09:45:36.183",
    "lastModifiedBy": {
      "firstName": "Andrija",
      "lastName": "Marusic"
    },
    "model": "FS4200MU CE 20210422",
    "manufacturer": "Power Electronics",
    "powerRated": 4200,
    "outputVoltage": 34500,
    "minVoltage": 934,
    "maxMPPVoltage": 1500,
    "inverterType": 2
  },
  {
    "id": 8736,
    "ownerId": 5032,
    "name": "Huawei Technologies SUN2000-200KTL-H2",
    "status": 3,
    "lastModified": "2022-04-20T07:38:43.21",
    "lastModifiedBy": {
      "firstName": "Claude",
      "lastName": "Deuda"
    },
    "model": "SUN2000-200KTL-H2",
    "manufacturer": "Huawei Technologies",
    "powerRated": 185,
    "outputVoltage": 800,
    "minVoltage": 500,
    "maxMPPVoltage": 1500,
    "inverterType": 1
  },
  {
    "id": 8744,
    "ownerId": 3927,
    "name": "imported-Power Electronics FS3190MU CE 20190927",
    "status": 3,
    "lastModified": "2022-03-17T04:13:27.363",
    "lastModifiedBy": {
      "firstName": "Thang",
      "lastName": "Le"
    },
    "model": "imported-FS3190MU CE 20190927",
    "manufacturer": "Power Electronics",
    "powerRated": 3300,
    "outputVoltage": 34500,
    "minVoltage": 849,
    "maxMPPVoltage": 1310,
    "inverterType": 2
  },
  {
    "id": 8956,
    "ownerId": 5093,
    "name": "TMEIC PVU-L840GR 25C",
    "status": 2,
    "lastModified": "2022-09-16T13:17:12.46",
    "lastModifiedBy": {
      "firstName": "Jesse",
      "lastName": "Milam"
    },
    "model": "PVU-L840GR 25C",
    "manufacturer": "TMEIC",
    "powerRated": 840,
    "outputVoltage": 630,
    "minVoltage": 915,
    "maxMPPVoltage": 1300,
    "inverterType": 2
  },
  {
    "id": 9008,
    "ownerId": 5032,
    "name": "Sungrow SG3125HV-30",
    "status": 3,
    "lastModified": "2022-10-13T01:56:32.4",
    "lastModifiedBy": {
      "firstName": "Carol",
      "lastName": "Aber"
    },
    "model": "SG3125HV-30",
    "manufacturer": "Sungrow",
    "powerRated": 3125,
    "outputVoltage": 600,
    "minVoltage": 875,
    "maxMPPVoltage": 1300,
    "inverterType": 2
  },
  {
    "id": 9011,
    "ownerId": 5032,
    "name": "Huawei Technologies SUN2000-330KTL-H1-Preliminary V0.1",
    "status": 4,
    "lastModified": "2022-10-12T22:28:35.933",
    "lastModifiedBy": {
      "firstName": "Claude",
      "lastName": "Deuda"
    },
    "model": "SUN2000-330KTL-H1-Preliminary V0.1",
    "manufacturer": "Huawei Technologies",
    "powerRated": 300,
    "outputVoltage": 800,
    "minVoltage": 500,
    "maxMPPVoltage": 1500,
    "inverterType": 2
  },
  {
    "id": 9017,
    "ownerId": 4876,
    "name": "Huawei Technologies SUN2000-330KTL-H1-Preliminary V0.1",
    "status": 4,
    "lastModified": "2023-01-23T23:50:02.017",
    "lastModifiedBy": {
      "firstName": "Jason",
      "lastName": "Spokes"
    },
    "model": "SUN2000-330KTL-H1-Preliminary V0.1",
    "manufacturer": "Huawei Technologies",
    "powerRated": 300,
    "outputVoltage": 800,
    "minVoltage": 500,
    "maxMPPVoltage": 1500,
    "inverterType": 1
  }
]

"An error has occurred."

Introduction

Quick Start Guides

API Reference

API Tools

SDK Documentation

Get inverter overview list

Inverter Overview

Overview

Response Fields

Excluded Fields

Use Cases

When to Use This Endpoint

When to Use the Full Endpoint

Authorizations

Response