Dashboard logs and troubleshooting

Logging and troubleshooting information available via the Activity Log in the Plaid dashboard

Logs for webhooks, Link, and API requests

The Plaid dashboard Activity Log shows the past 14 days of API activity. Using the dashboard, you can see a record of all requests and responses, as well as all webhooks sent by the Plaid API, and all Link events. Note that viewing Link events in the dashboard requires the use of Link tokens; implementations using the legacy public_token will not display Link events in the dashboard.

You can view the details of any request, response, webhook, or event, and view error information for any failed API request.

Logs for Payment Initiation and Bank Transfers

The Payment Initiation (UK and Europe, beta) and Bank Transfers (beta) products also have their own logs in the Plaid dashboard. If you are enabled for these products, links to view activity will appear in the Activity menu within the dashboard. Using these logs, you can view the status and history of payment and transfer attempts. This information is also available via the API; for more details, see the API documentation for Payment Initiation and Bank Transfers.

Troubleshooting institution status

The Plaid dashboard contains an Institution Status pane, which allows you to view details and stats about institution connectivity, as well as any recent downtime or special notes about the institution. You can also use this view to search institutions to see whether they are supported by Plaid and which Plaid products can be used with them. This information is also available via the API; for more information on programmatically retrieving institution status, see Institutions API endpoints.

The time range used for calculating institution status may range from the most recent few minutes to the past six hours. In general, smaller institutions will show status that was calculated over a longer period of time. For Investment updates, which are refreshed less frequently, the period assessed may be 24 hours or more.

Plaid displays both Item add success rates (success adding new Items) and Item update success rates (success refreshing data for existing Items). The success rate as shown on the main status page is the Item add success rate.

All success rates reflect the percentage of successful attempts to retrieve data. Both Plaid errors and institution errors are combined when calculating the percentage of unsuccessful attempts. User errors, such as an Item add failing due to an incorrect password entered during Link, are not considered when calculating success rates.

All success rates are rounded down to the nearest percentage point. A success rate of 99% or higher indicates that the institution is considered healthy.

Insufficient data and delayed data

If the institution has not had enough Plaid traffic during the window being evaluated to produce meaningful health data, the "Insufficient Data" message will be displayed. This is most likely to affect small institutions. If this occurs, try using the Item Debugger instead to diagnose the problem.

If Plaid has not been able to update data from the institution for over two days, the institution status may appear as "delayed". If it has been at least two weeks since the last successful institution update, or if Plaid is aware of a problem in updating data that is likely to take over two weeks to resolve, the institution status will appear as "stopped".