---
updatedAt: 2026-09-10T13:57:54.000Z
agentTools:
  projectIndex: https://developers.tron.network/llms.txt
---

# GetNextMaintenanceTime

Returns the next scheduled maintenance time as a timestamp in milliseconds.

The returned value is a scheduled threshold. The first block whose timestamp is equal to or later than this value triggers maintenance processing. If no block is produced at the scheduled time, processing begins with the next block that meets the threshold.

## Related resources

* [VoteWitnessAccount](https://developers.tron.network/reference/votewitnessaccount) — submit a new vote allocation for processing at the next scheduled maintenance update
* [WithdrawBalance](https://developers.tron.network/reference/withdrawbalance) — withdraw voting rewards accumulated by the account
* [Voting for SRs](https://developers.tron.network/docs/voting-for-srs) — voting mechanics and per-cycle reward snapshots
* [Consensus and DPoS](https://developers.tron.network/docs/concensus) — how Maintenance Periods and scheduled maintenance updates work

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "full-node-http-api",
    "version": "4.8.0"
  },
  "servers": [
    {
      "url": "https://api.shasta.trongrid.io",
      "description": "Shasta Testnet"
    },
    {
      "url": "https://nile.trongrid.io",
      "description": "Nile Testnet"
    },
    {
      "url": "https://api.trongrid.io",
      "description": "Mainnet (real assets)"
    }
  ],
  "components": {
    "schemas": {
      "NodeHttpBusinessError": {
        "title": "Error",
        "type": "object",
        "description": "When request processing fails, java-tron may return this format with HTTP 200; the `Error` field contains the error details.",
        "required": [
          "Error"
        ],
        "properties": {
          "Error": {
            "type": "string",
            "description": "Error text returned by java-tron."
          }
        },
        "examples": [
          {
            "Error": "Invalid request parameters."
          }
        ],
        "additionalProperties": false
      }
    }
  },
  "security": [
    {}
  ],
  "paths": {
    "/wallet/getnextmaintenancetime": {
      "get": {
        "summary": "GetNextMaintenanceTime",
        "description": "Returns the next scheduled maintenance time as a timestamp in milliseconds. The first block whose timestamp reaches or exceeds this value triggers maintenance processing.",
        "operationId": "getnextmaintenancetime",
        "responses": {
          "200": {
            "description": "When the request completes normally, the response body contains the endpoint result. If request processing raises an exception, the HTTP status may still be 200; in that case, the response body contains only the `Error` field.",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\"num\": 1591099200000}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "title": "Result",
                      "not": {
                        "type": "object",
                        "required": [
                          "Error"
                        ]
                      },
                      "type": "object",
                      "properties": {
                        "num": {
                          "type": "integer",
                          "example": 1591099200000,
                          "default": 0
                        }
                      }
                    },
                    {
                      "$ref": "#/components/schemas/NodeHttpBusinessError"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```