Transactions errors

Guide to troubleshooting Transactions errors

TRANSACTIONS_SYNC_MUTATION_DURING_PAGINATION

Transaction data was updated during pagination.

Common causes

Transaction data was updated during pagination. This can occur when calling the /transactions/sync endpoint.

Restart the pagination loop beginning at the original cursor value used for the first request in the pagination loop. Note that the entire loop must be restarted, beginning with the first request whose response included a true value for has_more. If you attempt to re-run only the requests using the cursor value where this error was encountered, without restarting the entire loop, the error will recur. The request loop must be run until has_more is false.

To reduce the frequency of this error, you can increase the count parameter in the /transactions/sync from the default value of 100 to a higher value, such as the maximum of 500, which will reduce the number of pages in the API response.

API error response

http code 400
{
 "error_type": "TRANSACTIONS_ERROR",
 "error_code": "TRANSACTIONS_SYNC_MUTATION_DURING_PAGINATION",
 "error_message": "Underlying transaction data changed since last page was fetched. Please restart pagination from last update.",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}

TRANSACTIONS_SYNC_ITEM_LIMIT_EXCEEDED

The Item has an excessively large transaction history and exceeds the size limit for starting or restarting Transactions Sync.

Common causes

Calling /transactions/sync or /processor/transactions/sync without a cursor for an Item with an excessively large transaction history.

Troubleshooting steps

Do not automatically retry the failed request or restart pagination from an empty cursor. Reducing the count parameter does not resolve this error.

If your integration has a previously saved cursor for this Item, preserve it and continue syncing from that cursor.

If you need to retrieve transactions without an existing cursor, use /transactions/get or /processor/transactions/get, as applicable.

API error response

http code 400
{
 "error_type": "TRANSACTIONS_ERROR",
 "error_code": "TRANSACTIONS_SYNC_ITEM_LIMIT_EXCEEDED",
 "error_message": "This Item has too many transactions for Transactions Sync to return updates. Do not retry or restart pagination for this Item. Use /transactions/get (or /processor/transactions/get for processor integrations) to retrieve transactions instead, or contact Plaid Support for assistance.",
 "display_message": null,
 "request_id": "HNTDNrA8F1shFEW"
}