Watch list

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

MethodPathPurpose
POST/sharing/v1/watch-list/searchList watched IBANs, or search for one.
POST/sharing/v1/watch-listAdd one or more IBANs (up to 500).
DELETE/sharing/v1/watch-listRemove 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.

🚧

Conflicts

Adding an IBAN already in the watch list returns 409.
Deleting an IBAN that isn't in the list returns 404.