The table below contains definitions and examples of the SWIFT Bank Directory Plus fields used. The fields returned in the FAB response may differ than the field names below to suit the API resource model.
Modification flag in delta files
Unique key of the record in the file
HO - Head Office
PARENT OFFICE KEY
Indicates RECORD KEY OF closest entity upwards in the entities hierarchy.
Ex. "HO" RECORD KEY if the entity is "DB", or the "FB" RECORD KEY if "SF"
HEAD OFFICE KEY
Indicates RECORD KEY of the "HO - Head Office" in the entities hierarchy
Indicates the status of the entity in the legal hierarchy
LEGAL PARENT KEY
Legal hierarchy included in Entity Plus product. This data is not maintained in the Bank Directory Plus, and is often same as the record key
Type of entity identifying group:
This data comes from the SWIFT back office. Parent BIC is the BIC at the top of the SWIFT traffic hierarchy. This can be different than the legal ultimate parent that is available in Entity Plus
GROUP PARENT KEY
Record key of parent entity. Identifies set of entity records belonging to that group. Groups BICs and National ID records that belong to the same parent BIC
Indicates license status of the institution, if any:
COOPERATIVE GROUP KEY
If the record indicates a cooperative bank which belongs to a cooperative bank grouping, then this field indicates the RECORD KEY of the cooperative central bank for that group. Hierarchy in this case flows downward.
In the case of any such cooperative central bank, the value here is its own RECORD KEY. If the cooperative bank does not belong to a bank grouping, then field is empty.
ISO LEI CODE
ISO 17442 defines this Legal Entity Identifier (LEI). Provided for entities that also have a BIC. The full list of LEIs can be found in the Reach Plus directory.
BIC <party prefix, country, party suffix> where
BIC branch identifier associated with the 8-character BIC. If no ID exists, then 00 is used
Unique BIC related to the institution from the BIC Directory 2018. Consists of:
CHIPS universal ID related to the institution
National identifier of the institution or branch
For a BIC not connected to the SWIFT network. This is the connected BIC of the institution or of its correspondents through which it connects.
Institution trading name
Derived from BIC Directory 2018. If blank in the directory and respective BIC is linked to a National ID where branch information is available, then it will be populated in the file
Comma-separated field with POB number of the institution/branch and related ZIP code. Allows customer to use full POB address
Four sub-fields provide the building name, detailed building information, street name, and number. Order of this information depends on accepted practices for the particular country.
City of institution/branch
County, province, state, or other administrative region of the owner institution/branch
Zip code of the institution/branch
Country name of the institution/branch is indicated in ISO 3166
ISO COUNTRY CODE
ISO 3166-1 alpha-2 code of the country of the institution/branch
Business party suffix information
Business type of the entity. Subtype indicator is provided only for records with a BIC
Status of an entity's connection to SWIFT. Network connectivity is provided only for records containing a BIC
Operational type of the entity. Branch qualifiers are provided only for records containing a BIC. Field can contain up to 6 three-character branch qualifiers in alphabetical order.
SWIFT FIN service codes (also called value-added service codes). Provided only for records containing a BIC. Can contain up to 20 three-character codes in alphabetical order
SSI GROUP KEY
Indicates which SSI Group the entity belongs to in the SSI Plus files
Identifies the RECORD KEY in the IBANPLUS.txt file that contains the IBAN data for this entity
Contains future valid-from date of the whole record due to a change in its attributes in YYYYMMDD. Field is empty in the case record is valid at the date specified in the file name (publication date)
National ID Type - name of the national code or name of the national code provider
National ID Type + /AN - AN stands for Alternative National ID Type. The banks/branches in a country can own National IDs issued by multiple authorities
National ID Type + /FN - FN stands for Foreign National ID Type. In some countries, banks have a National code issued by a foreign payment clearing service, such as a German bank that has a Swiss BC, indicated by BC/FN