Skip to main content
Zodia’s API offers a number of error codes to facilitate your usage and troubleshooting. Zodia uses HTTP response codes to indicate the success or failure of an API request. In general:
  • 200 indicate success
  • 4xx range indicate a failure given the information provided(e.g. a required parameter was omitted, etc…)
  • 500 indicate an error with Zodia’s servers
In addition to these HTTP response codes, Zodia provides in the response payload:
  • an error code starting with ER- that should be shared with Zodia for troubleshooting
  • a human-readable message providing more details about the errors
The table below describes some errors you may encounter:
HTTP status codeError codeError messageDescription
400ER-101Missing mandatory field: field_nameA mandatory field is missing in the payload received by Zodia
400ER-102Entity with id: entity_id does not existYou are trying to use an entity (company, wallet, transaction, etc…) that does not exist
400ER-103Size of the field: field_name must be between min_value and max_valueLength of the value provided does not match the expected size
400ER-104Entity with id: entity_id already existsYou are trying to create an entity (company, wallet, transaction, etc…) which already exists
400ER-107Field: field_name must not be blankField is missingValue of the field is empty
400ER-108Field: field_name does not match the expected pattern: regexp_valueYou sent a value that does not match the pattern expected by Zodia
400ER-111Value of the field: field_name is not a supported cryptocurrencyThe cryptocurrency provided is not currently supported by Zodia
400ER-112Field: field_name must not be emptyYou sent an empty value/list while Zodia is expecting at least one value
400ER-113Entity with id: entity_id is deactivatedYou are trying to use a deactivated entity
400ER-114Field: field_name does not match with user’s companyThe value you provided for the field (usually “domainId”) does not match your company’s identifier
400ER-115Field: field_name does not match with resource parameter: path_parameterThe value you provided in the payload does not match the path parameter used in the resource
400ER-116Value of the field: field_name must contain only digitsYou sent a value that is not a numeric value
400ER-117Value of the field: field_name must be equal to valueYou must send a value strictly equal to the value expected by Zodia
400ER-121Field: field_name must be greater than or equal to valueYou must send a value greater than or equal to the value expected by Zodia
400ER-122Field: field_name must be less than or equal to valueYou must send a value lesser than or equal to the value expected by Zodia
400ER-124Only max_value minutes of drift are allowedZodia allows 5 minute of drift between the signed timestamp provided and the instant that Zodia receives the query
500ER-128currency_value is not a known currencyZodia was not able to verify the provided currency
500ER-200Internal ErrorInternal service error
400ER-202Header: header must not be blankHeader is missingValue of the header is empty
500ER-206Unable to fetch dataZodia was not able to fetch the data requested
400ER-212Approval timeoutTransaction approval expires
400ER-214Transaction amount greater than available amount or fee amountThe transfer instruction cannot be created as there are not sufficient funds to pay for the amount and/or fee
400ER-234Entity with id: value is not ready to be submittedThe id provided not allowed to be submitted
400ER-253Not enough fundsThe transfer instruction cannot be created as there are not sufficient funds to pay for the amount and/or fee
400ER-255Insufficient funds available to cover transfer and feeThe transfer instruction cannot be created as there are not sufficient funds to pay for the amount and/or fee
400ER-260You are attempting to send to an invalid addressThe transfer instruction has been rejected due to sender or recipient details
400ER-501Transaction creation is rejectedThe transfer instruction has been rejected due to sender or recipient details
400ER-502Mismatch between transaction’s wallet currency and field: field_nameThe cryptocurrency you provided for the field is not consistent with the wallet used for the transaction
400ER-503Value of the field: field_name is not adapted to this endpointYou provided a value that is not supported by the endpoint you used. Example: “preburn” while using the endpoint “/api/core/transactions”
400ER-504Mismatch between field: field1_name and field: field2_nameThe fields “field1” and “field2” must have the same value
400ER-505Mismatch between transaction’s wallet and field: field_nameThe value you provided for the field does not match the wallet used for the transaction
400ER-506Mismatch between transaction’s company and field: field_nameThe value you provided does not match the company used for the transaction
400ER-512Eth transaction fee-included not allowedYou can’t submit a transaction ETH included fees
400ER-601Ledger wallet is not compatible with this operationYou are trying to initiate a contract-related transaction while using a wallet that does not support this operation
400ER-604Error retrieving the wallet addressZodia was not able to retrieve the address associated to this wallet
400ER-615The sender and recipient cannot be the sameThe provided transfer sender and transfer recipient cannot be the same
401ER-210Signature verification failedZodia was not able to verify the signature you provided. Either because: private key that signed the data does not match with public key shared with ZodiaData signed is wrong Please refer to the section Authentication
401ER-211Access to this resource is deniedThe entitlements defined by Zodia don’t allow you to access this resource
404Endpoint doesn’t existYou are trying to reach an endpoint that does not exist
405ER-204Available methods : available_methodsYou must choose from the available methods for an endpoint. Example: GET,POST
429ER-208Rate limit or daily quota exceededToo many request submitted in a given time period, exceeded the number of requests allowed
400ER-903Invalid parameter: filterYou must provide a valid filter value
400ER-1123This user is already link to a group change : valueYou must provide a different group for this user
401ER-1200Invalid company IdThe value you provided does not match the any valid company Id
400ER-1201Invalid notification IdThe value you provided does not match the any valid notification Id
400ER-1650Invalid entity IDThe value you provided does not match the any valid entity Id
400ER-1902You need to deactivate all active addresses before deactivating the beneficiaryAll active addresses must be deactivated first
500ER-001Unexpected error: errorZodia encountered an unexpected error and can not fulfill the request Please contact Zodia with the error’s identifier beginning with the keyword “ERR”