> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/discordplace/discord.place/llms.txt
> Use this file to discover all available pages before exploring further.

# API Overview

> The discord.place REST API lets bot developers post stats and receive vote events.

The discord.place API allows bot developers to keep their bot listings up to date, check voter status, and receive real-time vote notifications via webhooks.

## Base URL

```
https://api.discord.place
```

**API Version:** `1.1.0`\
**Content-Type:** All requests and responses use `application/json`.

## Response Format

Every response includes a `success` boolean at the top level. Error responses additionally include an `error` string describing the problem and a `status` integer matching the HTTP status code.

```json theme={null}
// Success
{ "success": true }

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

## Available Endpoints

<CardGroup cols={2}>
  <Card title="Update Bot Stats" icon="chart-bar" href="/api-reference/bots/update-stats">
    `PATCH /bots/{id}/stats`\
    Update your bot's server count and command count.
  </Card>

  <Card title="Check Vote Status" icon="check-circle" href="/api-reference/bots/check-vote">
    `GET /bots/{id}/voters/{user_id}`\
    Check whether a user has voted for your bot in the last 24 hours.
  </Card>
</CardGroup>

## Webhooks

When a user votes for your bot or server, discord.place sends an HTTP `POST` request to your configured webhook URL. This lets you reward voters in real time without polling.

See the [Vote Webhooks](/api-reference/bots/webhooks) page for the full payload reference and a ready-to-use handler example.

## Quick Example

Update your bot's server count with a single `curl` command:

```bash theme={null}
curl -X PATCH https://api.discord.place/bots/123456789012345678/stats \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server_count": 1500}'
```

A successful response:

```json theme={null}
{ "success": true }
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Learn how to generate and use your API key.
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/api-reference/rate-limits">
    Understand the rate limits that apply to all endpoints.
  </Card>
</CardGroup>