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.
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.