Hanchu ESS · Schema

PostV1DeviceInverterHistoricalResponse

CompanyEnergyStorageBatteryRenewablesSmart Grid

Properties

Name Type Description
errno number Succeeded when 200, Failed when Non 200
msg string Error prompt message
data object Result.
data.records array Inverter groups
data.records[].uploadAt integer Upload epoch timestamp (Unit:ms)
data.records[].runTime integer Running time (Unit:H)
data.records[].workMode integer Work mode
data.records[].runStatus integer Run status
data.records[].pActive number Active power
data.records[].pReactive number Reactive power
data.records[].pf number Power factor
data.records[].pPv number Pv power
data.records[].ePvTodayGen number Today generation of pv (Unit:KWh)
data.records[].ePvGen number Total generation of pv (Unit:KWh)
data.records[].pEpsActive number Active power of eps
data.records[].pEpsReactive number Reactive power of eps
data.records[].eEpsToday number Today usage of eps (Unit:KWh)
data.records[].eEps number Total usage of eps (Unit:KWh)
data.records[].batComStatus integer Communication status of battery (5-Fault 10-Normal)
data.records[].batStatus integer Status of battery. (0-Not available 1-Idle 2-Charging 3-Discharging 4-Error)
data.records[].pBat number Battery power
data.records[].tBat number Battery temperature
data.records[].soc number Soc of battery
data.records[].soh number Soh of battery
data.records[].eBatTodayChg number Today charge of battery (Unit:KWh)
data.records[].eBatTodayDschg number Today discharge of battery (Unit:KWh)
data.records[].pLoad number Load power
data.records[].pMeter number Meter power
data.records[].pL1Grid number Grid power on L1 phase
data.records[].pL2Grid number Grid power on L2 phase
data.records[].pL3Grid number Grid power on L3 phase
data.records[].eGridBuy number Total bought from grid (Unit:KWh)
data.records[].eGridSell number Total sold to grid (Unit:KWh)
data.current number Current page number
data.size number The amount of data presented per page
data.total number Data volume total
data.pages number Page total
View JSON Schema on GitHub

JSON Schema

hanchu-ess-post-v1-device-inverter-historical-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/hanchu-ess/json-schema/hanchu-ess-post-v1-device-inverter-historical-response-schema.json",
  "title": "PostV1DeviceInverterHistoricalResponse",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/hanchu-ess-openapi-generated.yml#/components/schemas/PostV1DeviceInverterHistoricalResponse",
  "type": "object",
  "properties": {
    "errno": {
      "type": "number",
      "description": "Succeeded when 200, Failed when Non 200"
    },
    "msg": {
      "type": "string",
      "description": "Error prompt message"
    },
    "data": {
      "type": "object",
      "description": "Result."
    },
    "data.records": {
      "type": "array",
      "description": "Inverter groups"
    },
    "data.records[].uploadAt": {
      "type": "integer",
      "description": "Upload epoch timestamp (Unit:ms)"
    },
    "data.records[].runTime": {
      "type": "integer",
      "description": "Running time (Unit:H)"
    },
    "data.records[].workMode": {
      "type": "integer",
      "description": "Work mode"
    },
    "data.records[].runStatus": {
      "type": "integer",
      "description": "Run status"
    },
    "data.records[].pActive": {
      "type": "number",
      "description": "Active power"
    },
    "data.records[].pReactive": {
      "type": "number",
      "description": "Reactive power"
    },
    "data.records[].pf": {
      "type": "number",
      "description": "Power factor"
    },
    "data.records[].pPv": {
      "type": "number",
      "description": "Pv power"
    },
    "data.records[].ePvTodayGen": {
      "type": "number",
      "description": "Today generation of pv (Unit:KWh)"
    },
    "data.records[].ePvGen": {
      "type": "number",
      "description": "Total generation of pv (Unit:KWh)"
    },
    "data.records[].pEpsActive": {
      "type": "number",
      "description": "Active power of eps"
    },
    "data.records[].pEpsReactive": {
      "type": "number",
      "description": "Reactive power of eps"
    },
    "data.records[].eEpsToday": {
      "type": "number",
      "description": "Today usage of eps (Unit:KWh)"
    },
    "data.records[].eEps": {
      "type": "number",
      "description": "Total usage of eps (Unit:KWh)"
    },
    "data.records[].batComStatus": {
      "type": "integer",
      "description": "Communication status of battery (5-Fault 10-Normal)"
    },
    "data.records[].batStatus": {
      "type": "integer",
      "description": "Status of battery. (0-Not available 1-Idle 2-Charging 3-Discharging 4-Error)"
    },
    "data.records[].pBat": {
      "type": "number",
      "description": "Battery power"
    },
    "data.records[].tBat": {
      "type": "number",
      "description": "Battery temperature"
    },
    "data.records[].soc": {
      "type": "number",
      "description": "Soc of battery"
    },
    "data.records[].soh": {
      "type": "number",
      "description": "Soh of battery"
    },
    "data.records[].eBatTodayChg": {
      "type": "number",
      "description": "Today charge of battery (Unit:KWh)"
    },
    "data.records[].eBatTodayDschg": {
      "type": "number",
      "description": "Today discharge of battery (Unit:KWh)"
    },
    "data.records[].pLoad": {
      "type": "number",
      "description": "Load power"
    },
    "data.records[].pMeter": {
      "type": "number",
      "description": "Meter power"
    },
    "data.records[].pL1Grid": {
      "type": "number",
      "description": "Grid power on L1 phase"
    },
    "data.records[].pL2Grid": {
      "type": "number",
      "description": "Grid power on L2 phase"
    },
    "data.records[].pL3Grid": {
      "type": "number",
      "description": "Grid power on L3 phase"
    },
    "data.records[].eGridBuy": {
      "type": "number",
      "description": "Total bought from grid (Unit:KWh)"
    },
    "data.records[].eGridSell": {
      "type": "number",
      "description": "Total sold to grid (Unit:KWh)"
    },
    "data.current": {
      "type": "number",
      "description": "Current page number"
    },
    "data.size": {
      "type": "number",
      "description": "The amount of data presented per page"
    },
    "data.total": {
      "type": "number",
      "description": "Data volume total"
    },
    "data.pages": {
      "type": "number",
      "description": "Page total"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/hanchu-ess-post-v1-device-inverter-historical-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.