# id_section

Unique and unambiguous way to identify an individual or organization.

* Is optional
* Type: `object`


With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| [OrgId](#orgid) | Object | Optional | Unique and unambiguous way to identify an individual or organization. |
| [PrvtId](#prvtid) | Object | Optional | Unique and unambiguous identification of a person, eg, passport. |


## `OrgId`

Unique and unambiguous way to identify an individual or organization.

* Is optional
* Type: `object`


With the following properties:

| Property | Type | Required | Description | Definition Source |
|  --- | --- | --- | --- | --- |
| [AnyBIC](/products/payments-odl/api-docs/ripplenet/resources/srpo/supporting-info-definitions/bic) | Object | 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)" | `#/definitions/bic` |
| [DtAndPlcofIncorprtn](#dtandplcofincorprtn) | Object | Optional | Indicates the organization's date and place of incorporation. | `DtAndPlcofIncorprtn` |
| [Othr](#othr) | Array | Optional | An array of objects, each containing unique identification of an organization, as assigned by an institution, using an identification scheme. | `Othr` |
| [RelShipToDbtr](#relshiptodbtr-known-values) | String | Optional | Indicates the relationship between the Sender and Receiver. | `RelShipToDbtr` |
| [RelShipToCdtr](#relshiptocdtr-known-values) | String | Optional | Indicates the relationship between the Sender and Receiver. | `RelShipToCdtr` |
| [Rprtv](#rprtv) | Object | Optional | Indicates the name of the organization's representative. | `Rprtv` |


### `DtAndPlcofIncorprtn`

Indicates the organization's date and place of incorporation.

* Is optional
* Type: `object`


With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `DtofIncorprtn` | String | Optional | The date of incorporation for the organization. Format: `date-time`. This is classified as a 'soft' field. |
| `CtryofIncorprtn` | String | Optional | Information that locates and identifies the country, as defined by postal services where the organization was incorporated. Use Alpha-2 Code as defined in the ISO CountryCode ISO 3166-1 list. Pattern: `^[A-Z]{2}$` |


### `Othr`

An array of objects, each containing unique identification of an organization, as assigned by an institution, using an identification scheme.

* Is optional
* Type: `array`


With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Id` | String | Optional | Identification assigned by an institution. Maximum length: 35 characters |
| `Issr` | String | Optional | Entity that assigns the identification. Maximum length: 35 characters |
| `DtOfIss` | String | Optional | Information that identifies the date of incorporation in ISO Date format (YYYY-MM-DD) for a sending organization or institution. Maximum length: 10 characters |
| `DtOfIsse` | String | Optional | The date of issuance of the supporting documentation. Format: `date-time`. This is classified as a 'soft' field. |
| `DtOfXpry` | String | Optional | The date of expiration of the supporting documentation. Format: `date-time`. This is classified as a 'soft' field. |
| [`SchmeNm`](#schmenm) | Object | Optional | Name of the organization identification scheme. |


#### `SchmeNm`

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Cd` | String | Optional | List based on ExternalOrganisationIdentification1Code List [27-Aug-2021](https://www.iso20022.org/sites/default/files/2021-08/ExternalCodeSets_2Q2021.xlsx), the value of this property **must** be equal to one of the [known values](#cd-known-values) below. |
| `Prtry` | String | Optional | Field to support proprietary value. Maximum length: 35 characters |


##### `Cd` known values

| Value | Description |
|  --- | --- |
| `BANK` | Bank Party Identification |
| `CBID` | Central Bank Identification Number |
| `CHID` | Clearing Identification Number |
| `CINC` | Certificate Of Incorporation Number |
| `COID` | Country Identification Code |
| `CUST` | Customer Number |
| `DUNS` | Data Universal Numbering System |
| `EMPL` | Employer Identification Number |
| `GS1G` | GS1GLN Identifier |
| `SREN` | SIREN |
| `SRET` | SIRET |
| `TXID` | Tax Identification Number |
| `USCC` | Unified Social Credit Code |




### `RelShipToDbtr` known values

Indicates the relationship between the Sender and Receiver.

| Value | Description |
|  --- | --- |
| `BRAN` | Branch or Representative Office |
| `CUST` | Customer |
| `FRAN` | Franchisee or Franchisor |
| `HOLD` | Holding Company |
| `PART` | Business Partner |
| `SUBS` | Subsidiary Company |
| `SUPP` | Supplier |


### `RelShipToCdtr` known values

Indicates the relationship between the Sender and Receiver.

| Value | Description |
|  --- | --- |
| `BRAN` | Branch or Representative Office |
| `CUST` | Customer |
| `FRAN` | Franchisee or Franchisor |
| `HOLD` | Holding Company |
| `PART` | Business Partner |
| `SUBS` | Subsidiary Company |
| `SUPP` | Supplier |


### `Rprtv`

Indicates the name of the organization's representative.

* Is optional
* Type: `object`


With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| [`StrdNm`](/products/payments-odl/api-docs/ripplenet/resources/srpo/supporting-info-definitions/name) | Object | Optional | Allows the name of the organization's representative to be held in a structured format. |


## `PrvtId`

Unique and unambiguous identification of a person. For example, a passport.

* Is optional
* Type: `object`


With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| [DtAndPlcOfBirth](#dtandplcofbirth) | Object | Optional | Date and place of birth of a person. |
| [Othr](#othr) | Array | Optional | An array of objects, each containing the unique identification of a party, as assigned by an institution, using an identification scheme. |
| [Gender](#gender) | String | Optional | Gender of the party. Supported values: `Male`, `Female`, `Other`. |
| [Profession](#profession) | String | Optional | Indicates occupation of the sending party. |
| [RelShipToDbtr](#relshiptodbtr-known-values) | String | Optional | Indicates relationship of the receiving party to the sending party. |
| [Ntlty](#ntlty) | String | Optional | Indicates country of nationality of the party. Use ISO Country Code for values. |
| [Residence](#residence) | String | Optional | Indicates country of residence of the party. Use ISO Country Code for values. |
| [Citizenship](#citizenship) | Object | Optional | Support for recording multiple values of citizenship of a party. |


### `DtAndPlcOfBirth`

With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `BirthDt` | String | Optional | Information that identifies the date of Birth in ISO Date format (`YYYY-MM-DD`) for the party. Format: `date-time`. |
| `PrvcOfBirth` | String | Optional | Information that locates and identifies the Province of birth for the party. Maximum length: 35 characters |
| `CityOfBirth` | String | Optional | Information that locates and identifies the city of birth for the party. Maximum length: 35 characters |
| `CtryOfBirth` | Reference | Optional | Information that locates and identifies the country of birth for the party, as defined by postal services. Use Alpha-2 Code as defined in the ISO CountryCode ISO 3166-1 list. Defined in `#/definitions/country`. |


### `Othr`

An array of objects, each containing the unique identification of a party, as assigned by an institution, using an identification scheme.

With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Id` | String | Optional | Value to be used to identify the party. Maximum length: 35 characters |
| `Issr` | String | Optional | Information for the Entity that assigns the identification. Maximum length: 35 characters |
| [SchmeNm](#schmenm) | Object | Optional | Name of the identification scheme used to identify an individual. |
| `DtOfIss` | String | Optional | Date of Issue for Passport. Format: `date-time`. This is classified as a 'soft' field. |
| `DtOfExpr` | String | Optional | Date of Expiry for Passport. Format: `date-time`.This is classified as a 'soft' field. |
| `MrzNb` | String | Optional | Machine-Readable Zone for Passport. Maximum length: 88 characters. Pattern: `/([A-Z])([A-Z0-9<])([A-Z]{3})([A-Z<]{39})\n([A-Z0-9<]{9})([0-9])([A-Z]{3})([0-9]{6})([0-9])([MF<])([0-9]{6})([0-9])([A-Z0-9<]{14})([0-9])([0-9])/im`. This is classified as a 'soft' field. |


#### `SchmeNm`

With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Cd` | String | Optional | List based on ISO20022 ExternalPersonIdentification1Code List [27-Aug-2021](https://www.iso20022.org/sites/default/files/2021-08/ExternalCodeSets_2Q2021.xlsx), the value of this property **must** be equal to one of the [known values](#cd-known-values) below. |
| `Prtry` | String | Optional | Field to support proprietary value. Maximum length: 35 characters |


##### `Cd` known values

| Value | Description |
|  --- | --- |
| `ARNU` | Alien Registration Number |
| `CCPT` | Passport Number |
| `CUST` | Customer Identification Number |
| `DRLC` | Drivers License Number |
| `EMPL` | Employee Identification Number |
| `NIDN` | National Identity Number |
| `SOS` | Social Security Number |
| `TELE` | Telephone Number |
| `TXID` | Tax Identification Number |


### `Gender`

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Gender` | String | Optional | Gender of the party. Supported values: `Male`, `Female`, `Other`. |


### `Profession`

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Profession` | String | Optional | Occupation of the sending party. |




### `RelShipToDbtr` known values

Indicates relationship of the receiving party to the sending party. This information is required within the creditor object (cdtr) for payout in the Philippines.

| Value | Description |
|  --- | --- |
| `CHIL` | Child |
| `CUST` | Customer |
| `EMPL` | Employee |
| `EXSP` | Ex-spouse |
| `FREN` | Friend |
| `OTHR` | Other |
| `PARE` | Parent |
| `PART` | Business Partner |
| `RELA` | Relation |
| `SELF` | Self |
| `SIBL` | Sibling or Brother or Sister |
| `SPOU` | Covering Spouse or Partner |
| `VEND` | Vendor |


### `Ntlty`

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Ntlty` | String | Optional | Country of nationality of the party (use ISO Country Code for values). |


### `Residence`

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Residence` | String | Optional | Country of residence of the party (use ISO Country Code for values). |


### `Citizenship`

Support for recording multiple values of citizenship of a party.

With the following properties:

| Property | Type | Required | Description |
|  --- | --- | --- | --- |
| `Ntlty` | String | Optional | Nationality of the party. Use ISO Country Code for values. |
| `MnrId` | String | Optional | Indicates whether the party is a minor. Provide a value of `Yes` or `No`. |
| `StartDt` | String | Optional | Information that identifies the start date of citizenship in ISO Date format (`YYYY-MM-DD`) for the party. Format: `date-time` |
| `EndDt` | String | Optional | Information that identifies the end date of citizenship in ISO Date format (`YYYY-MM-DD`) for the party. Format: `date-time` |


## JSON schema extract

details
summary
Click to expand

```json
"id_section": {
    "type": "object",
    "description": "Unique and unambiguous way to identify an individual or organization.",
    "properties": {
        "OrgId": {
            "type": "object",
            "description": "Unique and unambiguous way to identify an individual or organization.",
            "properties": {
                "AnyBIC": {
                    "description": "Code allocated to a receiving institution by the ISO 9362 Registration Authority as described in ISO 9362 'Banking - Banking telecommunication messages - Business identiFer code (BIC)'",
                    "$ref": "#/definitions/bic"
                },
                "DtAndPlcofIncorprtn": {
                    "type": "object",
                    "description": "Indicates the organization's date and place of incorporation.",
                    "properties": {
                        "DtofIncorprtn": {
                            "type": "string",
                            "description": "The date of incorporation for the organization.",
                            "format": "date-time"
                        },
                        "CtryofIncorprtn": {
                            "type": "string",
                            "description": "Information that locates and identifies the country, as defined by postal services where the organization was incorporated. Use Alpha-2 Code as defined in the ISO CountryCode ISO 3166-1 list.",
                            "pattern": "^[A-Z]{2}$"
                        }
                    }
                },
                "Othr": {
                    "type": "array",
                    "description": "An array of objects, each containing unique identification of an organization, as assigned by an institution, using an identification scheme.",
                    "properties": {
                        "Id": {
                            "description": "Identification assigned by an institution.",
                            "type": "string",
                            "maxLength": 35
                        },
                        "Issr": {
                            "description": "Entity that assigns the identification.",
                            "type": "string",
                            "maxLength": 35
                        },
                        "DtOfIss": {
                            "description": "Information that identifies the date of incorporation in ISO Date format (YYYY-MM-DD) for a sending organization or institution.",
                            "type": "string",
                            "maxLength": 10
                        },
                        "DtOfIsse": {
                            "description": "The date of issuance of the supporting documentation.",
                            "type": "string",
                            "format": "date-time"
                        },
                        "DtOfXpry": {
                            "description": "The date of expiration of the supporting documentation.",
                            "type": "string",
                            "format": "date-time"
                        },
                        "SchmeNm": {
                            "type": "object",
                            "description": "Name of the organization identification scheme.",
                            "properties": {
                                "Cd": {
                                    "type": "string",
                                    "description": "List based on ExternalorganizationIdentification1Code List 29May2020",
                                    "enum": [
                                        "BANK",
                                        "CBID",
                                        "CHID",
                                        "CINC",
                                        "COID",
                                        "CUST",
                                        "DUNS",
                                        "EMPL",
                                        "GS1G",
                                        "SREN",
                                        "SRET",
                                        "TXID",
                                        "USCC"
                                    ]
                                },
                                "Prtry": {
                                    "type": "string",
                                    "description": "Field to support proprietary value",
                                    "maxLength": 35
                                }
                            }
                        }
                    }
                },
                "RelShipToDbtr": {
                    "type": "string",
                    "description": "Indicates the relationship between the Sender and Receiver.",
                    "enum": [
                        "BRAN",
                        "CUST",
                        "FRAN",
                        "HOLD",
                        "PART",
                        "SUBS",
                        "SUPP"
                    ]
                },
                "RelShipToCdtr": {
                    "type": "string",
                    "description": "Indicates the relationship between the Sender and Receiver.",
                    "enum": [
                        "BRAN",
                        "CUST",
                        "FRAN",
                        "HOLD",
                        "PART",
                        "SUBS",
                        "SUPP"
                    ]
                },
                "Rprtv": {
                    "type": "object",
                    "description": "Indicates the name of the organization's representative.",
                    "properties": {
                        "StrdNm": {
                          "type": "object",
                          "description": "Allows the name of the organization's representative to be held in a structured format.",
                          "$ref": "#/definitions/name"
                        }
                    }
                }
            }
        },
        "PrvtId": {
            "type": "object",
            "description": "Unique and unambiguous identification of a person, eg, passport.",
            "properties": {
                "DtAndPlcOfBirth": {
                    "type": "object",
                    "description": "Date and place of birth of a person.",
                    "properties": {
                        "BirthDt": {
                            "description": "Information that identifies the date of Birth in ISO Date format (YYYY-MM-DD) for the party.",
                            "type": "string",
                            "format": "date-time"
                        },
                        "PrvcOfBirth": {
                            "description": "Information that locates and identifies the Province of birth for the party.",
                            "type": "string",
                            "maxLength": 35
                        },
                        "CityOfBirth": {
                            "description": "Information that locates and identifies the city of birth for the party.",
                            "type": "string",
                            "maxLength": 35
                        },
                        "CtryOfBirth": {
                            "description": "Information that locates and identifies the country of birth for the party, as defined by postal services. Use Alpha-2 Code as defined in the ISO CountryCode ISO 3166-1 list.",
                            "$ref": "#/definitions/country"
                        }
                    }
                },
                "Othr": {
                    "type": "array",
                    "description": "An array of objects, each containing the unique identification of a party, as assigned by an institution, using an identification scheme.",
                    "properties": {
                        "Id": {
                            "description": "Value to be used to identify the party",
                            "type": "string",
                            "maxLength": 35
                        },
                        "Issr": {
                            "description": "Information for the Entity that assigns the identification.",
                            "type": "string",
                            "maxLength": 35
                        },
                        "SchmeNm": {
                            "type": "object",
                            "description": "Name of the identification scheme used to identify an individual.",
                            "properties": {
                                "Cd": {
                                    "type": "string",
                                    "description": "List based on ISO20022 ExternalPersonIdentification1Code List 29May2020",
                                    "enum": [
                                        "ARNU",
                                        "CCPT",
                                        "CUST",
                                        "DRLC",
                                        "EMPL",
                                        "NIDN",
                                        "SOSE",
                                        "TELE",
                                        "TXID"
                                    ]
                                },
                                "Prtry": {
                                    "type": "string",
                                    "description": "Field to support proprietary value",
                                    "maxLength": 35
                                }
                            }
                        },
                        "DtOfIss": {
                            "type": "string",
                            "description": "Date of Issue for Passport",
                            "format": "date-time"
                        },
                        "DtOfExpr": {
                            "type": "string",
                            "description": "Date of Expiry for Passport",
                            "format": "date-time"
                        },
                        "MrzNb": {
                            "description": "Machine-Readable Zone for Passport",
                            "type": "string",
                            "maxLength": 88,
                            "pattern": "/([A-Z])([A-Z0-9<])([A-Z]{3})([A-Z<]{39})\n([A-Z0-9<]{9})([0-9])([A-Z]{3})([0-9]{6})([0-9])([MF<])([0-9]{6})([0-9])([A-Z0-9<]{14})([0-9])([0-9])/im"
                        }
                    }
                },
                "Gender":{
                    "description": "Information that captures the ender of a party. Supported values: Male, Female, Other.",
                    "type": "string",
                    "maxLength": 6
                },
                "Profession": {
          					"description": "Information that captures the occupation of a party.",
          					"type": "string",
          					"maxLength": 35
          			},
          			"RelShipToDbtr": {
          					"description": "Relationship of the receiving party to the sending party.",
          					"type": "string",
          					"enum":[
          							"CHIL",
          							"CUST",
          							"EMPL",
          							"EXSP",
          							"FREN",
          							"OTHR",
          							"PARE",
          							"PART",
          							"RELA",
          							"SELF",
          							"SIBL",
          							"SPOU",
          							"VEND"
          					]
          			},
          			"Ntlty": {
          					"description": "Country of nationality of the party. Use ISO Country Code for value.",
          					"type": "string",
          					"maxLength": 3
          			},
          			"Residence": {
          					"description": "Country of residence of the party. Use ISO Country Code for value.",
          					"type": "string",
          					"maxLength": 3
          			},
          			"Citizenship": {
          	        "type": "object",
          	        "properties": {
          	            "Ntlty": {
          	                "description": "Nationality of the party. Use ISO Country Code for values.",
          	                "type": "string",
          	                "maxLength": 3
          	            },
          	            "MnrId": {
          	                "description": "Indicates whether the party is a minor. Provide a value of Yes or No.",
          	                "type": "string",
          	                "maxLength": 3
          	            },
          							"StartDt": {
          	                "description": "Start date of citizenship in ISO Date format (YYYY-MM-DD) for the party.",
          	                "type": "string",
                            "format": "date-time",
          	            },
          							"EndDt": {
          	                "description": "End date of citizenship in ISO Date format (YYYY-MM-DD) for the party.",
          	                "type": "string",
                            "format": "date-time",
          	            }
          					}
          			}
            }
        }
    }
}
```