# Vote API

If you are unable to implement the recommended method of voting, [Webhooks](https://docs.discordbotlist.com/vote-webhooks), an endpoint is provided which returns the most recent 500 votes, alongside a timestamp.

## GET Votes

<mark style="color:blue;">`GET`</mark> `https://discordbotlist.com/api/v1/bots/:id/upvotes`

Returns the most recent 500 votes alongside the total number of votes in the past 12 hours.

#### Path Parameters

| Name                                  | Type   | Description |
| ------------------------------------- | ------ | ----------- |
| :id<mark style="color:red;">\*</mark> | String | Bot ID      |

#### Headers

| Name          | Type   | Description              |
| ------------- | ------ | ------------------------ |
| Authorization | String | discordbotlist.com token |

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

```javascript
{
  "upvotes": [
    {
      "user_id": "149505704569339904",
      "timestamp": "2023-01-09T02:26:33.375Z", // Use this to find new votes
      "username": "luke",
      "discriminator": "0123",
      "avatar": "11a25559098e81115f7b395c511e6633"
    }
  ],
  "total": 1 // Total upvotes over 12 hours. The "upvotes" array only returns the recent 500.
}
```

{% endtab %}
{% endtabs %}