Common Error Codes

The following are errors that can happen on any request to Helix depending on the request parameters, origin, intermediate network, etc. If present, these values will appear in the errors property of the API response.

CodeMessage (en-US)HTTP Status CodeNotes
50401User is not authorized401Check your configuration for proper Helix API Key and Secret values against those in Helix Admin console. Existing ones may have expired.
50403IP is not trusted403Check the IP of the request. If it is a valid IP, contact [email protected] to whitelist it.
50404The requested resource was not found404The route is invalid or is not supported in the version associated with your API Key.
50405The requested HTTP method is not allowed405The route accepts a different HTTP method - did you issue a POST when you should have issued a GET for a particular route?
50429Rate limit exceeded429Too many requests within a certain timeslice for your API Key. Wait a small amount of time and retry the request. If this happens regularly, contact Helix support to increase your rate limit (additional fee may be applied).
50500Internal Server Error500Helix is experiencing issues. Please share your requestId with [email protected]
50501Not Implemented501The route is invalid. Verify your code is calling a documented Helix route.
50502Bad Gateway502Network connectivity issues between your server and Helix servers, or Helix is down for maintenance. Investigate, and if issues persist, contact [email protected]
50503Service Unavailable503Helix servers are unavailable. You will need to try your request later.
50504Gateway Timeout504Network connectivity issues between your server and Helix servers, or Helix is down for maintenance. Investigate, and if issues persist, contact [email protected]
50505HTTP Version Not Supported505HTTP/1.1 must be specified when using Helix. Change your code to issue HTTP/1.1 requests.
50902ProgramId {0} does not have a BIN mapped to it400Your program is configured incorrectly. Contact [email protected]
50904Could not find PciKeyId for BankId {0}, ProgramId {1} in a status of 1 (Encrypt and Decrypt allowed)400Your program is configured incorrectly. Contact [email protected]
52998Internal Server Error. Incident Id : {0}500This is the catch-all error number for an internal server error. Please contact [email protected] with the Incidient Id provided in the message.
58150QualiFile service call error received500The content of this error message may be replaced by the actual one received from the QualiFile service call.
59001No VerificationFundsAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59002No RetailClearingAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59003No ProgramExternalAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59004No BankIncomeAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59005No RegDFeeAmtForExceedingMonthlyMax configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59006No RegDMonthlyTransWithdrawCountMax configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59007Internal to Internal transfer is disabled for program {0}400Your program is configured incorrectly. Contact [email protected]
59008AllowedAccountTypeId is not configured properly for program {0}400Your program is configured incorrectly. Contact [email protected]
59009Program {0} does not have recurring contributions enabled400You are unable to do recurring contributions because it is disabled for your program.
59010Program {0} is not configured to require external account verification. Call /externalAccount/create instead400Call /externalAccount/create instead.
59011Program {0} is configured to require external account verification. Call /externalAccount/initiate instead400Call /externalAccount/initiate instead.
59012Program {0} is missing a ProgramReport record for the given date range and program400Your program is configured incorrectly. Contact [email protected]
59013No ProgramClearingAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59014No MiscellaneousAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59015No GeneralJournalAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59016No CashAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59017No RetailExternalAccount configured for program {0}400Your program is configured incorrectly. Contact [email protected].com
59018No ProgramEcode.PercentToClient configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59019No ProgramEcode.PercentToCorePro configured for program {0}400Your program is configured incorrectly. Contact [email protected]
59020Program {0} does not have account type {1} enabled.400Your program is configured incorrectly. Contact [email protected]
59102No ProgramClearingAccount linked to ProgramExternalAccount {0}400Your program is configured incorrectly. Contact [email protected]
59103All card numbers are already allocated for Program {0}400Your program is configured incorrectly. Contact [email protected]
59109Peer-to-peer transfers are not enabled for your program400Use of peer-to-peer (P2P) transfer functionality requires approval from Q2 and your bank partner. Please contact your Client Success Manager for more info.
59900Could not convert {0} to {1}: {2}. Path '{3}', line {4}, position {5}.400Invalid value passed in for a JSON property. The value could not be converted to the proper type. {0} = JSON type, {1} = destination type, {2} = value, {3} = property name, {4} = line number, {5} = character position. e.g.: "Could not convert string to decimal: 11..04. Path 'recurringContributionAmount', line 9, position 42."
59901Invalid JavaScript property identifier character: {0}. Path '{1}', line {2}, position {3}.400Property name is missing opening quote character ('"'). {0} = property name, {1} = line number, {2} = character position. e.g.: "Invalid JavaScript property identifier character: ". Path 'targetDate', line 13, position 7."
59902Expected ':' but got: {0}. Path '{1}', line {2}, position {3}.400Property name is missing closing quote character ('"'). {0} = first character of property name, {1} = property name, {2} = line number, {3} = character position. e.g.: "Expected ':' but got: S. Path 'targetDate', line 13, position 11."
59903Invalid character after parsing property name. Expected ':' but got: =. Path '{0}', line {1}, position {2}.400Attempting to use "=" instead of ":" to separate property name and its value. {0} = property name (typically the name of the previous property, not the one with the issue), {1} = line number, {2} = character position. e.g.: "Invalid character after parsing property name. Expected ':' but got: =. Path 'tag', line 11, position 18."
59904Error reading {0}. Unexpected token: StartArray. Path '{1}', line {2}, position {3}.400Passed an array value to a property which is not an array. {0} = destination type, {1} = property name, {2} = line number, {3} = character position. e.g.: "Error reading string. Unexpected token: StartArray. Path 'tag', line 10, position 11."
59905Error parsing NaN value. Path '{0}', line {1}, position {2}.400Attempting to pass null for a property value, but using an invalid casing (such as NULL or Null). {0} = property name, {1} = line number, {2} = character position. e.g.: "Error parsing NaN value. Path 'tag', line 10, position 10."
59906After parsing a value an unexpected character was encountered: ;. Path '{0}', line {1}, position {2}.400Attempting to use a semicolon (;) where a comma (,) should be used. {0} = property name, {1} = line number, {2} = character position. e.g.: "After parsing a value an unexpected character was encountered: ;. Path 'customerId', line 2, position 22."
59949(Message varies)400A generic JSON parsing error occurred. See message for details. i.e. The JSON payload is not structured properly in some way.
59950Unexpected end when deserializing object. Path '{0}', line {1}, position {2}.400Closing curly brace ("}") is missing in JSON payload. {0} = property name, {1} = line number, {2} = character position. e.g.: "Unexpected end when deserializing object. Path 'type', line 15, position 1."
59951Error converting value "{0}" to type '{1}'. Path '', line {2}, position {3}.400Opening curly brace ("}") is missing in JSON payload. {0} = first property name in payload, {1} = (varies, ignore), {2} = line number, {3} = character position. e.g.: "Error converting value "customerId" to type 'CorePro.Business.Account'. Path '', line 2, position 15."
59952Value for property '{0}' is not formatted as a valid ISO-8601 DateTime. Example value=2015-01-31T22:43:21.123+00:00400The value for the property is not formatted as an ISO-8601 date. e.g.: "Value for property 'targetDate' is not formatted as a valid ISO-8601 DateTime. Example value=2015-01-31T22:43:21.123+00:00"
59953Value for property '{0}' is not formatted as a valid boolean. Valid values=true,false400The value for the property is not formatted as a boolean value. e.g.: "Value for property 'isCloseable' is not formatted as a valid boolean. Valid values=true,false"
59954Value for property '{0}' is not formatted as a valid decimal (precision up to 2). Example value=1234.56400The value for the property is not formatted as a decimal value. e.g.: "Value for property 'targetAmount' is not formatted as a valid decimal (precision up to 2). Example value=1234.56"
59955Value for property '{0}' is not formatted as a valid decimal (precision up to 11). Example value=1234.56789012345400The value for the property is not formatted as a decimal value. e.g.: "Value for property 'interestRateMonthly' is not formatted as a valid decimal (precision up to 2). Example value=1234.56789012345"
59956Value for property '{0}' is not acceptable. Specifics: {1}400The value for the property could not be cast properly. e.g.: "Value for property 'customerId' is not acceptable. Specifics: Input string '12548a' is not a valid integer. Path 'customerId', line 2, position 23."
59957Missing a closing curly brace. Specifics: {0}400JSON payload is missing a closing curly brace. e.g.: "Missing a closing curly brace. Unexpected end when deserializing object. Path 'type', line 12, position 1."
59958Missing an opening curly brace. Specifics: {0}400JSON payload is missing an opening closing curly brace. e.g.: "Missing an opening curly brace. Specifics: Error converting value "customerId" to type 'CorePro.Business.Account'. Path '', line 2, position 15."
59999(Message varies)400A generic JSON deserialization error occurred. See message for details. i.e. The JSON payload is not structured properly in some way.
60001Customer id {0} is invalid400Provide a valid customerId in the request
60002Customer id {0} is inactive400An inactive customer cannot perform any actions in Helix. Redirect the user to a page informing them of this.
60003Customer id {0} is not in a verified status400An unverified customer cannot perform any actions in Helix (except call /customer/verify). Redirect the user to a page informing them of this.
60004Customer id {0} is locked400An locked customer cannot perform any actions in Helix. Redirect the user to a page informing them of this.
60005Customer id {0} is marked as deceased400An deceased customer cannot perform any actions in Helix. Redirect the user to a page informing them of this.