DriveWealth uses standard HTTP response codes to indicate the success or failure of an API request.

Codes in the 200 range indicate success.
Codes in the 400 range indicate a failure given the information provided.
Codes in the 500range indicate an error with the DriveWealth servers (very uncommon).

In the occurrence of 4xx response code, DriveWealth will provide a JSON error code message that briefly explains the error.

Each API request has an associated request identifier. You can find this value in the response headers, under dw-request-id. You should log this identifier as you would any other API response.

Error Code Reference Tables

Account Errors

Error Code	Error Response	Error Description
A010	ACCOUNT_MISSING_PARAMETER	A required parameter is missing or invalid in the request body.
A011	ACCOUNTID_MISSING_INVALID	A required accountID is missing or invalid.
A012	ACCOUNTNO_MISSING_INVALID	A required accountNo is missing or invalid.
A013	ACCOUNT_DATERANGE_MISSING_INVALID	A required date range is missing or invalid.
A015	ACCOUNT_INVALID_USER_TYPE	The given type of account cannot be created for the given user.
A020	ACCOUNT_BAD_COMBINATION_PARAMETER	One or more parameters in the given combination are missing or invalid.
A035	ACCOUNT_MISSING_USER_PARAMETER	Unable to create account due to missing field(s) on the user.
A044	ACCOUNT_CASH_TRANSFER_INVALID_AMOUNT	The amount of the cash to be transferred is missing or invalid.
A045	ACCOUNT_TRANSFER_MISSING_COMMENT	The `comment` of this transfer is missing.
A047	ACCOUNT_CASH_TRANSFER_INSUFFICIENT_FUNDS	There is insufficient cash in the account to complete a transfer.
A050	ACCOUNT_NOT_FOUND	The account you were trying to retrieve was not found.
A051	ACCOUNT_RESTRICTED	Account has been restricted.
A055	ACCOUNT_INVALID_OPERATION	The requested operation cannot be performed on this account.
A062	ACCOUNT_CASH_TRANSFER_FROM_FAILURE	Transferring cash from this account has failed.
A063	ACCOUNT_CASH_TRANSFER_TO_FAILURE	Transferring cash to this account has failed.
A065	ACCOUNT_CASH_TRANSFER_OUTSIDE_MMW	Transferring cash outside money movement window is not permitted.
A071	ACCOUNT_NOT_HOUSE_ACCOUNT	The account is not a house account.
A072	ACCOUNT_INVALID_RIA	The user account does not belong to the given RIA.
A100	ACCOUNT_ERROR	There was an error in retrieving the account.

ACAT Errors

(Automated Customer Account Transfer)

Error Code	Error Response	Error Description
AC001	ACATS_BAD_SYMBOL_REQUEST	ACATs Request rejected because Symbols are not available
AC002	ACATS_INPUT_INVALID	Input(s) invalid
AC003	ACATS_REQUEST_ALREADY_SUBMITTED	Request has been already submitted.

Beneficiary Errors

Error Code	Error Response	Error Description
B001	BENEFICIARIES_ACCOUNT_ERROR	Beneficiaries account request failed.
B050	BOD_NOT_FOUND	Unable to generate BOD summary. Contact administrator.

Commission Errors

Error Code	Error Response	Error Description
C010	COMMISSION_NO_COMMISSION_ID	No commissions set for current BackOffice user. Contact administrator to get a commission schedule.

Document Errors

Error Code	Error Response	Error Description
D001	DOCUMENT_TOO_LARGE	Document is too large to upload. Please resize your document.
D011	DOCUMENT_INVALID_CONTENT_TYPE	Content type not accepted.
D050	DOCUMENT_NOT_FOUND	The document you were trying to retrieve was not found.
D100	DOCUMENT_ERROR	There was an error in retrieving the document.
D200	DOCUMENT_APPROVED	Document has been Approved.
D201	DOCUMENT_PENDING	Document approval is Pending.
D202	DOCUMENT_REJECTED	Document has been Rejected.
D203	DOCUMENT_NOT_SUBMITTED	Document has not been submitted for approval.
D204	DOCUMENT_UPLOAD_DENIED	User does not have permission to upload Document. Please check your User Status for more information.
D205	DOCUMENT_UNKNOWN	Document is unknown.

Request Errors

Error Code	Error Response	Error Description
E005	STALE_REQUEST	Request date header too old.
E006	FUTURE_REQUEST	Request date header is in the future.
E010	NO_REQUEST_BODY	No request body provided.
E015	UNSUPPORTED_FORMAT	Unsupported Format.
E020	DUPLICATE_VALUE	Value Exists Already.
E025	BAD_REQUEST	Invalid or badly formatted request.
E030	BAD_MISSING_PARAMETERS_URL	Invalid or missing parameters in the request URL.
E031	BAD_MISSING_PARAMETERS_URL_BODY	Invalid or missing parameters in the request URL or body.
E032	BAD_MISSING_PARAMETERS_BODY	Invalid or missing parameters in the request body.
E033	INVALID_PARAMETER_BODY	Invalid parameter in message body.
E035	INVALID_ACTION_BODY	Invalid action in message body.
E040	BAD_COMBINATION_PARAMETERS_URL	A combination of two or more parameters in the URL is missing or invalid.
E050	NOT_FOUND	The resource you were trying to retrieve was not found.
E075	DUPLICATE_REQUEST	The action you are trying to perform is a duplicate.
E090	REQUIRED_PARAMETER_MISSING	A required parameter needed to maintain state is missing.
E099	ERROR_UNKNOWN	Oops! Something went wrong in processing your request. Please contact support.
E100	ERROR	There was an error in processing your request.
E101	ERROR_IDEMPOTENT_REQUEST_RETRY	Maximum retry attempt limit of 5 has been reached. Please contact support.

Header Errors

Error Code	Error Response	Error Description
H050	HEADER_APP_KEY_NOT_FOUND	Client App Key header not found. Contact tech support if you do not have an app key.
H055	HEADER_APP_KEY_INVALID	Client App Key header invalid. Contact tech support.
H060	HEADER_AUTH_TOKEN_NOT_FOUND	Auth token header not found. Log in first to obtain an auth token.
H065	HEADER_AUTH_TOKEN_INVALID	Invalid auth token header. If problem persists, try re-log in.
H070	HEADER_DW_CUSTOMER_NOT_FOUND	DW custom userID header not found. This header is required for this operation.
H075	HEADER_DW_CUSTOMER_ACCOUNT_NOT_FOUND	DW custom accountID header not found. This header is required for this operation.
H080	HEADER_BEARER_TOKEN_ALGORITHM_MISSING_INVALID	Algorithm in bearer token is missing/invalid.
H081	HEADER_BEARER_TOKEN_ISSUER_MISSING_INVALID	Issuer in bearer token is missing/invalid.
H082	HEADER_BEARER_TOKEN_ENVIRONMENTS_MISSING_INVALID	Allowed environments in bearer token are missing/invalid.
H085	HEADER_BEARER_TOKEN_WEB_KEY_NOT_FOUND	Unable to retrieve web key from token key ID.
H090	HEADER_BEARER_TOKEN_INVALID	Bearer token is invalid.
H100	HEADER_BEARER_TOKEN_ERROR	Bearer token error. Contact tech support.

Instrument Errors

Error Code	Error Response	Error Description
I010	INSTRUMENT_INVALID_TRADE_STATUS	Invalid trade status.
I011	INSTRUMENT_INVALID_EXCHANGE_ID	Invalid exchangeID.
I012	INSTRUMENT_INVALID_TYPE	Invalid instrument type.
I013	INSTRUMENT_INVALID_ORDER_SIZE	Invalid order size(min/max/step).
I014	INSTRUMENT_MISSING_SYMBOL	Symbol is required when updating the instrument image.
I015	INSTRUMENT_UPDATE_FORBIDDEN	Some fields of an instrument can not be updated.
I016	INSTRUMENT_GROUP_INVALID_TYPE	Invalid instrument group type.
I017	INSTRUMENT_GROUP_INVALID_STATUS	Invalid instrument group status.
I018	INSTRUMENT_GROUP_INVALID_ID	Invalid instrument group ID.
I019	INSTRUMENT_GROUP_INVALID_SYMBOLS	Invalid symbol(s) in the request body.
I050	INSTRUMENT_NOT_FOUND	The instrument(s) you were trying to retrieve was not found.

Idempotency Errors

Error Code	Error Response	Error Description
IK010	IDEMPOTENCY_KEY_INVALID_LENGTH	Idempotency Key too short. Must be at least 16 characters.
IK025	IDEMPOTENCY_KEY_BAD_TOKEN	Error in processing idempotency request token. Contact support.
IK075	IDEMPOTENCY_KEY_RESPONSE_ERROR	Something went wrong in retrieving cached response. Aborting with error response.

Bank Account Errors

Error Code	Error Response	Error Description
K050	BANK_ACCOUNT_NOT_FOUND	Bank account temporarily disabled or not found. Contact customer support.
K075	BANK_ACCOUNT_INVALID	Invalid bank account for this operation. Contact customer support if this persists.
K100	BANK_ACCOUNT_ERROR	Bank account error.
K110	BANK_ACCOUNT_INVALID_PLAID_TOKEN	Plaid processor token provided is invalid.

Login Errors

Error Code	Error Response	Error Description
L010	LOGIN_2FA_MISSING	Missing Two Factor Authentication information.
L011	LOGIN_2FA_TYPE_SELECTION	Missing or invalid 2FA type selection.
L015	LOGIN_PHONE_NUMBER_NOT_VALID	Phone number format not recognized. Use email verification or contact customer support.
L019	LOGIN_MISSING_TEMP_CODE	Missing temp code. Provide a valid temp code issued at log in.
L020	LOGIN_INVALID_TEMP_CODE	Invalid temp code. Please log in again.
L022	LOGIN_NULL_TEMP_CODE	Temp code has already been used or was never issued. Please log in again.
L024	LOGIN_NO_HEARTBEAT	Auth Token expired due to inactivity. Please log in again.
L025	LOGIN_EXPIRED	Auth Token expired. Please log in Again.
L050	LOGIN_INVALID	Invalid Credentials.
L065	LOGIN_INVALID_TOKEN	Invalid auth token. Please log in again.
L070	LOGIN_2FA_REQUIRED	Two factor authentication required for login. Re-login via 2FA.
L075	LOGIN_LOGGED_OUT	User already logged out. Please log in again.
L090	LOGIN_AUTH_FAILURE	Something went wrong in trying to retrieve your auth token. Please log in again.
L100	LOGIN_FAILURE	Login Failure.

Managed Account Errors

Error Code	Error Response	Error Description
M010	MANAGED_ACCOUNT_INVALID	The riaID is not valid or not active.
M011	MANAGED_ACCOUNT_CLIENT_INVALID	The accountID/accountNo does not belong to the master account.
M012	MANAGED_ACCOUNT_INVALID_CASH_TRANSFER	The riaID is not valid for transferring cash from/to sub account.
M013	MANAGED_ACCOUNT_INACTIVE_ACCOUNT	The account is NOT active.

Instant Funding Errors

Error Code	Error Response	Error Description
N010	INSTANT_FUNDING_NO_ACCOUNT	Instant funding account not set. Contact administrator.
N015	INSTANT_FUNDING_EXISTING_ACCOUNT	Instant funding account already exists. Contact administrator.
N020	INSTANT_FUNDING_ACCOUNT_INACTIVE	Instant funding account is disabled. Contact administrator.
N030	INSTANT_FUNDING_INVALID_AMOUNT	Invalid amount for deposit.
N050	INSTANT_FUNDING_NO_FUNDS	Instant funding threshold reached. Contact administrator.
N050	INSTANT_FUNDING_INSUFFICIENT_FUNDS	Insufficient funds in IFA account. Contact administrator.
N060	FUND_INVALID_FUND_TYPE	Invalid fund type.
N100	INSTANT_FUNDING_ERROR	There was an error in processing the instant money movement request.

Order Errors

Error Code	Error Response	Error Description
O005	ORDER_INVALID_ORDER_TYPE	Invalid order type.
O006	ORDER_INVALID_ORDER_SIDE	Invalid order side.
O010	ORDER_INVALID_STOP_REQUEST	Incomplete stop order. One or more parameters may be missing or invalid.
O011	ORDER_INVALID_LIMIT_REQUEST	Incomplete limit order. One or more parameters may be missing or invalid.
O012	ORDER_INVALID_MARKET_REQUEST	Invalid market order. One or more parameters may be missing or invalid.
O015	ORDER_EITHER_QTY_OR_CASH	Invalid order. Enter one from amount OR order quantity.
O016	ORDER_INVALID_ORDER_METHOD	Invalid order method.
O017	ORDER_INVALID_MIT_REQUEST	Incomplete `marketIfTouched` order. One or more parameters may be missing or invalid.
O018	ORDER_INVALID_TIF_REQUEST	Invalid Time In Force. One or more parameters may be missing or invalid.
O019	ORDER_INVALID_EXPIRATION_REQUEST	Invalid order expiration. One or more parameters may be missing or invalid.
O050	ORDER_NOT_FOUND	Requested order resource was not found.
O098	ORDER_ACCOUNT_ERROR	Orders can only be placed on open accounts.
O099	ORDER_ERROR	There was an error processing your order.
O123	ORDER_EXPIRED	The order has expired.
O124	DIVIDENDS	The corporate action was canceled, specifically dividends.
O624	DAY TRADE REJECTION	The order is rejected since the account is PDT restricted

Permissions Errors

Error Code	Error Response	Error Description
P020	PERMISSIONS_NO_PERMISSIONS	No permissions have been assigned to this user. Contact your administrator.
P045	PERMISSIONS_GROUP_ID_NOT_FOUND	There was an error retrieving your permission group. If problem persists, contact your administrator.
P050	PERMISSION_NOT_FOUND	Requested/assigned permission not found. Contact your administrator.
P075	PERMISSIONS_UNAUTHORIZED	User does not have permissions to perform this operation. Contact your administrator.
P087	PERMISSIONS_RESOURCE_PARENTIB_NOT_ASSIGNED	No parentIB assigned to the resource entity. Contact your administrator.
P088	PERMISSIONS_BO_PARENTIB_NOT_ASSIGNED	No parentIB assigned to the back office user. Contact your administrator.
P090	PERMISSIONS_PARENTIB_NO_MATCH	The operator user and the operated resource do not belong to the same organization. Contact your administrator.

Reports Errors

Error Code	Error Response	Error Description
R010	REPORT_INVALID_DATE	Invalid date.There are no reports available for the date(s) provided.
R011	REPORT_FUTURE_DATE	Date in future.There are no reports available for the date(s) provided.

Records Errors

Error Code	Error Response	Error Description
S100	SEARCH_NO_RECORDS_FOUND	No records were found for the given search criteria. Modify your search and try again.

Product Errors

Error Code	Error Response	Error Description
T010	PRODUCT_RIA_ID_INVALID_MISSING	The riaID of product is missing or invalid.
T011	PRODUCT_TYPE_INVALID_MISSING	A required type of product is missing or invalid.
T012	PRODUCT_FUND_ID_INVALID_MISSING	A required fundID of product is missing or invalid.
T013	PRODUCT_OVERWEIGHT_ERROR	A total weight of product is over 100%.
P050	PRODUCT_NOT_FOUND	The product you were trying to retrieve was not found.

Quotes Errors

Error Code	Error Response	Error Description
Q050	QUOTES_NOT_FOUND	The quote you were trying to retrieve is not available.
Q100	QUOTES_ERROR	There was an error in retrieving quotes.

User Errors

Error Code	Error Response	Error Description
U010	USERNAME_NOT_UNIQUE	The username already exists.
U025	USER_INVALID_MISSING_PARAMETER	Invalid or missing required parameter on the user. Refer to the API documentation for details.
U040	USER_INFO_DOCUMENT_MISSING	A required document for the specified user or account type is missing incomplete.
U045	USER_NO_KYC	The user is not in the KYC Queue.
U050	USER_NOT_FOUND	The user you were trying to retrieve was not found. Please check the User ID and try again.
U060	USER_NO_PARENTIB_SET	User does not have a parentIB set. Contact your administrator.
U062	USER_INVALID_PARENTIB_SET	Unable to find parentIB associated with the user. Contact your administrator.
U064	USER_NO_REFERRER_PARENTIB_SET	Referrer does not have a parentIB set. Contact your administrator.
U065	USER_INVALID_REFERRER_PARENTIB_SET	Unable to find parentIB associated with the referrer. Contact your administrator.
U070	USER_NO_PRIVILEGES	User does not have permissions to access this information. Contact your administrator.
U072	USER_NO_ACCESS	User is not allowed to access this resource.
U075	USER_UNABLE_RETRIEVE	Unable to validate the user associated with the log in information.
U080	USER_INVALID_ID_NO	The specified identification value is not appropriate for the specified Citizenship.
U090	USER_MISSING_INFORMATION	User is missing required information to process this request.
U100	USER_ERROR	There was an error in retrieving the user.
U101	USER_ERROR	User's info has not been submitted for KYC.
U102	USER_PENDING	User's info required.
U103	USER_KYC_PENDING	KYC verification failed.
U104	USER_INFO_REQUIRED	User is waiting for approval.
U105	USER_REJECTED	There was an error in processing the deposit request.
U106	USER_PENDING_APPROVAL	User is waiting for approval.

Payment Errors

Error Code	Error Response	Error Description
Y025	PAYMENT_NOT_ALLOWED	Unable to initiate/authorize payment.
Y044	PAYMENT_DEPOSIT_AMOUNT_BELOW_MINIMUM	Deposit does not meet the required minimum amount.
Y050	PAYMENT_REDEMPTION_NOT_FOUND	The redemption you were trying to retrieve was not found.
Y051	PAYMENT_DEPOSIT_NOT_FOUND	The deposit you were trying to retrieve was not found.
Y060	PAYMENT_RECURRING_DETAILS_NOT_FOUND	The recurring deposit details were not found.
Y075	PAYMENT_INSUFFICIENT_BALANCE	The redemption amount is more than the cash available.
Y099	PAYMENT_DEPOSIT_ERROR	The redemption you were trying to retrieve was not found.

KYC Document Errors

Error Code	Error Response	Error Description
K001	AGE_VALIDATION	The age calculated from the documents date of birth point is greater than or equal to the minimum accepted age set at the account level
K002	POOR_PHOTO_QUALITY	"Poor photo quality. ID may be too dark, damaged, blurry, cut off, or have a glare"
K003	POOR_DOC_QUALITY	"Abnormal document quality. ID may have obscured data points, obscured security features, a corner removed, punctures, or watermarks obscured by digital text overlay"
K004	SUSPECTED_DOCUMENT_FRAUD	Tampering and forgery found on the document
K005	INCORRECT_SIDE	The incorrect side of the document had been uploaded. Choose the correct side of the document and re-upload
K006	NO_DOC_IN_IMAGE	"No document was found in the image, or there is a blank image"
K007	TWO_DOCS_UPLOADED	Two different documents were submitted as the same document type
K008	EXPIRED_DOCUMENT	Document is expired or invalid format of expiry date
K009	MISSING_BACK	The back of the document is missing
K010	UNSUPPORTED_DOCUMENT	Document is not supported
K011	DOB_NOT_MATCH_ON_DOC	The DOB listed on the customer’s ID is not the same DOB listed on the customer’s application
K012	NAME_NOT_MATCH_ON_DOC	The Name on the the customer’s ID is not the same Name listed on the customer’s application
K050	INVALID_DOCUMENT	Unable to process your document. File is corrupted and can't be opened.

KYC Non-Document Errors

Error Code	Error Response	Error Description
K101	ADDRESS_NOT_MATCH	No match found for address or invalid format in address
K102	SSN_NOT_MATCH	No match found for Social Security Number
K103	DOB_NOT_MATCH	No match found for Date of Birth
K104	NAME_NOT_MATCH	No match found for firstName / lastName or invalid characters found
K106	SANCTION_WATCHLIST	User is under sanction watch list
K107	SANCTION_OFAC	User is found in OFAC SDN list
K108	INVALID_PHONE_NUMBER	The phone number listed on the customer’s application is not a valid number of digits for a phone number
K109	INVALID_EMAIL_ADDRESS	The emailID listed on the customer’s application is not valid or unable to verify in watch list.
K110	INVALID_NAME_TOO_LONG	The first name or last name listed on the customer's application is not valid. First name or last name should not be greater than 36 characters.
K111	UNSUPPORTED_COUNTRY	The KYC is not supported in the country.
K801	AGED_ACCOUNT	KYC is not verified by user within 30 days
K802	ACCOUNT_INTEGRITY	Account information provided may not be legitimate and/or is being used by multiple account holders
U999	UNKNOWN	Unrecognized error

Bars Errors

Error Code	Error Response	Error Description
B100	INVALID_REQUEST_FOR_DAILY_BARS	The number of bars requested has exceeded the maximum allowed of 10 Years for Daily bars.
B100	INVALID_REQUEST_FOR_ONE_MINUTE_BARS	The number of bars requested has exceeded the maximum allowed of 1 Month for 1 minute bars.
B100	INVALID_REQUEST_FOR_FIVE_MINUTES_BARS	The number of bars requested has exceeded the maximum allowed of 2 Months for 5 minutes bars.
B100	INVALID_REQUEST_FOR_THIRTY_MINUTES_BARS	The number of bars requested has exceeded the maximum allowed of 1 Year for 30 minutes bars.
B100	INVALID_REQUEST_FOR_ONE_HOUR_BARS	The number of bars requested has exceeded the maximum allowed of 2 Years for 1 hour bars.
B100	INVALID_REQUEST_FOR_WEEKLY_BARS	The number of bars requested has exceeded the maximum allowed of 20 Years for Weekly bars.
OT002	ONE_TICK_BARS_REQUEST_EXCEEDED	The Number of Bars request has exceeded the maximum allowed Bars.
OT003	OTHER_ONE_TICK_ERRORS	Unable to retrieve bars data.

Asset Transfer Errors

Error Code	Error Response	Error Description
T003	ASSETS_TRANSFER_NEGATIVE_CASH	Assets Transfer cannot initiate because of negative cash in the account.
T004	ASSETS_TRANSFER_REJECTED	Assets Transfer cannot initiate.
T005	ASSETS_TRANSFER_UNAUTHORIZED	Unauthorized to initiate Assets Transfer.