Dashboard logs and troubleshooting
Discover logging and troubleshooting information available 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 Transfer
The Payment Initiation (UK and Europe, beta) and Transfer (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 Transfer.
Troubleshooting institution status
The Plaid dashboard contains an Institution Status pane, which allows you to view details and stats about institution connectivity over the past two weeks, 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. Most of this information is also available via the API; for more information on programmatically retrieving institution status, see Institutions API endpoints.
Institution status details
The graph at the top of the page shows institution status over the past two weeks, while the boxes below the graph show the current institution status. The time range used for calculating the current 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".
If you have at least 25 Transactions-enabled Items associated with a given institution, the Institution Status page will also show a Data Freshness display, including a total Item count and a percentage breakdown of when the Items were last updated within certain time intervals. Note that this information is specific to Transactions and is calculated based on your own users' Items, not global Plaid Item statistics.