Error Guide for Layer1 API

Error Format

The following is a list of error codes, their messages, and descriptions for errors that may be encountered when using the Layer1 API. These errors are returned in the following format:

{
    "code": "layer1:digital-asset:XXXX",
    "status": "<the status of the request>",
    "message": "<error message>"
}

Error Codes

Validation or Unknown Exception

CodeStatusDescription
layer1:digital-asset:1000BAD_REQUESTError given for validation or unknown exceptions.

Validation Errors

CodeStatusDescription
layer1:digital-asset:4000BAD_REQUESTError given for invalid inputs.
layer1:digital-asset:4001CONFLICTError given when a transfer request exists with different data.
layer1:digital-asset:4002BAD_REQUESTError given for invalid outputs.
layer1:digital-asset:4003BAD_REQUESTError given for an invalid request.
layer1:digital-asset:4004CONFLICTError given when a master key already exists.
layer1:digital-asset:4005CONFLICTError given when there is data inconsistency.
layer1:digital-asset:4006PRECONDITION_FAILEDError given when an asset pool is not empty.

Export Job Errors

CodeStatusDescription
layer1:digital-asset:4100CONFLICTError given when an export job execution is already running.
layer1:digital-asset:4101CONFLICTError given when an export job restart fails.
layer1:digital-asset:4102BAD_REQUESTError given when an export job instance is already complete.