API errors

Service unavailable

The resource is temporarily unable to handle the request. Wait a moment, then retry.

503application/problem+json

What it means

The request was fine, but the resource cannot serve it right now: it is mid-operation on Firsty's side, such as an eSIM being reconfigured. Nothing was processed, and the condition clears on its own.

503 · application/problem+json

{
  "type": "https://developers.firsty.app/errors/service-unavailable",
  "title": "Service unavailable",
  "status": 503,
  "detail": "This eSIM is being reconfigured. Retry in a few moments."
}

How to handle it

Retry after a short wait, and back off with jitter if it persists. Most 503s clear within moments.
Nothing was processed, so the same request is safe to resend unchanged.
If the condition lasts more than a few minutes, contact Firsty support with the X-Request-Id response header value from the failing call.

Errors reference eSIM lifecycle

What it means

How to handle it

Related