Energy_Management_Insts_V2

Get the instantaneous electrical readings of a single energy management device.

Voltages, currents, active/reactive power per phase, cosfi, frequency, THD,
per-line import/export and alarm registers.

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

/v2/energy_managements/insts/<dev-id>/?start=XXX&end=XXX

Arguments

dev_id [*]: Device id number
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. V1_ac,Pac,freq). 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 Bad Dates: Dates entered are incorrect

Example

GET /v2/energy_managements/insts/5/ HTTP/1.1
Host: apiexternal.mvscada.app
MV-API-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Content-Type: application/json

Response

{
    "plant": 1,
    "devices_id": 5,
    "start": "2026-10-16 10:30:00",
    "end": "",
    "energy_managements": [
        {
            "devices_id": 5,
            "data_energy_management_insts_datetime": "2026-10-16 10:30:00",
            "data_energy_management_insts_dst": 0,
            "data_energy_management_insts_V1_ac": 230.100,
            "data_energy_management_insts_Pac": 1000.000,
            "data_energy_management_insts_cosfi": 0.990,
            "data_energy_management_insts_freq": 50.010
        }
    ]
}

Other examples

Get only a few fields between requested dates

/v2/energy_managements/insts/<dev-id>/?start=2026-03-30 08:00:00&end=2026-03-31 08:00:00&fields=Pac,freq

Get the instantaneous electrical readings of several energy management devices of the same plant.

Same values as /v2/energy_managements/insts/<dev-id>/.

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

Arguments

gid: Group (plant) id: returns all its energy management devices. Use gid or ids.
ids: Comma-separated device 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.
Defaults to the current quarter.
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. V1_ac,Pac,freq). 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/energy_managements/insts/?gid=1&start=2026-10-16%2010:00:00&end=2026-10-16%2011:00:00&fields=Pac,freq HTTP/1.1
Host: apiexternal.mvscada.app
MV-API-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

{
"group": 1,
"devices_id": [5, 6],
"start": "2026-10-16 10:00:00",
"end": "2026-10-16 11:00:00",
"energy_managements": [
    {"devices_id": 5, "data_energy_management_insts_datetime": "2026-10-16 10:00:00", "data_energy_management_insts_Pac": 1000.000, "data_energy_management_insts_freq": 50.010},
    ...
]
}