API errors

Forbidden

The credentials are valid but this operation is not allowed for your account. The detail field says why.

403application/problem+json

What it means

Authentication succeeded, so this is not a token problem. Either two resources in the URL do not belong together (a package that is not on that eSIM, a number that is not on that service), or the operation is outside what is enabled for your account: a limit has been reached, or a feature is not switched on for your credentials.

A reference that is not yours at all does not produce this error; it comes back as not found.

403 · application/problem+json

{
  "type": "https://developers.firsty.app/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Package does not belong to this eSIM"
}

How to handle it

Read detail. It names the mismatched pair or the account restriction directly.
For a mismatched pair, check that the child reference in the URL really belongs to the parent; fetch the parent's own listing to confirm.
Do not retry unchanged. The answer is the same until the request or your account's configuration changes.
For a limit or a feature that is not enabled, contact Firsty support; that is an account change, not a request change.

Authentication guide Errors reference

What it means

How to handle it

Related