Skip to main content

Errors

Overview​

Calypso API returns errors in JSON format. Use errorCode for programmatic handling and message for diagnostics.

Error response format​

{
"errorCode": "000",
"message": "Internal server error"
}

Error codes​

errorCodeMessageComment
000Internal server errorError on the Calypso side. Contact support if the error persists.
001Bad requestIncorrect input data.
002Invalid API keyInvalid public API key in the request.
003Wrong signRequest signature was built incorrectly.
004Requested object is not foundRequested object does not exist or is not available to the current account.
006Invoice is in incorrect state for operationThe requested operation cannot be performed for the current invoice state.
011Invalid timestamp parametertimestamp is missing, invalid, too old, or too far in the future.
012Invalid payout stateThe requested operation cannot be performed for the current payout state.
014Invalid hot wallet currencyCurrency is invalid for the selected hot wallet.
015Currency does not match wallet blockchainCurrency and wallet blockchain do not match.
016idempotencyKey already existsThe idempotency key was already used.
016Cannot create deal. Validation failedValidation error during payout creation. One or more request parameters were not validated.
018Event types or service types must not be emptyWebhook subscription must include at least one event type or service type.
019Duplicate was found by requestIdrequestId was already used.
020Not found subscription by requestIdWebhook subscription was not found by requestId.
021requestId must not be nullrequestId is required.
022Subscription does not belong to current userWebhook subscription does not belong to the current user.
024Quantity limit exceeded by mass dealMass payout contains more items than allowed.
026Cannot create invoiceBusiness error in invoice input data.
027Cannot find invoiceInvoice was not found.
029Cannot archive invoiceInvoice cannot be archived in its current state.
031Filling in the field is superfluousField value exceeds the allowed limit or should not be sent.
032Filling in the field is requiredRequired field is missing.
035Wrong expirationExpiration value is invalid.
036Can't create dealBusiness error in payout input data.
037Client with this name already existsClient name must be unique.
038Payout does not existPayout was not found.
041Cannot cancel payout in the current statePayout cannot be canceled in its current state.
042DealWithdrawal does not existTransaction in mass payout does not exist.
043Client was not foundClient was not found.
044Unsupported currencyCurrency is not supported for this operation.
054Invoice with this idempotencyKey already existsInvoice idempotency key was already used.
056Recurrent was not foundRecurrent payment was not found.
057Recurrent payment does not belong to current userRecurrent payment does not belong to the current user.
058Recurrent already deletedRecurrent payment was already deleted.
059Cannot create recurrent payment. Validation failedValidation error during recurrent payment creation.
060Cannot create recurrent payment. Currency is unavailableCurrency is unavailable for recurrent payment creation.
061Deposit address does not belong to your companyDeposit address belongs to another company or is unavailable.
062Wrong deposit address blockchainAddress format does not match the selected blockchain.
063Currency not found for the current accountThe current account does not have a wallet for the requested currency.
400Bad requestSome or all request data does not match the expected format.
500Internal server errorError on the Calypso side. Contact support if the error persists.
CaseRecommendation
Authentication errorCheck Key, Sign, request body string, and timestamp.
Validation errorCheck required fields, field formats, enum values, limits, and account availability.
Duplicate idempotency keyDo not repeat the same business action; request the existing object status if needed.
Internal server errorRetry later or contact Calypso support if the issue persists.
DocumentLink
API AuthenticationAPI Authentication
ENUM descriptionsENUM descriptions