Skip to Content
APIWitnessGet Account Vote List

Get Account Vote List

1. Overview & Typical Use

Returns the vote list for a specified account, showing the number of votes cast to each Super Representative.

  • Typical use: view a user’s vote distribution, vote management panel.
  • When not to use: for aggregated SR vote info use “Get Current SR Vote Info”; for SR list use “Get Super Representative List”.
  • address is required; accounts with no votes return votes: {} as a normal response.

2. Endpoint & Authentication

GET /api/account/votes

For Base URL and authentication, see Common Network & Authentication.

3. Request

ParameterTypeRequiredDefaultDescription
addressstringYesAccount address (Base58, starts with T)

4. Response

FieldTypeRequiredDescription
votesobjectRequiredVote map: key = SR address, value = vote count

5. Errors

For HTTP status codes, see Common Errors. Notes for this endpoint:

  • address is required: omitting it returns a missing parameter error.
  • No votes is not an error: an account with no votes returns 200 + votes: {}, which is a normal response.
Last updated on: