Check Vote Status

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

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 https://api.discord.place/bots/123456789012345678/voters/987654321098765432 \
  -H "Authorization: YOUR_API_KEY"

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
Invalid key

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

{
  "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.

Introduction

Bots

Endpoint

Path Parameters

Code Examples

Responses

200 — Success

Error Responses

Tips

Build docs developers (and LLMs) love

Introduction

Bots

Documentation Index

​Endpoint

​Path Parameters

​Code Examples

​Responses

​200 — Success

​Error Responses

​Tips

Build docs developers (and LLMs) love

Endpoint

Path Parameters

Code Examples

Responses

200 — Success

Error Responses

Tips