API Endpoints
Complete reference for all VotePipe API endpoints
Base URL
All API requests should be made to:
https://api.votepipe.com/v1Response Format
All API responses follow a consistent format:
Success Response
json
{
"data": {
// Response data
},
"meta": {
"request_id": "req_abc123"
}
}Error Response
json
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid input",
"details": [
{ "field": "slug", "message": "Slug already taken" }
]
},
"meta": {
"request_id": "req_abc123"
}
}Endpoint Groups
Organization
Manage organization settings and details
GETPATCH
Providers
Manage server list providers
GETPOSTPATCHDELETE
Votes
Retrieve vote history and export data
GET
Growth+
Statistics
Get analytics and statistics
GET
Pro+
API Keys
Manage API keys for programmatic access
GETPOSTDELETE
Growth+
Templates
List available provider templates
GET
Public
Callbacks
Manage server callback configurations
GETPOSTPATCHDELETE
Growth+
Error Codes
| Code | HTTP | Description |
|---|---|---|
| VALIDATION_ERROR | 400 | Invalid request data |
| AUTH_REQUIRED | 401 | No auth provided |
| AUTH_FAILED | 401 | Invalid credentials |
| API_KEY_REQUIRED | 401 | API key required in Authorization header |
| INVALID_API_KEY | 401 | Invalid or revoked API key |
| FORBIDDEN | 403 | Insufficient permissions |
| ORG_SUSPENDED | 403 | Organization is suspended |
| PLAN_UPGRADE_REQUIRED | 403 | Feature requires a higher plan tier |
| SUBSCRIPTION_INACTIVE | 403 | Subscription is not active |
| INSUFFICIENT_SCOPE | 403 | API key scope insufficient for this operation |
| NOT_FOUND | 404 | Resource not found |
| RATE_LIMITED | 429 | Too many requests |
| PLAN_LIMIT | 403 | Plan limit exceeded |
| INTERNAL_ERROR | 500 | Server error |