Skip to main content
503 Service UnavailableReeds

SERVICE_UNAVAILABLE

Reeds is busy, or a service it depends on is unavailable

When it happens

Reeds is overloaded and shed the request (any endpoint; the response carries Retry-After), or maps or payments are temporarily unavailable. Nothing was done.

How to fix it

  1. Wait for the Retry-After seconds when present, then retry with the same Idempotency-Key.
  2. Without Retry-After, retry later with exponential backoff.
RetryingRetry with the same Idempotency-Key.How idempotency works

Example response

HTTP 503 Service Unavailable
{
"status": "failed",
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Address lookup is temporarily unavailable. Retry shortly.",
"doc_url": "https://developer.getreeds.co/errors/SERVICE_UNAVAILABLE"
}
}