# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onyx.org/api/get-voter-proposalid.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.