Introduction to EliteCircle API
The EliteCircle REST API provides programmatic access to membership management, subscription billing, usage tracking, and community features. This guide covers everything you need to integrate seamlessly.
All API requests should be made to: https://api.elitecircle.com/v2
Authentication
EliteCircle uses API keys for authentication. Include your key in the Authorization header using Bearer token format.
JavaScript (Fetch)const response = await fetch('https://api.elitecircle.com/v2/members', { headers: { 'Authorization': 'Bearer your_live_api_key', 'Content-Type': 'application/json' } }); const data = await response.json();
Never expose live API keys in client-side code. Use environment variables and server-side proxies for sensitive operations.
Rate Limits
API requests are rate-limited to ensure fair usage and platform stability. Limits vary by subscription tier.
| Plan | Requests / Minute | Requests / Day | Burst Limit |
|---|---|---|---|
| Starter | 60 | 10,000 | 15 |
| Professional | 300 | 100,000 | 50 |
| Enterprise | Custom | Unlimited | Custom |
Rate limit information is returned in response headers:
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 245
X-RateLimit-Reset: 1708934400
Error Handling
EliteCircle uses standard HTTP status codes. Errors are returned as JSON with a consistent structure.
| Status | Meaning |
|---|---|
200 | Success |
400 | Bad Request (invalid parameters) |
401 | Unauthorized (missing/invalid API key) |
403 | Forbidden (insufficient permissions) |
404 | Not Found |
429 | Rate Limited |
500 | Internal Server Error |
{
"error": {
"code": "invalid_api_key",
"message": "The provided API key is invalid or has been revoked.",
"documentation_url": "https://docs.elitecircle.com/errors"
}
}
Next Steps
Now that you understand the basics, explore the following: