# Votes

## Get votes data

<mark style="color:green;">`POST`</mark> `https://dao.octusbridge.io/v1/votes/search`

{% tabs %}
{% tab title="200: OK Successful request" %}

```
{
  "votes": [
    {
      "proposalId": 6,
      "voter": "0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd",
      "support": true,
      "reason": "",
      "votes": "5061664014",
      "locked": false,
      "messageHash": "0275dde58e1a456e6dbba65aba2f295e2d33812353f0632c9728c084843a3678",
      "transactionHash": "3024c7309609b69cf8ad0f6efc686fb3bf91ccc257261e9063c5cee35ac6f7cf",
      "createdAt": 1654530320
    }
  ],
  "totalCount": 1
}
```

{% endtab %}
{% endtabs %}

This function returns voting details of a specific user based on a specific proposal.

It can be used for showing detailed information about a user's vote such as number of votes raised for a specified proposal, reason for voting, did the user support the proposal or not, time of voting etc.

### Request parameters

Required body parameters:

| Name       | Example value                                                      | Comment                                                                  |
| ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| limit      | 5                                                                  | Maximum number of proposals to be retrieved                              |
| locked     | false                                                              | True if locked, false otherwise                                          |
| offset     | 0                                                                  | Offset                                                                   |
| ordering   |                                                                    | Set of parameters based on which the retrieved proposals will be ordered |
| column     | createdAt                                                          | Order by given column name (i.e. createdAt)                              |
| direction  | ASC                                                                | Order by given direction (ascending or descending)                       |
| proposalId | 6                                                                  | Id of the proposal                                                       |
| support    | true                                                               | True if voted for, false if voted against the proposal                   |
| voter      | 0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd | Voter’s address                                                          |

### Response fields explanation

| Name            | Example value                                                      | Comment                                                              |
| --------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------- |
| totalCount      |                                                                    | Total number of times voter voted for a specific proposal            |
| votes           | 5061664014                                                         | List of all the votes from a specific voter to the specific proposal |
| createdAt       | 1654530320                                                         | Date when the vote was raised                                        |
| locked          | false                                                              | True if vote is locked, false otherwise                              |
| messageHash     | 0275dde58e1a456e6dbba65aba2f295e2d33812353f0632c9728c084843a3678   | Hash code of the message                                             |
| proposalId      | 6                                                                  | Id of the proposal                                                   |
| reason          | ""string""                                                         | Reason for voting                                                    |
| support         | true                                                               | True if voter voted for, false if voted against                      |
| transactionHash | 3024c7309609b69cf8ad0f6efc686fb3bf91ccc257261e9063c5cee35ac6f7cf   | Hash code of the transaction                                         |
| voter           | 0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd | Voter’s address                                                      |
| votes           | 5061664014                                                         | Amount staked for voting                                             |

### Example

```java
app.post('/votes/search', (req, res) => {
 
    axios({
        method: 'post',
        url: `${apiUrl}/votes/search`,
        data: {
            limit: req.body.limit,
            locked: req.body.locked,
            offset: req.body.offset,
            ordering: req.body.ordering,
            proposalId: req.body.proposalId,
            support: req.body.support,
            voter: req.body.voter
        }
    })
    .then(function(response){
        res.send(response.data)
    })
    .catch(function(error){
        console.error(error)
        res.send('Error')
    })
  })
```


---

# 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.octusbridge.io/integrate/octus-bridge-api/dao-api/votes.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.