Errors

The Solaris Digital Assets API returns the following errors:

Error code Message Description
400 Invalid Request The request contained invalid parameters. This error response includes a params object, which contains the invalid request attributes and their corresponding attribute error codes:
  • blank: This attribute requires a value, but no value was provided in the request.
  • invalid: The value provided for this attribute in the request is invalid. Possible triggers include an invalid data type, invalid formatting, or an incorrect blockchain address.
  • not_found: A resource referenced by this attribute was not found. This may happen when making a request with an attribute that references another resource, e.g., when creating an Account and using asset_id to reference an Asset.
  • taken: The value provided for this attribute is expected to be unique, but it is already taken by another resource, e.g., when providing a reference key that was already used in a previous request.
403 Unauthorized Authentication error, caused by an invalid authentication scheme (e.g., missing nonce) or an invalid signature.
404 Not Found The requested resource could not be found.
422 Invalid Resource The request could not be processed because the referenced resource's state prevents it. For example, it is not possible to approve a FAILED ApprovalRequest.
429 Too Many Requests You have exceeded the maximum number of requests allowed in a given time frame. In some cases, the underlying service or an external provider rate limits an endpoint. For example, when creating or approving an ApprovalRequest of type SMS, you may reach a rate-limiting threshold set by an external provider. Solaris recommends implementing a backoff strategy as a reaction to this error response.
Note: This is a transient error. You may attempt the same request with the same attributes again.
500 Internal Server Error An unspecified failure of an underlying or external service.
Note: This is a transient error. You may attempt the same request with the same attributes again.
503 Service Unavailable The request could not be processed because the underlying service (either on Solaris' side or with an external provider) is temporarily unavailable.
Note: This is a transient error. You may attempt the same request with the same attributes again.