> For the complete documentation index, see [llms.txt](https://docs.discordbotlist.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discordbotlist.com/vote-api.md).

# Vote API

If you are unable to implement the recommended method of voting, [Webhooks](/vote-webhooks.md), 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 %}