Rate Limit Exceeded
The caller has exceeded the API rate limit for this window.
At a glance
| Field | Value |
|---|---|
| HTTP status | 429 |
| Error code | RATE_LIMIT_EXCEEDED |
| Type URL | https://developer.fieldnation.com/error-codes/rate-limit-exceeded |
| Content-Type | application/problem+json |
| Retryable | true |
| Agent action | RETRY |
| Agent backoff | 60000 ms |
| Agent max attempts | 3 |
What it means
The caller has exceeded the API rate limit for this window.
When it is returned
- Sustained request volume exceeded the per-minute or per-hour quota.
- A burst saturated the short-term token bucket.
- Multiple integrations share the same API user and credentials.
Troubleshooting
- Honor the
Retry-Afterresponse header before resubmitting. - Implement exponential backoff plus jitter in retry logic.
- Track
X-RateLimit-Remainingand throttle proactively. - For high-volume integrations, request a higher quota from Field Nation.
Example response
HTTP/1.1 429 Rate Limit Exceeded
Content-Type: application/problem+json{
"type": "https://developer.fieldnation.com/error-codes/rate-limit-exceeded",
"title": "Rate Limit Exceeded",
"status": 429,
"detail": "Rate limit exceeded. Retry after 60 seconds.",
"code": "RATE_LIMIT_EXCEEDED",
"retryable": true,
"correlationId": "01J9X7Q3F6E2K8B1Z5C4M0V2HA",
"agent": {
"action": "RETRY",
"backoffMs": 60000,
"maxAttempts": 3
},
"errors": []
}Related
Last updated on