Bank Directory Plus File

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.

Field Name

Description

Always Present?

Format

MODIFICATION FLAG

Modification flag in delta files
A - addition
M - modification
D - deletion in full files

Yes

string(1)

RECORD KEY

Unique key of the record in the file

Yes

string(12)

OFFICE TYPE

HO - Head Office
-DB - Domestic branch or department
-SB - Sub-domestic branch
-FB - Foreign branch
-SF - Sub-foreign branch
UC - Unclassified

Yes

string(2)

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"

Yes

string(12)

HEAD OFFICE KEY

Indicates RECORD KEY of the "HO - Head Office" in the entities hierarchy

Yes

string(12)

LEGAL TYPE

Indicates the status of the entity in the legal hierarchy
L - Legal entity
B - Business entity
U - Unknown

Yes

string(1)

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

Yes

string(12)

GROUP TYPE

Type of entity identifying group:
-Parent
-Member

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

No

string(6)

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

No

string(12)

INSTITUTION STATUS

Indicates license status of the institution, if any:
BANK - Universal Bank
COOP - Cooperative Bank
CBMA - Central Bank/Monetary Authority
ASSM - Asset Manager
CORP - Corporates
CRUN - Credit Union
ICSD - International Central Securities Depository
INVM - Investment Bank
MONX - Money Exchange
NPAA - National Payment Association
PYMI - Payments Institution
SLBH - Savings-lending Bank Housing
SUFI - Supervised Financial Institution
XCHG - Exchange
OTHR - Other

No

string(4)

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.

No

string(12)

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.

No

string(20)

BIC8

BIC <party prefix, country, party suffix> where
-Party prefix - 4 characters
-Country code - 2 characters
-Party suffix - 2 characters

No

string(8)

BRANCH BIC

BIC branch identifier associated with the 8-character BIC. If no ID exists, then 00 is used

No

string(3)

BIC

Unique BIC related to the institution from the BIC Directory 2018. Consists of:
-Party prefix - 4 characters
-Country code - 2 characters
-Party suffix - 2 characters
-Branch identifier - 3 characters, XXX for main office

No

string(11)

CHIPS UID

CHIPS universal ID related to the institution

No

string(6)

NATIONAL ID

National identifier of the institution or branch

No

string(15)

CONNECTED BIC

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.

No

string(11)

INSTITUTION NAME

Institution trading name

Yes

string(105)

BRANCH INFORMATION

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

No

string(70)

POB NUMBER

Comma-separated field with POB number of the institution/branch and related ZIP code. Allows customer to use full POB address

No

string(35)

STREET 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.

No

string(35)

CITY

City of institution/branch

No

string(35)

CPS

County, province, state, or other administrative region of the owner institution/branch

No

string(90)

ZIP CODE

Zip code of the institution/branch

No

string(15)

COUNTRY NAME

Country name of the institution/branch is indicated in ISO 3166

Yes

string(70)

ISO COUNTRY CODE

ISO 3166-1 alpha-2 code of the country of the institution/branch

Yes

string(2)

TIMEZONE

Business party suffix information

No

string(1)

SUBTYPE INFORMATION

Business type of the entity. Subtype indicator is provided only for records with a BIC

No

string(4)

NETWORK CONNECTIVITY

Status of an entity's connection to SWIFT. Network connectivity is provided only for records containing a BIC

No

string(3)

BRANCH QUALIFIERS

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.

No

string(35)

SERVICE CODES

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

No

string(60)

SSI GROUP KEY

Indicates which SSI Group the entity belongs to in the SSI Plus files

No

string(12)

IBAN KEY

Identifies the RECORD KEY in the IBANPLUS.txt file that contains the IBAN data for this entity

No

string(12)

FIELD A

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)

No

string(70)

FIELD B

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

No

string(70)