# GET: /voter/:proposalId

## GET: /voter/:proposalId

### VoterProposalRequest

The request to the Voter Proposal API allows filtering by specific accounts and voting support status.

Request Parameters

<table><thead><tr><th valign="middle">Type</th><th valign="middle">Key</th><th valign="middle">Description</th></tr></thead><tbody><tr><td valign="middle">boolean</td><td valign="middle"><code>support</code></td><td valign="middle">Filter by voter support (true for yes, false for no)</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>limit</code></td><td valign="middle">Number of results per page</td></tr></tbody></table>

### VoterProposalResponse

The API returns a list of voters who participated in the specified proposal, along with their vote details.

Response Structure

<table><thead><tr><th valign="middle">Type</th><th valign="middle">Key</th><th valign="middle">Description</th></tr></thead><tbody><tr><td valign="middle">Struct</td><td valign="middle"><code>metadata</code></td><td valign="middle">Metadata on request (see VoterMetadata)</td></tr><tr><td valign="middle">Struct</td><td valign="middle"><code>data</code></td><td valign="middle">List of voters (see Voter)</td></tr></tbody></table>

### VoterMetadata

Pagination and summary metadata for the voter list.

<table><thead><tr><th valign="middle">Type</th><th valign="middle"></th><th valign="middle">Description</th></tr></thead><tbody><tr><td valign="middle">uint32</td><td valign="middle"><code>page</code></td><td valign="middle">Current page number</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>limit</code></td><td valign="middle">Results per page</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>totalItem</code></td><td valign="middle">Total number of voters recorded</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>totalPage</code></td><td valign="middle">Total number of pages for given limit</td></tr><tr><td valign="middle">string</td><td valign="middle"><code>sumVotes</code></td><td valign="middle">The total number of votes cast</td></tr></tbody></table>

### &#x20;Voter Object

A detailed structure representing a voter's participation in a governance proposal.

<table><thead><tr><th valign="middle">Type</th><th valign="middle">Key</th><th valign="middle">Description</th></tr></thead><tbody><tr><td valign="middle">bytes</td><td valign="middle"><code>id</code></td><td valign="middle">Unique voter ID</td></tr><tr><td valign="middle">string</td><td valign="middle"><code>address</code></td><td valign="middle">Voter's Ethereum address</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>has_voted</code></td><td valign="middle">1 if voted, 0 otherwise</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>support</code></td><td valign="middle">1 for yes, 0 for no</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>proposal_id</code></td><td valign="middle">Proposal ID associated with the vote</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>block_number</code></td><td valign="middle">Block number when the vote was cast</td></tr><tr><td valign="middle">uint32</td><td valign="middle"><code>block_timestamp</code></td><td valign="middle">Timestamp when the vote was recorded</td></tr><tr><td valign="middle">Timestamp</td><td valign="middle"><code>created_at</code></td><td valign="middle">Vote record creation timestamp</td></tr><tr><td valign="middle">Timestamp</td><td valign="middle"><code>updated_at</code></td><td valign="middle">Last update timestamp</td></tr><tr><td valign="middle">string</td><td valign="middle"><code>votes</code></td><td valign="middle">Number of votes cast by the voter</td></tr></tbody></table>

#### Usage Notes

* Retrieving Voter Data: Use this endpoint to fetch detailed information on voters participating in a given proposal.
* Filtering by Support Status: The support parameter allows querying for supporting or opposing votes.
* Tracking Voting Trends: The sumVotes metadata field provides a total count of votes cast.
* Monitoring Individual Voting Activity: Each voter entry includes timestamps, block numbers, and vote counts.