service_unavailable

HTTP status: 503

A downstream system the API depends on is temporarily degraded or unreachable. The request was not processed. This is a transient error — retry with the same idempotency key.

Why this happens

• A carrier data service is experiencing an outage.
• A database or cache tier is temporarily unavailable.
• The server is starting up after a deployment (cold-start window).

What to do

1. Retry with the same idempotency key on exponential backoff. The SDK does this automatically.
2. Check support-and-status — incidents are communicated by email to active integrators until the public status page launches at GA.
3. If the error persists beyond 5 minutes without a status page incident, contact [email protected] with your request_id.

Example response

{
  "type": "https://zyins.isaapi.com/errors/service-unavailable",
  "title": "Service unavailable",
  "status": 503,
  "detail": "A downstream dependency is temporarily degraded. Retry with the same Idempotency-Key. See docs/support-and-status for incident communications.",
  "code": "service_unavailable",
  "advice_code": "retry_with_backoff",
  "param": null,
  "request_id": "req_01HZK2N5GQR9T8X4B6FJW3Y1AS"
}

SDK exceptions

See also

• Error catalog
• Support and status