Core Concepts
Rate Limiting
The One Tribe Carbon Offset Projects API enforces rate limiting to ensure service availability.
Rate Limits
| Time Window | Request Limit | Description |
|---|---|---|
| Per Minute | 180 | Maximum requests per minute |
| Per Hour | 10,800 | Maximum requests per hour |
| Per Day | 120,000 | Maximum requests per 24 hours |
Response Headers
| Header Name | Description |
|---|---|
X-RateLimit-Limit | Total requests allowed in current window |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Time when the rate limit window resets (Unix timestamp) |
Error Response
| Status Code | Error Code | Description |
|---|---|---|
| 429 | TooManyRequests | Rate limit exceeded - please wait before making more requests |
Example 429 Response
{
"error": {
"code": "TooManyRequests",
"message": "Rate limit exceeded",
"details": {
"limit": 180,
"remaining": 0,
"reset": 1683936000
}
}
}
Note: If you need higher rate limits for your use case, please contact One Tribe for more information.