---
title: "SERVICE_UNAVAILABLE"
description: "What triggers SERVICE_UNAVAILABLE (HTTP 503) when the service is temporarily unable to handle requests."
canonical_url: "https://docs.leyr.io/api/error-handling/service_unavailable"
---
# SERVICE_UNAVAILABLE

> What triggers SERVICE_UNAVAILABLE (HTTP 503) when the service is temporarily unable to handle requests.

## Summary

This error corresponds to the standard `503 Service Unavailable` HTTP status code, indicating that the server is temporarily unable to handle the request.

## Example Response

```json
{
    "code": "SERVICE_UNAVAILABLE",
    "type": "https://docs.leyr.io/api/error-handling/service_unavailable",
    "title": "Service unavailable",
    "status": 503,
    "detail": "Service temporarily unavailable. This may be due to maintenance or high system load. Please retry your request after a brief delay.",
    "instance": "36b5909e-4391-4520-b303-84cbb80c4264"
}
```

## Common Causes

- Scheduled system maintenance is in progress
- The server is experiencing unusually high load
- A critical service dependency or Network connectivity between services is temporarily unavailable

## Resolution Steps

To handle this error effectively:

1. Retry your request after a brief delay, as the issue might be temporary. Implementing progressive retries (e.g. 1s, 5s, 15s, 30s, 1m) could be a good option in a long term, but we also don't expect this error to happen often.
2. If the issue persists beyond several retry attempts, contact our support team at [contact@leyr.io](mailto:contact@leyr.io) with the following information:
  - The `instance` ID from the error response
  - A description of what you were trying to achieve


## Sitemap

See the full [sitemap](https://docs.leyr.io/sitemap.md) for all pages.