Get Device Detail

post

Obtain device detail 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

Inverter serial number

Example: H015****0001

Responses

200

Operation was successful

application/json

errnointegerRequired

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/detail

HTTPcURLJavaScriptPython

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

{
  "sn": "H015****0001"
}

{
  "errno": 200,
  "msg": "The operation has been successful",
  "data": {
    "sn": "H015****0001",
    "phase": 3,
    "model": "HOME-ESS-HV-2.7K-BDU",
    "status": "ONLINE",
    "ratedPower": 10000,
    "regulatoryVer": "V610-11022-10",
    "softwareVer": "V610-05001-12",
    "lastUploadAt": 1744176212957,
    "createAt": 1736318991018,
    "batteries": [
      {
        "sn": "B0B14****0049",
        "model": "HOME-ESS-HV-2.7K-BDU",
        "softwareVer": "BAT-Logger-E100_2.4.1_T",
        "capacity": 8.1
      }
    ]
  }
}