Skip to content

financial_institution

Unique and unambiguous identification of a financial institution, as assigned under an internationally recognized or proprietary identification scheme.

  • Is optional
  • Type: object

With the following properties:

PropertyTypeRequiredDescription
BICFIStringOptionalCode allocated to a receiving institution by the ISO 9362 Registration Authority as described in ISO 9362 "Banking - Banking telecommunication messages - Business identifier code (BIC)". Defined in #/definitions/bic
NmStringOptionalName by which the party is known and which is usually used to identify the party. Defined in #/definitions/fullname
ClrSysMmbIdObjectOptionalInformation used to identify a member within a clearing system.
PstlAdrStringOptionalAddress for the party or organization. Defined in #/definitions/address
OthrObjectOptionalUnique identification of an agent, as assigned by an institution, using an identification scheme.

ClrSysMmbId

Contains the routing code or sort code for the institution.

With the following properties:

PropertyTypeRequiredDescription
MmbidStringOptionalContains the routing code or sort code for the institution. Maximum length: 35 characters
ClrSysIdObjectOptionalInformation used to identify a member within a clearing system.

ClrSysId

Information used to identify a member within a clearing system.

With the following properties:

PropertyTypeRequiredDescription
CdStringOptionalList based on ISO20022 ExternalClearingSystemIdentification1Code List 29-May-2020. Defined in #/definitions/externalclearingsystem
PrtryStringOptionalField to support proprietary value. Maximum length: 35 characters

Othr

Unique identification of an agent, as assigned by an institution, using an identification scheme.

With the following properties:

PropertyTypeRequiredDescription
IdStringOptionalUnique and unambiguous identification of a person.
SchmeNmStringOptionalName of the agent identification scheme.
IssrStringOptionalEntity that assigns the identification. Maximum length: 35 characters

SchmeNm

Name of the agent identification scheme.

With the following properties:

PropertyTypeRequiredDescription
CdStringOptionalBased on list for ExternalFinancialInstitution1Code defined by ISO 20022. Currently no codes defined.
PrtryStringOptionalField to support proprietary value. Maximum length: 35 characters

JSON schema extract

"financial_institution": {
    "type": "object",
    "description": "Unique and unambiguous identification of a financial institution, as assigned under an internationally recognised or proprietary identification scheme.",
    "properties": {
        "BICFI": {
            "$ref": "#/definitions/bic"
        },
        "Nm": {
            "$ref": "#/definitions/fullname"
        },
        "ClrSysMmbId": {
            "type": "object",
            "description": "Information used to identify a member within a clearing system.",
            "properties": {
                "MmbId": {
                    "description": "Contains the routing code / sort code for the institution",
                    "type": "string",
                    "maxLength": 35
                },
                "ClrSysId": {
                    "type": "object",
                    "description": "Information used to identify a member within a clearing system.",
                    "properties": {
                        "Cd": {
                            "$ref": "#/definitions/externalclearingsystem"
                        },
                        "Prtry": {
                            "type": "string",
                            "description": "Field to support proprietary value",
                            "maxLength": 35
                        }
                    }
                }
            }
        },
        "PstlAdr": {
            "$ref": "#/definitions/address"
        },
        "Othr": {
            "type": "object",
            "description": "Unique identification of an agent, as assigned by an institution, using an identification scheme.",
            "properties": {
                "Id": {
                    "type": "string",
                    "description": "Unique and unambiguous identification of a person."
                },
                "SchmeNm": {
                    "type": "object",
                    "description": "Name of the agent identification scheme.",
                    "properties": {
                        "Cd": {
                            "type": "string",
                            "description": "Based on list for externalfinancialinstitution1code defined by ISO 20022"
                        },
                        "Prtry": {
                            "type": "string",
                            "description": "Field to support proprietary value",
                            "maxLength": 35
                        }
                    }
                },
                "Issr": {
                    "type": "string",
                    "description": "Entity that assigns the identification.",
                    "maxLength": 35
                }
            }
        }
    }
}