# 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:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| [BICFI](/products/payments-odl/api-docs/ripplenet/resources/srpo/supporting-info-definitions/bic) | String | Optional | Code 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` |
| [Nm](/products/payments-odl/api-docs/ripplenet/resources/srpo/supporting-info-definitions/fullname) | String | Optional | Name by which the party is known and which is usually used to identify the party. Defined in `#/definitions/fullname` |
| [ClrSysMmbId](#clrsysmmbid) | Object | Optional | Information used to identify a member within a clearing system. |
| [PstlAdr](/products/payments-odl/api-docs/ripplenet/resources/srpo/supporting-info-definitions/address) | String | Optional | Address for the party or organization. Defined in `#/definitions/address` |
| [Othr](#othr) | Object | Optional | Unique 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:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Mmbid` | String | Optional | Contains the routing code or sort code for the institution. Maximum length: 35 characters |
| [ClrSysId](#clrsysid) | Object | Optional | Information used to identify a member within a clearing system. |


### `ClrSysId`

Information used to identify a member within a clearing system.

With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| [Cd](/products/payments-odl/api-docs/ripplenet/resources/srpo/supporting-info-definitions/externalclearingsystem#known-values) | String | Optional | List based on ISO20022 ExternalClearingSystemIdentification1Code List [29-May-2020](https://www.iso20022.org/sites/default/files/2020-08/ExternalCodeSets_2Q2020_August2020_v1.xlsx). Defined in `#/definitions/externalclearingsystem` |
| `Prtry` | String | Optional | Field 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:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Id` | String | Optional | Unique and unambiguous identification of a person. |
| [SchmeNm](#schmenm) | String | Optional | Name of the agent identification scheme. |
| `Issr` | String | Optional | Entity that assigns the identification. Maximum length: 35 characters |


### `SchmeNm`

Name of the agent identification scheme.

With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| [Cd](/products/payments-odl/api-docs/ripplenet/resources/srpo/supporting-info-definitions/externalclearingsystem#known-values) | String | Optional | Based on list for ExternalFinancialInstitution1Code defined by ISO 20022. Currently no codes defined. |
| `Prtry` | String | Optional | Field to support proprietary value. Maximum length: 35 characters |


## JSON schema extract


```json
"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
                }
            }
        }
    }
}
```