Troubleshooting Transactions
API error responses
If the problem you're encountering involves an API error message, see Errors for troubleshooting suggestions.
No transactions or cursor returned
When calling /transactions/sync
, a response with no cursor or transactions data is returned.
Common causes
- This is expected behavior when the Item has recently been initialized with
transactions
and Plaid has not yet completed fetching of transactions data.
Troubleshooting steps
Missing transactions
Common causes
The institution is experiencing an error.
Processing of the transactions has been delayed.
The Item is not in a healthy state.
The transaction is not available on the institution's online banking portal, or appears differently on the online banking portal.
Troubleshooting steps
If the steps above do not resolve the issue, file a ticket with Plaid support.
Incorrect data fields
In some cases, information about a merchant, such as its name or category, may be incorrect.
Troubleshooting steps
If the issue is not resolved, or if the category information is incorrect, file a ticket with Plaid support indicating which fields are incorrect, the correct data, and the transaction_id
of the affected transaction.
Limited transaction history is returned
Common causes
By default, Plaid will only return 90 days of transaction history for all Plaid developer accounts created after December 3, 2023. To request more transaction history, specify the
days_requested
field when initializing with Transactions. Note that this field will only take effect when Transactions is added to an Item for the first time; if you need more than 90 days of transactions history for an Item that has already been initialized with Transactions for 90 days of history, you will need to delete the Item and create a new one.The user's institution may provide limited transaction history. For example, Capital One provides only 90 days of transaction history and does not provide pending transactions.
Troubleshooting steps
Specify
days_requested
when calling/link/token/create
or (if not initializing with Transactions during Link) when calling/transactions/sync
or/transactions/get
for the first time on an Item.Verify that the issue is not specific to a particular institution. For details of history available at certain major institutions, see the OAuth guide PDF available from the Dashboard.