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 |
Updated 10 months ago