IBAN lists are your institution's private lists of IBANs. They are not shared with the ecosystem — they tune how Qombo handles specific accounts for you.
There are three lists, each with its own purpose:
| List | Purpose | Page |
|---|---|---|
| Whitelist | IBANs you trust. Drives automatic rejected qualification of related alerts. | Whitelist |
| Blacklist | IBANs you know to be fraudulent. Drives automatic fraud qualification of related alerts. | Blacklist |
| Watch list | IBANs you want to monitor. You are notified when a new alert or qualification change happens on them. | Watch list |
Shared shape
All three lists follow the same pattern, so once you integrate one you integrate them all:
| Action | Method & path |
|---|---|
| Search / list entries | POST /sharing/v1/{list}/search |
| Add entries | POST /sharing/v1/{list} |
| Remove entries | DELETE /sharing/v1/{list} |
- Search returns all entries when you send an empty body, or filters to a specific IBAN.
- Add and Remove accept a batch of up to 500 IBANs per request.
Whitelist vs Blacklist qualificationsWhen adding to the whitelist or blacklist you also choose a qualification that Qombo auto-applies. The watch list carries no qualification — it only tracks the IBAN. See each list's page for the allowed values.