Look up a bank by routing number or SWIFT/BIC
Autocompletes the beneficiary bank from an embedded public bank directory — pass exactly one of routing_number (9 digits, US only) or swift (8 or 11 characters; an XXX suffix is normalized to the head office). Use it to autodetect the bank while the sender types the routing number or SWIFT/BIC in payout or counterparty forms: a 404 means “not in the directory” and the form should simply stay manual. Static data served with Cache-Control: public, max-age=86400; safe to cache for a day.
Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Query Parameters
ABA routing number, 9 digits with a valid check digit (US banks only). Mutually exclusive with swift.
^[0-9]{9}$SWIFT/BIC code, 8 or 11 characters (an XXX suffix is normalized to the head office). Mutually exclusive with routing_number.
^[A-Za-z0-9]{8}([A-Za-z0-9]{3})?$Optional ISO 3166-1 alpha-2 filter for routing lookups; only US is supported (any other value returns 400 invalid_country).
^[A-Z]{2}$Response
Bank found in the directory. bank_phone and directory_vintage are only present for routing lookups; bank_state/bank_branch only when the dataset has them.
The response is of type object.