Service Unavailable
The Field Nation API is temporarily unavailable.
At a glance
| Field | Value |
|---|---|
| HTTP status | 503 |
| Error code | SERVICE_UNAVAILABLE |
| Type URL | https://developer.fieldnation.com/error-codes/service-unavailable |
| Content-Type | application/problem+json |
| Retryable | true |
| Agent action | RETRY |
| Agent backoff | 5000 ms |
| Agent max attempts | 3 |
What it means
The Field Nation API is temporarily unavailable.
When it is returned
- A downstream service (database, search index, queue) is temporarily unreachable.
- The API is undergoing maintenance or deployment.
- The system is experiencing degraded capacity.
Troubleshooting
- Honor the
Retry-Afterresponse header before resubmitting. - Implement exponential backoff plus jitter in retry logic.
- Check status.fieldnation.com for ongoing incidents.
- If the problem persists beyond the expected maintenance window, contact support.
Example response
HTTP/1.1 503 Service Unavailable
Content-Type: application/problem+json{
"type": "https://developer.fieldnation.com/error-codes/service-unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The service is temporarily unavailable. Please try again later.",
"code": "SERVICE_UNAVAILABLE",
"retryable": true,
"correlationId": "01J9X7Q3F6E2K8B1Z5C4M0V2HA",
"agent": {
"action": "RETRY",
"backoffMs": 5000,
"maxAttempts": 3
},
"errors": []
}Related
Last updated on