Inverters_V2

Get a list of the inverters in the plant with the data of the current time.

You can enter a range of dates to get the data for that period.

/v2/inverters/<inv_id>/?start=XXX&end=XXX

Arguments

  • id_inverter [*]: ID inverter.
  • start: (Optional) (yyyy-mm-dd hh:ii:ss) Start date of search interval.
    If you only enter the start date it will show the reading of that moment.
  • end: (Optional) (yyyy-mm-dd hh:ii:ss) End date of search interval.
    Can not be greater than the current date or the difference
    between dates can not be greater than 32 days
  • fields: (Optional) Comma-separated list of variables to return, with or
    without the table prefix (e.g. Pact_ac,energy). Datetime and
    devices_id are always returned. Unknown fields return 400.

Response

JSON object with the result. May return the following errors:

  • 404 Not found : No device found or don't have rights to get data
  • 400 Wrong inverter id: The id format is incorrect
  • 400 Bad Dates: Dates entered are incorrect
  • 204 No data found: The data entered have not produced any results

Example

Get inverter data from start to now

GET /v2/inverters/217?start=2017-04-10%2017:15:00 HTTP/1.1
Host: apiexternal.mvscada.com
MV-API-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Content-Type: application/json

Response

{
"group": 'Group 1',
"devices_id": 217,
"start": "2017-04-10 17:15:00",
"end": "",
"inverters": [
    {
        "IT_ac": 4.89,
        "V1_dc": 67.45,
        "datetime": "2017-04-10 17:15:00",
        "id": "217",
        "IR_ac": 4.88,
        "cosfi": null,
        "V3_dc": 68.14,
        "Preac_ac": null,
        "Pact_ac": 3.46398,
        "energia": 0.818,
        "I2_dc": 19.38,
        "VT_ac": 231.96,
        "VS_ac": 233.92,
        "Papar_ac": null,
        "T1": null,
        "I3_dc": 18.39,
        "freq": null,
        "pot_inst_dc": 3.79281,
        "VR_ac": 233.78,
        "alarma": null,
        "I1_dc": 18.38,
        "IS_ac": 5.09,
        "V2_dc": 67.14
    },
    {
        "IT_ac": 4.95,
        "V1_dc": 67.35,
        "datetime": "2017-04-10 17:30:00",
        ...
        "V2_dc": 66.89
    },
    {...}
]
}

Other examples



Get data from several inverters of the same plant in one response.

/v2/inverters/?gid=XXX&start=XXX&end=XXX
/v2/inverters/?ids=XXX,YYY&start=XXX&end=XXX

Arguments

  • gid: Group (plant) id: returns all its inverters. Use gid or ids.
  • ids: Comma-separated inverter ids, all from the same plant.
  • start: (Optional) (yyyy-mm-dd hh:ii:ss) Start date of search interval.
    If you only enter the start date it will show the reading of that moment.
  • end: (Optional) (yyyy-mm-dd hh:ii:ss) End date of search interval.
    Can not be greater than the current date or the difference
    between dates can not be greater than 1 day
  • fields: (Optional) Comma-separated list of variables to return, with or
    without the table prefix (e.g. Pact_ac,energy). Datetime and
    devices_id are always returned. Unknown fields return 400.

Response

JSON object with the result, rows ordered by devices_id and datetime.
May return the following errors:

  • 404 Not found : No device found or don't have rights to get data
  • 400 Bad request: gid/ids, dates or fields are incorrect

Example

GET /v2/inverters/?gid=289&start=2026-10-14%2000:00:00&end=2026-10-14%2023:59:59&fields=Pact_ac,energy HTTP/1.1
Host: apiexternal.mvscada.app
MV-API-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
{
"group": 289,
"devices_id": [9694, 9695],
"start": "2026-10-14 00:00:00",
"end": "2026-10-14 23:59:59",
"inverters": [
    {"data_inverters_datetime": "2026-10-14 00:00:00", "data_inverters_Pact_ac": 0.0, "data_inverters_energy": 0.0, "devices_id": 9694},
    ...
]
}