Get Inverter Historical

post

Obtain inverter historical data by device ID.

Required scopes

This endpoint requires the following scopes:

• : all privileges

Authorizations

OAuth2Auth

OAuth2clientCredentialsRequired

Token URL:

---

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

Body

application/json

snstringRequired

Device serial number

Example: ST22****77FV

startinteger · int64Optional

Start Time(Note: EpochTime format, default recent 7 day)

Example: 1737257242000

endinteger · int64Optional

End Time(Note: EpochTime format, default recent 7 day)

Example: 1737862042000

currentnumberOptional

Current page number, default and minimum value is 1

Example: 1

sizenumberOptional

The amount pf data presented per page, default and minimum value is 10

Example: 10

Responses

200

Operation was successful

application/json

errnonumberRequired

Succeeded when 200, Failed when Non 200

Example: 200

msgstringRequired

Error prompt message

Example: The operation has been successful

400

Bad Request

application/json

401

Unauthorized

application/json

404

Device Does Not Exist

application/json

default

Internal error

application/json

post

/v1/device/inverter/historical

HTTPcURLJavaScriptPython

POST /portal/v1/device/inverter/historical HTTP/1.1
Host: idaas-sandbox.hanchuess.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "sn": "ST22****77FV",
  "start": 1737257242000,
  "end": 1737862042000,
  "sorts": {
    "field": "dataTimeTs",
    "order": "desc"
  },
  "current": 1,
  "size": 10
}

{
  "errno": 200,
  "msg": "The operation has been successful",
  "data": {
    "records": [
      {
        "uploadAt": 1744272667975,
        "runTime": 1969,
        "workMode": 3,
        "runStatus": 1,
        "pActive": -159,
        "pReactive": 0,
        "pf": -1,
        "pPv": 0,
        "ePvTodayGen": 0,
        "ePvGen": 41.4,
        "pEpsActive": 44,
        "pEpsReactive": 0,
        "eEpsToday": 0.5,
        "eEps": 65.1,
        "batComStatus": 10,
        "batStatus": 1,
        "pBat": 95,
        "tBat": 26,
        "soc": 0.29,
        "soh": 1,
        "eBatTodayChg": 0.6,
        "eBatTodayDschg": 0,
        "pLoad": 239,
        "pMeter": 0,
        "pL1Grid": 66,
        "pL2Grid": 62,
        "pL3Grid": 52,
        "eGridBuy": 755.8,
        "eGridSell": 268.1
      }
    ],
    "current": 1,
    "size": 10,
    "total": 1,
    "pages": 1
  }
}