Error Codes

Successful requests will return a HTTP 200 response and may or may not include a response body, depending on the request endpoint.

Whenever a problem occurs, Alfred will respond to the client using a 4xx or 5xx status code. All
4xx status codes indicate a problem with your request, while a 5xx status code indicates an internal problem with our systems.

All exceptions come equipped with an error code ID. If you require support, please supply this identifier to assist our support team in locating your issue.

The following table describes the fields included in the returned JSON exception:

FieldDescription
errorCodeA unique identifier for this exception. This is very helpful when contacting support
errorMessageA human-friendly description of the problem
errorMetadataDescribes the associated fields related to the error

An example JSON representation:

{
	"errorCode": 110002,
	"errorMessage": "Invalid field(s)"
	"errorMetadata: {
		"fields": ["fromCurrency", "toCurrency"]
	}
}

Error Codes

Error CodeError Message
110002Invalid field(s)
110003Bank Unresponsive
111301UNKNOWN_ERROR
111302Invalid parameter(s)
111303Required parameter(s) missing
111304Customer IP not allowed
111305Unauthorized
111306Unsupported trading pair
111307Unsupported fiat method
111308Unsupported chain
111309Given fiat account does not belong to the customer
111310Customer has exceeded their deposit limit
111311Deposit exceeds single deposit limit
111401EDD verification form must be completed to continue
111402KYC submission not found
111403KYB submission not found
111404KYC record cannot be retried
111405KYB record cannot be retried
111406Customer KYC incomplete
111407Customer KYB incomplete
111408Phone number already registered
111409Email already registered
111410Phone country code and customer country does not match
111411KYC has already been completed for this customer
111412KYB has already been completed for this customer
111413Invalid ID type
111414Invalid file submission
111415Customer not found
111416Business customer not found
111417Invalid customer
111426Outside the trade limit for fromCurrency and toCurrency
111427Invalid amount
111428Quote not found
111429Quote already used or expired
111430Invalid quote for onramp
111431Invalid quote
111432Quote does not correspond to a fiat currency
111433From Currency is not the same as from currency of quote
111434To Currency is not the same as to currency of quote
111435Amount is not the same as from amount of quote
111436Chain is not the same as chain of quote
111437Payment method type is not the same as payment method type of quote
111438Please, only send one field, can be fromAmount or toAmount
111451Fiat method and currency is unsupported
111476Onramp deposit not found
111477Onramp trade not found
111478Onramp transaction not found
111479Duplicate onramp deposit found
111480Duplicate onramp trade found
111481Duplicate onramp transaction found
111482Fiat account not found
111483Offramp not found
111484Account number not valid
111485Fiat account for already exists
111526Invalid support ticket type
111527Duplicate support request found
111551Unexpected kyc status
111552Unexpected kyb status
111553Unexpected onramp transaction status
111554Unexpected offramp transaction status
111555Reference id not found
111556Invalid event type
111557Expected metadata not found
111558Customer is already registered with that email and country
111559The specified customer or fiat account could not be found. Please verify the provided details and try again
111560Invalid payment method
111561fromCurrency Would be diferent toCurrency
111562Invalid calculated fromAmount
111563No deposit address found
111564Payment not found:
111565The encrypted data has expired.
111566Error decrypting data: invalid data