# Bot Statistics

If you are a bot owner, you might want to POST bot statistics to our API.

* You can post `guilds`, `users`, and `voice_connections`
* The guild count is displayed on your widget and on the site.
* User count and voice connections are exposed in the API for those who want to make cool graphs.

## Post Stats

<mark style="color:green;">`POST`</mark> `https://discordbotlist.com/api/v1/bots/:id/stats`

This method is used to send bot statistics to Discord Bots.

#### Path Parameters

| Name | Type   | Description                 |
| ---- | ------ | --------------------------- |
| id   | string | The ID of your Discord bot. |

#### Headers

| Name          | Type   | Description          |
| ------------- | ------ | -------------------- |
| Authorization | string | Authentication token |

#### Request Body

| Name               | Type    | Description                                                                                                                  |
| ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| voice\_connections | integer | The amount of voice connections.                                                                                             |
| users              | integer | The amount of users.                                                                                                         |
| guilds             | integer | The amount of guilds.                                                                                                        |
| shard\_id          | integer | The shard ID if you wish to send per-shard statistics. The statistics will be grouped together and displayed on the website. |

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

```
{ "success": true }
```

{% endtab %}
{% endtabs %}