Error Catalog
Complete error reference for eCourtDate.
HTTP Status Codes
| Code | Name | Description | Action |
|---|---|---|---|
| 400 | Bad Request | Invalid request body or missing required parameters | Validate request body; check required fields |
| 401 | Unauthorized | Invalid or expired Bearer token | Re-authenticate; verify API client is not revoked |
| 403 | Forbidden | Agency inactive or insufficient permissions | Confirm agency is active; use API client token (not user token) |
| 404 | Not Found | Resource or endpoint not found | Check endpoint path; if "Agency Not Found", configure Default Agency |
| 405 | Method Not Allowed | Wrong HTTP method | Use correct method (GET/POST/PATCH/DELETE) |
| 409 | Conflict | Duplicate message detected (30-min window) | Use skip_duplicate=true, adjust scheduled_at, or use duplicate_buffer |
| 429 | Too Many Requests | Rate limit exceeded (1000 req/min default) | Wait 1 minute; implement exponential backoff |
| 500 | Internal Server Error | Server-side error | Contact support with request details |
| 503 | Service Unavailable | API temporarily unavailable | Retry after 1 minute |
| 504 | Gateway Timeout | Network timeout | Retry after 1 minute |
Carrier Error Codes
Carrier-specific errors occur when a message cannot be delivered by the telecommunications carrier. These are returned in message delivery status updates.
Error codes and reasons are maintained as JSON files:
- Error codes: https://assets.ecourtdate.com/app/js/error_codes.json
- Error reasons: https://assets.ecourtdate.com/app/js/error_reasons.json
Common Carrier Error Categories
- Unreachable/Undeliverable: Recipient number invalid, disconnected, or out of service
- Blocked/Filtered: Message blocked by carrier spam filter or recipient block list
- Capacity: Carrier network congestion or volume limits
- Timeout: Delivery attempt timed out
- Format: Message format not supported by carrier
Message Retry Behavior
- Automatic retry for: temporary network issues, temporary spam blocks, volume limits, carrier/gateway issues
- Messages stop retrying 24 hours after original send time
- Event-linked messages stop if the event date passes