Check Vote Status

Check whether a user has voted for your bot in the last 24 hours.

Use this endpoint to verify a user’s vote status before granting in-bot perks or rewards. A user who voted fewer than 24 hours ago is considered an active voter.

Endpoint

GET /bots/{id}/voters/{user_id}

Authentication: Required — pass your API key in the Authorization header.
See Authentication for details.

Path Parameters

id · string · required

The Discord snowflake ID of your bot (a 17–20 digit numeric string).

Example: 123456789012345678

user_id · string · required

The Discord snowflake ID of the user whose vote status you want to check.

Example: 987654321098765432

Code Examples

curl

curl https://api.discord.place/bots/123456789012345678/voters/987654321098765432 \
  -H "Authorization: YOUR_API_KEY"

const botId = '123456789012345678';
const userId = '987654321098765432';

const response = await fetch(
  `https://api.discord.place/bots/${botId}/voters/${userId}`,
  { headers: { 'Authorization': process.env.DISCORD_PLACE_API_KEY } }
);

const { voted, vote, lastVote } = await response.json();

if (voted) {
  console.log(`User voted ${vote} times, last at ${new Date(lastVote).toISOString()}`);
} else {
  console.log('User has not voted in the last 24 hours.');
}

Responses

200 — Success

voted · boolean · required

true if the user cast a vote within the last 24 hours, false otherwise.

vote · integer · required

The user’s total cumulative vote count for this bot across all time. Returns 0 if the user has never voted.

lastVote · integer · required

Unix timestamp in milliseconds of the user’s most recent vote. Returns null if the user has never voted.

Example: 1694345400000

{
  "voted": true,
  "vote": 12,
  "lastVote": 1694345400000
}

Error Responses

Show 401 Unauthorized

Missing key

{
  "success": false,
  "error": "Authorization header is required.",
  "status": 401
}

Invalid key

{
  "success": false,
  "error": "Invalid API key.",
  "status": 401
}

Show 404 Not Found

{
  "success": false,
  "error": "Bot not found.",
  "status": 404
}

Show 429 Too Many Requests

This endpoint allows 100 requests per 5 minutes. See Rate Limits.

{
  "success": false,
  "error": "Too many requests, please try again later.",
  "status": 429
}

Tips

For real-time vote notifications without polling, set up a Vote Webhook. The webhook fires immediately when a vote is cast, whereas this endpoint requires you to query on demand.