Error Handling

Requests made to our APIs can result in several different error responses. The following document describes a list of error values with a map to the most common recovery tactic to use.

Error Responses

Each Notardec response contains an error field. It will be empty if the request was successful.

In case of an error, the error field has the following form

{
    "error": {
      "code": "400",
      "message": "BLOCKCHAIN ERROR"
    }
}

About status codes

Notardec API is using HTTP status codes as a highest level of response codes. Following status codes can be returned by Notardec API:

  • HTTP 4xx - error on the client side
    • HTTP 400 - request body error(incorrect parameters, failed preconditions)
    • HTTP 401/403 - error with authentication/authorization
    • HTTP 404 - error in resource URI
  • HTTP 500 - internal server error

About messages

In case of an error, you can see brief information about the error in the “message” field of the error.

This is a list of all errors

  • SERVER_ERROR
  • BLOCKCHAIN_ERROR
  • MISSING_TOKEN
  • ASSET_CREATION_FAILED
  • ASSET_NOT_FOUND
  • MISSING_TRANSACTION
  • PENDING_TRANSACTION
  • EMAIL_SENDING_FAILED
  • TRANSACTION_ERROR
  • VALIDATION_ERROR
  • DISCOVERY_NOT_FOUND
  • LINK_FAILED
  • BALANCE_FAILED
  • WALLET_NOT_FOUND
  • KEY_NOT_FOUND
  • WALLET_ERROR
← Authentication
Error Handling →