API Reference
Rate Limits
API request limits and throttling behaviour.
The CodeWall API enforces rate limits to ensure fair usage and platform stability.
Default limits
| Scope | Limit |
|---|---|
| Per API key | 100 requests per minute |
| Per organization | 500 requests per minute |
| Burst | Up to 20 requests per second |
Rate limit headers
Every response includes rate limit headers:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1705312800| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests per window |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
When rate limited
If you exceed the limit, the API returns:
HTTP/1.1 429 Too Many Requests
Retry-After: 30Wait for the number of seconds in the Retry-After header before retrying.
Best practices
- Cache responses where possible — target and finding data doesn't change frequently
- Use webhooks instead of polling for real-time updates
- Implement exponential backoff when you receive 429 responses
- Batch operations where the API supports it