Link Account Errors

🚧
Under Construction
These documents are a still a work in progress. The missing endpoint and fields will be completed as soon as possible and updates to the information will be made as needed.

Link Account

Errors pertaining to link_account endpoint.

Error Code	Error Response Message	Error Type	Troubleshooting	Error Status Code
Key not present in response.	Bank account successfully linked.			200
Key not present in response.	Bank account not successfully linked (public token may have expired; tokens expire in 30 minutes after creation).			200
Key not present in response.	Bank account linked, but in a frozen state.			202
Key not present in response.	The end user is NOT using a PRODUCTION tier and the account_name is 'no match' and the end user provides a public_token or a plaid_token
Key not present in response.	Check `validation_details` for more information. `PRODUCT_NOT_READY` indicates the account is waiting to be linked (with microdeposit verification, for instance).			400
Key not present in response.	authsignature or usersignature header was absent or incorrect.			401
invalid_choice	`"{ ""success"": false, ""validation_details"": { ""invalid_choice"": ""'{input}' is not a valid choice. Must be one of: {PLAID_TOKEN_TYPE_CHOICES}"" }, ""message"": ""Bad request."", ""status"": ""FAILURE"" }"`	Validation Error: Invalid Token Type	Please ensure the token type being entered is a valid entry and try the request again.	400
required	`"{ ""success"": false, ""validation_details"": { ""public_token"": ""This field is required."" }, ""message"": ""Bad request."", ""status"": ""FAILURE"" }"`	Validation Error: Plaid Token is required.	Please ensure the correct token type being entered and try the request again.	400
required	"{ ""success"": false, ""validation_details"": { ""account_number"": ""This field is required."" }, ""message"": ""Bad request."", ""status"": ""FAILURE"" }"	Validation Error: Account number is required.	Please ensure a public token is being passed and the account number is provided in the request and try the request again.	400
required	"{ ""success"": false, ""validation_details"": { ""routing_number"": ""This field is required."" }, ""message"": ""Bad request."", ""status"": ""FAILURE"" }"	Validation Error: Routing number is required.	Please ensure a public token is being passed and the routing number is being provided in the request and try the request again.	400
required	"{ ""success"": false, ""validation_details"": { ""routing_number"": ""This field is required."" }, ""message"": ""Bad request."", ""status"": ""FAILURE"" }"	Validation Error: Correct account number and routing number is required.	Please ensure a public token is being passed and the correct account number and routing number is being provided in the request and try the request again.	400
Cannot be specified alongside field(s): {other_fields}.	"{ ""success"": false, ""validation_details"": { ""public_token"": ""Cannot be specified alongside field(s): plaid_token."", ""plaid_token"": ""Cannot be specified alongside field(s): public_token."" }, ""message"": ""Bad request."", ""status"": ""FAILURE"" }"	Validation Error	Please provide either a public token or a plaid token with the request but not both.	400
	Plaid error encountered while trying to get account balance: None; the login details of this item have changed (credentials, MFA, or required user action) and a user login is required to update this information. Use Link's update mode to restore the item to a good state.			400
NO_BANK_ACCOUNT_LINKED	No savings or checking account was linked; selected account was of a different account type.	Link Account Error	Response from Plaid does not have an account number, ACH number or the account is not a checking or savings account.	400
Key not present in response.	No score from rosette API request. Response:{rosette_response}	Exception	Production request but the rosette API request returns None.	500
INVALID_PUBLIC_TOKEN	The provided Plaid public token is expired. Public tokens expire 30 minutes after creation; you will need to create and send a new token.	Plaid Error	Sandbox request: Please create and send a new token with the request.	400
INVALID_PUBLIC_TOKEN	The provided Plaid public token is in an invalid format. Expected format: public--.	Plaid Error	Sandbox request: Please check the public token and ensure valid information is being passed in the request.	400
See Plaid's most relevant error codes below	The request does not have a valid Plaid token.	Plaid Error	Please check the request and ensure a valid Plaid token is being passed.	400
NO_BANK_ACCOUNT_LINKED	No savings or checking account was linked; selected account was of a different account type.	Link Account Error	Please ensure that the account number and routing number being sent are for a checking or savings account and submit the request again.	400
NO_CHECKING_ACCOUNT_LINKED	No selected account ID was sent and user did not have a checking account at the chosen institution.	Link Account Error	Please ensure that the correct account ID is provided and that the end user has a checking account at the selected institution.	500
	Plaid received an invalid request: {status}	Plaid Error		400
	Plaid returned an unexpected Auth error code: {err_code}	Plaid Error		400
	Plaid Auth error code: PRODUCT_NOT_READY	Plaid Error		400
	Plaid Micro-deposit verification for a bank account has exceeded the 7-day limit for verification: VERIFICATION_EXPIRED.	Plaid Error		400
INSTANT_MATCH_FAILED	Unknown Plaid Auth error code: INSTANT_MATCH_FAILED	Plaid Error	Plaid docs for INSTANT_MATCH_FAILED	400
INSUFFICIENT_CREDENTIALS	Unknown Plaid Auth error code: INSUFFICIENT_CREDENTIALS	Plaid Error	Plaid docs for INSUFFICIENT_CREDENTIALS	400
INVALID_CREDENTIALS	Unknown Plaid Auth error code: INVALID_CREDENTIALS	Plaid Error	Plaid docs for INVALID_CREDENTIALS	400
INVALID_MFA	Unknown Plaid Auth error code: INVALID_MFA	Plaid Error	Plaid docs for INVALID_MFA	400
INVALID_SEND_METHOD	Unknown Plaid Auth error code: INVALID_SEND_METHOD	Plaid Error	Plaid docs for INVALID_SEND_METHOD	400
INVALID_UPDATED_USERNAME	Unknown Plaid Auth error code: INVALID_UPDATED_USERNAME	Plaid Error	Plaid docs for INVALID_UPDATED_USERNAME	400
ITEM_CONCURRENTLY_DELETED	Unknown Plaid Auth error code: ITEM_CONCURRENTLY_DELETED	Plaid Error	Plaid docs for ITEM_CONCURRENTLY_DELETED	400
ITEM_LOCKED	Unknown Plaid Auth error code: ITEM_LOCKED	Plaid Error	Plaid docs for ITEM_LOCKED	400
ITEM_LOGIN_REQUIRED	Unknown Plaid Auth error code: ITEM_LOGIN_REQUIRED	Plaid Error	Plaid docs for ITEM_LOGIN_REQUIRED	400
ITEM_NOT_FOUND	Unknown Plaid Auth error code: ITEM_NOT_FOUND	Plaid Error	Plaid docs for ITEM_NOT_FOUND	400
ITEM_NOT_SUPPORTED	Unknown Plaid Auth error code: ITEM_NOT_SUPPORTED	Plaid Error	Plaid docs for ITEM_NOT_SUPPORTED	400
MFA_NOT_SUPPORTED	Unknown Plaid Auth error code: MFA_NOT_SUPPORTED	Plaid Error	Plaid docs for MFA_NOT_SUPPORTED	400
NO_ACCOUNTS	Unknown Plaid Auth error code: NO_ACCOUNTS	Plaid Error	Plaid docs for NO_ACCOUNTS	400
NO_AUTH_ACCOUNTS	Unknown Plaid Auth error code: NO_AUTH_ACCOUNTS	Plaid Error	Plaid docs for NO_AUTH_ACCOUNTS	400
NO_INVESTMENT_ACCOUNTS	Unknown Plaid Auth error code: NO_INVESTMENT_ACCOUNTS	Plaid Error	Plaid docs for NO_INVESTMENT_ACCOUNTS	400
NO_INVESTMENT_AUTH_ACCOUNTS	Unknown Plaid Auth error code: NO_INVESTMENT_AUTH_ACCOUNTS	Plaid Error	Plaid docs for NO_INVESTMENT_AUTH_ACCOUNTS	400
NO_LIABILITY_ACCOUNTS	Unknown Plaid Auth error code: NO_LIABILITY_ACCOUNTS	Plaid Error	Plaid docs for NO_LIABILITY_ACCOUNTS	400
PRODUCT_NOT_ENABLED	Unknown Plaid Auth error code: PRODUCT_NOT_ENABLED	Plaid Error	Plaid docs for PRODUCT_NOT_ENABLED	400
PRODUCT_NOT_READY	Unknown Plaid Auth error code: PRODUCT_NOT_READY	Plaid Error	Plaid docs for PRODUCT_NOT_READY	400
PRODUCTS_NOT_SUPPORTED	Unknown Plaid Auth error code: PRODUCTS_NOT_SUPPORTED	Plaid Error	Plaid docs for PRODUCTS_NOT_SUPPORTED	400
USER_SETUP_REQUIRED	Unknown Plaid Auth error code: USER_SETUP_REQUIRED	Plaid Error	Plaid docs for USER_SETUP_REQUIRED	400
USER_INPUT_TIMEOUT	Unknown Plaid Auth error code: USER_INPUT_TIMEOUT	Plaid Error	Plaid docs for USER_INPUT_TIMEOUT	400
INCOMPATIBLE_API_VERSION	Unknown Plaid Auth error code: INCOMPATIBLE_API_VERSION	Plaid Error	Plaid docs for INCOMPATIBLE_API_VERSION	400
INVALID_ACCOUNT_NUMBER	Unknown Plaid Auth error code: INVALID_ACCOUNT_NUMBER	Plaid Error	Plaid docs for INVALID_ACCOUNT_NUMBER	400
INVALID_BODY	Unknown Plaid Auth error code: INVALID_BODY	Plaid Error	Plaid docs for INVALID_BODY	400
INVALID_CONFIGURATION	Unknown Plaid Auth error code: INVALID_CONFIGURATION	Plaid Error	Plaid docs for INVALID_CONFIGURATION	400
INVALID_FIELD	Unknown Plaid Auth error code: INVALID_FIELD	Plaid Error	Plaid docs for INVALID_FIELD	400
INVALID_HEADERS	Unknown Plaid Auth error code: INVALID_HEADERS	Plaid Error	Plaid docs for INVALID_HEADERS	400
MISSING_FIELDS	Unknown Plaid Auth error code: MISSING_FIELDS	Plaid Error	Plaid docs for MISSING_FIELDS	400
NO_LONGER_AVAILABLE	Unknown Plaid Auth error code: NO_LONGER_AVAILABLE	Plaid Error	Plaid docs for NO_LONGER_AVAILABLE	400
NOT_FOUND	Unknown Plaid Auth error code: NOT_FOUND	Plaid Error	Plaid docs for NOT_FOUND	400
SANDBOX_ONLY	Unknown Plaid Auth error code: SANDBOX_ONLY	Plaid Error	Plaid docs for SANDBOX_ONLY	400
UNKNOWN_FIELD	Unknown Plaid Auth error code: UNKNOWN_FIELD	Plaid Error	Plaid docs for UNKNOWN_FIELD	400
LAST_UPDATED_DATETIME_OUT_OF_RANGE	Unknown Plaid Auth error code: LAST_UPDATED_DATETIME_OUT_OF_RANGE	Plaid Error	Plaid docs for LAST_UPDATED_DATETIME_OUT_OF_RANGE	400
PLAID_DIRECT_ITEM_IMPORT_RETURNED_INVALID_MFA	Unknown Plaid Auth error code: PLAID_DIRECT_ITEM_IMPORT_RETURNED_INVALID_MFA	Plaid Error	Plaid docs for PLAID_DIRECT_ITEM_IMPORT_RETURNED_INVALID_MFA	400
ACCOUNTS_LIMIT	Unknown Plaid Auth error code: ACCOUNTS_LIMIT	Plaid Rate Limit	Plaid docs for ACCOUNTS_LIMIT	400
ADDITION_LIMIT	Unknown Plaid Auth error code: ADDITION_LIMIT	Plaid Rate Limit	Plaid docs for ADDITION_LIMIT	400
AUTH_LIMIT	Unknown Plaid Auth error code: AUTH_LIMIT	Plaid Rate Limit	Plaid docs for AUTH_LIMIT	400
BALANCE_LIMIT	Unknown Plaid Auth error code: BALANCE_LIMIT	Plaid Rate Limit	Plaid docs for BALANCE_LIMIT	400
IDENTITY_LIMIT	Unknown Plaid Auth error code: IDENTITY_LIMIT	Plaid Rate Limit	Plaid docs for IDENTITY_LIMIT	400
INSTITUTIONS_GET_LIMIT	Unknown Plaid Auth error code: INSTITUTIONS_GET_LIMIT	Plaid Rate Limit	Plaid docs for INSTITUTIONS_GET_LIMIT	400
INSTITUTIONS_GET_BY_ID_LIMIT	Unknown Plaid Auth error code: INSTITUTIONS_GET_BY_ID_LIMIT	Plaid Rate Limit	Plaid docs for INSTITUTIONS_GET_BY_ID_LIMIT	400
INVESTMENT_HOLDINGS_GET_LIMIT	Unknown Plaid Auth error code: INVESTMENT_HOLDINGS_GET_LIMIT	Plaid Rate Limit	Plaid docs for INVESTMENT_HOLDINGS_GET_LIMIT	400
INVESTMENT_TRANSACTIONS_LIMIT	Unknown Plaid Auth error code: INVESTMENT_TRANSACTIONS_LIMIT	Plaid Rate Limit	Plaid docs for INVESTMENT_TRANSACTIONS_LIMIT	400
ITEM_GET_LIMIT	Unknown Plaid Auth error code: ITEM_GET_LIMIT	Plaid Rate Limit	Plaid docs for ITEM_GET_LIMIT	400
RATE_LIMIT	Unknown Plaid Auth error code: RATE_LIMIT	Plaid Rate Limit	Plaid docs for RATE_LIMIT	400
TRANSACTIONS_LIMIT	Unknown Plaid Auth error code: TRANSACTIONS_LIMIT	Plaid Rate Limit	Plaid docs for TRANSACTIONS_LIMIT	400
INCORRECT_OAUTH_NONCE	Unknown Plaid Auth error code: INCORRECT_OAUTH_NONCE	Plaid Error	Plaid docs for INCORRECT_OAUTH_NONCE	400
INCORRECT_LINK_TOKEN	Unknown Plaid Auth error code: INCORRECT_LINK_TOKEN	Plaid Error	Plaid docs for INCORRECT_LINK_TOKEN	400
OAUTH_STATE_ID_ALREADY_PROCESSED	Unknown Plaid Auth error code: OAUTH_STATE_ID_ALREADY_PROCESSED	Plaid Error	Plaid docs for OAUTH_STATE_ID_ALREADY_PROCESSED	400
OAUTH_STATE_ID_NOT_FOUND	Unknown Plaid Auth error code: OAUTH_STATE_ID_NOT_FOUND	Plaid Error	Plaid docs for OAUTH_STATE_ID_NOT_FOUND	400
MICRODEPOSITS_UNSUPPORRTED_ENVIRONMENT	Unknown Plaid Auth error code: MICRODEPOSITS_UNSUPPORRTED_ENVIRONMENT	Plaid Error	Plaid docs for MICRODEPOSITS_UNSUPPORRTED_ENVIRONMENT	400
SANDBOX_PRODUCT_NOT_ENABLED	Unknown Plaid Auth error code: SANDBOX_PRODUCT_NOT_ENABLED	Plaid Error	Plaid docs for SANDBOX_PRODUCT_NOT_ENABLED	400
SANDBOX_WEBHOOK_INVALID	Unknown Plaid Auth error code: SANDBOX_WEBHOOK_INVALID	Plaid Error	Plaid docs for SANDBOX_WEBHOOK_INVALID	400
SANDBOX_ACCOUNT_SELECT_V2_NOT_ENABLED	Unknown Plaid Auth error code: SANDBOX_ACCOUNT_SELECT_V2_NOT_ENABLED	Plaid Error	Plaid docs for SANDBOX_ACCOUNT_SELECT_V2_NOT_ENABLED	400
SANDBOX_TRANSFER_EVENT_TRANSITION_INVALID	Unknown Plaid Auth error code: SANDBOX_TRANSFER_EVENT_TRANSITION_INVALID	Plaid Error	Plaid docs for SANDBOX_TRANSFER_EVENT_TRANSITION_INVALID	400

🚧Under Construction

Link Account

🚧
Under Construction