---
updatedAt: 2026-09-08T10:21:10.000Z
agentTools:
  projectIndex: https://developers.tron.network/llms.txt
---

# ListWitnesses

List all Super Representatives.

## Related resources

* [Createwitness](https://developers.tron.network/reference/createwitness) — next in this section
* [Voting for SRs](https://developers.tron.network/docs/voting-for-srs) — voting mechanics and per-cycle reward snapshots
* [Super Representatives](https://developers.tron.network/docs/super-representatives) — SR role, 27 active / 127 ranked

# 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": {
    "responses": {
      "NodeHttpError": {
        "description": "Non-2xx error returned by the node or an upstream service. The status code depends on request validation, node state, and gateway policy.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "Error": {
                  "type": "string",
                  "description": "Error text returned by java-tron."
                },
                "code": {
                  "type": "string",
                  "description": "Optional error code returned by the node or gateway."
                },
                "message": {
                  "type": "string",
                  "description": "Optional error message returned by the node or gateway."
                }
              },
              "additionalProperties": true
            }
          }
        }
      }
    },
    "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/listwitnesses": {
      "get": {
        "summary": "ListWitnesses",
        "description": "List all Super Representatives.",
        "operationId": "listwitnesses",
        "deprecated": false,
        "security": [],
        "parameters": [
          {
            "in": "query",
            "name": "visible",
            "schema": {
              "type": "boolean"
            },
            "description": "Optional. Set to `true` to format addresses in Base58; set to `false` for hex format. (Default: `false`)"
          }
        ],
        "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": {
                "schema": {
                  "oneOf": [
                    {
                      "title": "Result",
                      "not": {
                        "type": "object",
                        "required": [
                          "Error"
                        ]
                      },
                      "type": "object",
                      "properties": {
                        "address": {
                          "type": "string",
                          "description": "Super Representative (SR) address."
                        },
                        "voteCount": {
                          "type": "integer",
                          "format": "int64",
                          "description": "Total number of votes received."
                        },
                        "url": {
                          "type": "string",
                          "description": "URL of the Super Representative's (SR) official website."
                        },
                        "totalProduced": {
                          "type": "integer",
                          "format": "int64",
                          "description": "Total number of blocks produced by the SR."
                        },
                        "totalMissed": {
                          "type": "integer",
                          "format": "int64",
                          "description": "Total number of blocks missed by the SR."
                        },
                        "latestBlockNum": {
                          "type": "integer",
                          "format": "int64",
                          "description": "Latest block number (height)."
                        },
                        "latestSlotNum": {
                          "type": "integer",
                          "format": "int64",
                          "description": "Latest slot number."
                        },
                        "isJobs": {
                          "type": "boolean",
                          "description": "Whether the SR is eligible to produce blocks."
                        }
                      }
                    },
                    {
                      "$ref": "#/components/schemas/NodeHttpBusinessError"
                    }
                  ]
                },
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/NodeHttpError"
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```