Troubleshooting
The most common Data API issues and where to look first.
Most Data API issues fall into a few categories. Start with the guide that matches your symptom.
| Symptom | Start here |
|---|---|
| Users can't complete the connection flow (no OTP) | Fix OTP failures during the consent flow |
| "Auth session is terminal" error from the Link SDK | Resolve the "auth session is terminal" error |
| No webhook after a user attempted to connect | Why no webhooks arrive after an abandoned flow |
| Data missing or stale for many users at one institution | Handle institution outages and sync delays |
| Identity data missing or has multiple entries | Work with identity data |
| Questions about storing and deleting consumer data | Meet your data retention obligations |
Before digging in, two quick checks resolve a lot of cases:
- Check the Institution Status page for incidents or scheduled outages at the institution.
- Confirm the user's consent is active and hasn't expired or been revoked.
If you're still stuck, contact Fiskil support with the end user ID, consent ID, institution, and a timestamp of the issue. For API details, see docs.fiskil.com.