FAB Bank Directory Plus File
The table below contains definitions and examples of the SWIFT Bank Directory Plus fields used. The fields returned in the Find-a-Bank (FAB) response may differ to the field names below, to suit the API resource model.
| Field Name | Description | Always Present? | Format |
|---|---|---|---|
| MODIFICATION FLAG | Modification flag in delta files. A = addition, M = modification, D = deletion (full files only). | Yes | string(1) |
| RECORD KEY | Unique key of the record in the file. | Yes | string(12) |
| OFFICE TYPE | Identifies office type: HO = Head Office, DB = Domestic branch/department, SB = Sub‑domestic branch, FB = Foreign branch, SF = Sub‑foreign branch, UC = Unclassified. | Yes | string(2) |
| PARENT OFFICE KEY | Record key of the closest parent entity in the hierarchy (e.g., HO for DB, FB for SF). | Yes | string(12) |
| HEAD OFFICE KEY | Record key of the Head Office (HO) in the entity hierarchy. | Yes | string(12) |
| LEGAL TYPE | Indicates legal hierarchy status: L = Legal entity, B = Business entity, U = Unknown. | Yes | string(1) |
| LEGAL PARENT KEY | Legal hierarchy key (often the same as the record key). Not maintained in Bank Directory Plus. | Yes | string(12) |
| GROUP TYPE | Entity group role from SWIFT hierarchy: Parent or Member. | No | string(6) |
| GROUP PARENT KEY | Record key of the parent entity in the SWIFT traffic hierarchy. | No | string(12) |
| INSTITUTION STATUS | License or institution type (e.g., BANK, COOP, CBMA, INVM, PYMI, OTHR). | No | string(4) |
| COOPERATIVE GROUP KEY | Record key of cooperative central bank if entity belongs to a cooperative group. | No | string(12) |
| ISO LEI CODE | Legal Entity Identifier (ISO 17442) for entities with a BIC. | No | string(20) |
| BIC8 | 8‑character BIC identifying party prefix, country code, and suffix. | No | string(8) |
| BRANCH BIC | 3‑character branch identifier associated with the BIC8; defaults to 00 if unavailable. | No | string(3) |
| BIC | Full 11‑character BIC including branch identifier (XXX for main office). | No | string(11) |
| CHIPS UID | CHIPS universal identifier for the institution. | No | string(6) |
| NATIONAL ID | National identifier of the institution or branch. | No | string(15) |
| CONNECTED BIC | Connected BIC used when the institution is not directly connected to SWIFT. | No | string(11) |
| INSTITUTION NAME | Official trading name of the institution. | Yes | string(105) |
| BRANCH INFORMATION | Branch information derived from BIC Directory or National ID linkage. | No | string(70) |
| POB NUMBER | Post office box and ZIP code, comma‑separated. | No | string(35) |
| STREET ADDRESS | Street and building details (up to four sub‑fields, country‑specific order). | No | string(35) |
| CITY | City of the institution or branch. | No | string(35) |
| CPS | County, province, state, or administrative region. | No | string(90) |
| ZIP CODE | Postal or ZIP code of the institution or branch. | No | string(15) |
| COUNTRY NAME | Country name as defined by ISO 3166. | Yes | string(70) |
| ISO COUNTRY CODE | ISO 3166‑1 alpha‑2 country code. | Yes | string(2) |
| TIMEZONE | Business party suffix or timezone indicator. | No | string(1) |
| SUBTYPE INFORMATION | Business subtype for entities with a BIC. | No | string(4) |
| NETWORK CONNECTIVITY | SWIFT network connectivity status (BIC records only). | No | string(3) |
| BRANCH QUALIFIERS | Operational qualifiers (up to six three‑character values). | No | string(35) |
| SERVICE CODES | SWIFT FIN service (value‑added) codes for BIC records. | No | string(60) |
| SSI GROUP KEY | Identifies the SSI Group for SSI Plus files. | No | string(12) |
| IBAN KEY | Record key linking to IBANPLUS.txt for IBAN data. | No | string(12) |
| FIELD A | Future valid‑from date of the record in YYYYMMDD format (if applicable). | No | string(70) |
| FIELD B | National ID Type and provider information, including alternative (/AN) and foreign (/FN) indicators. | No | string(70) |
Updated 11 days ago