按 routing number 或 SWIFT/BIC 查询银行
按 routing number 或 SWIFT/BIC 查询银行
从嵌入式公开银行目录自动补全收款银行——routing_number(9 位数字,仅限美国)与 swift(8 或 11 个字符;XXX 后缀会归一化为总行)二者必传其一。用于在付款人在 payout 或交易对手表单中输入 routing number 或 SWIFT/BIC 时自动识别银行:返回 404 表示”不在目录中”, 表单保持手动填写即可。静态数据以 Cache-Control: public, max-age=86400 提供,可安全缓存一天。
GET
按 routing number 或 SWIFT/BIC 查询银行
授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
查询参数
ABA routing number,9 位数字且校验位有效(仅限美国银行)。与 swift 互斥。
Pattern:
^[0-9]{9}$SWIFT/BIC 代码,8 或 11 个字符(XXX 后缀会归一化为总行)。与 routing_number 互斥。
Pattern:
^[A-Za-z0-9]{8}([A-Za-z0-9]{3})?$可选的 ISO 3166-1 alpha-2 过滤条件,用于 routing 查询;仅支持 US(其他值返回 400 invalid_country)。
Pattern:
^[A-Z]{2}$响应
在目录中找到银行。bank_phone 和 directory_vintage 仅在 routing 查询时出现;bank_state/bank_branch 仅在数据集包含时出现。
The response is of type object.
最后修改于 2026年8月22日