Be notified when an event happen on your monitored IBANs.
The watch list holds IBANs you want to monitor. Unlike the whitelist and blacklist, it carries no qualification — adding an IBAN here means "tell me when something happens on it." You are notified when a new alert is created or an existing alert's qualification changes for a watched IBAN.
This is one of the three IBAN lists.
Endpoints
| Method | Path | Purpose |
|---|---|---|
POST | /sharing/v1/watch-list/search | List watched IBANs, or search for one. |
POST | /sharing/v1/watch-list | Add one or more IBANs (up to 500). |
DELETE | /sharing/v1/watch-list | Remove one or more IBANs. |
Adding entries
Each entry is just an { iban }. No qualification is needed.
You can also populate the watch list automatically: pass addToWatchList: true when calling Verify, and the checked IBAN is added for you.
Searching
Send an empty body to list every entry, or pass an iban to look up a single one. Each result returns the iban, its firstSeenAt date, and the lastSeenAt date it was most recently seen.
ConflictsAdding an IBAN already in the watch list returns
409.
Deleting an IBAN that isn't in the list returns404.
