API Reference
Documentation for the Points API, including endpoints, parameters, and examples.
Introduction
The Points API lets you read and modify member balances in your Discord server programmatically. This is useful for integrations with other bots, websites, or automation workflows.
API access requires a Points Premium subscription. You can upgrade your server at points.bot/premium.
Authentication
All requests require an API key passed in the authorization header:
authorization: YOUR_API_KEYYou can find your API key in the Points dashboard under Settings.
Base URL
https://api.points.botRate Limits
Requests are rate limited per guild. If you exceed the limit, you'll receive a 429 Too Many Requests response. We recommend adding retry logic with exponential backoff.
Endpoints
All current endpoints operate on guild member balances:
| Method | Path | Description |
|---|---|---|
GET | /v1/guilds/{id}/balances | Get all member balances |
GET | /v1/guilds/{id}/balances/{memberId} | Get a single member's balance |
POST | /v1/guilds/{id}/balances/{memberId}/add | Add to a member's balance |
POST | /v1/guilds/{id}/balances/{memberId}/subtract | Subtract from a member's balance |
POST | /v1/guilds/{id}/balances/{memberId}/set | Set a member's balance |
POST | /v1/guilds/{id}/balances/bulkadd | Bulk add to multiple members |
POST | /v1/guilds/{id}/balances/bulksubtract | Bulk subtract from multiple members |
POST | /v1/guilds/{id}/balances/bulkset | Bulk set multiple members' balances |