API Error Guide

Moved to API Reference: https://layer1.readme.io/reference/errors

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:

JSON

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

Error Codes

Validation or Unknown Exception

Code	Status	Description
layer1:digital-asset:1000	BAD_REQUEST	Error given for validation or unknown exceptions.

Validation Errors

Code	Status	Description
layer1:digital-asset:4000	BAD_REQUEST	Error given for invalid inputs.
layer1:digital-asset:4001	CONFLICT	Error given when a transfer request exists with different data.
layer1:digital-asset:4002	BAD_REQUEST	Error given for invalid outputs.
layer1:digital-asset:4003	BAD_REQUEST	Error given for an invalid request.
layer1:digital-asset:4004	CONFLICT	Error given when a master key already exists.
layer1:digital-asset:4005	CONFLICT	Error given when there is data inconsistency.
layer1:digital-asset:4006	PRECONDITION_FAILED	Error given when an asset pool is not empty.

Export Job Errors

Code	Status	Description
layer1:digital-asset:4100	CONFLICT	Error given when an export job execution is already running.
layer1:digital-asset:4101	CONFLICT	Error given when an export job restart fails.
layer1:digital-asset:4102	BAD_REQUEST	Error given when an export job instance is already complete.