Link Account Errors

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


What’s Next

Return to Error Handling cover page.

Did this page help you?