ONCHAINID Standard Schema

The standard data scheme for the identity data linked to your ONCHAINID

What is the ONCHAINID Standard Schema?

The ONCHAINID Standard Schema is the minimal set required to create an onchain identity. It gathers all the identity data related to the owner of the ONCHAINID, be it an individual or a corporate entity.

ONCHAINID Standard Schema

Common fields (both for Individuals and Corporates)

Field nameDescriptionValidation rulesMandatory?
individual_or_institutionIndicates if the owner of the ONCHAINID is an individual or an institutionMUST BE either :

- individual
- institution
Yes
ethereum_walletsThe list of wallets used by the owner of the ONCHAINIDMUST BE
[{ "address": "string, valid eth address", "alias": "string, less than 40 characters" }]
Yes
politically_exposedDefines if the owner of the ONCHAINID is a politically exposed person.MUST BE
[{ "exposed": "true or false", "details": "string" }]

details is mandatory if exposed is set to true.
No

Individuals

Field nameDescriptionValidation ruleMandatory?
first_nameThe first name of the owner of the ONCHAINIDNoneYes
last_nameThe last name of the owner of the ONCHAINIDNoneYes
genderThe gender of the owner of the ONCHAINIDMUST BE

- Male
- Female
No
birthdayThe date of birth of the owner of the ONCHAINIDMUST BE an ISO date string, with timezoneYes
birthplaceThe place of birth of the owner of the ONCHAINIDNoneNo
nationalityThe nationality of the owner of the ONCHAINIDMUST BE in ISO 3166 Alpha-3 format (see here)Yes
id_numberThe number of the ID card of the owner of the ONCHAINIDNoneYes, if passport_number is not set
passport_numberThe number of the passport of the owner of the ONCHAINIDNoneYes, if id_number is not set
ssn_numberThe social security number of the owner of the ONCHAINIDNoneNo
phoneThe phone number of the owner of the ONCHAINIDNoneNo
occupationThe occupation of the owner of the ONCHAINIDSee Occupations and activitiesNo
building_numberThe building number from the address of the owner of the ONCHAINIDNoneNo
streetThe street from the address of the owner of the ONCHAINIDNoneYes
zip_codeThe ZIP code of the address of the owner of the ONCHAINIDNoneYes
stateThe state from the address of the owner of the ONCHAINIDNoneNo
cityThe city of the address of the owner of the ONCHAINIDNoneYes
countryThe country of the address of the owner of the ONCHAINIDMUST BE in ISO 3166 Alpha-3 format (see here)Yes

Institutional

Field nameDescriptionValidation ruleMandatory?
institution_trade_nameThe trade name of the company owning the ONCHAINIDNoneYes
institution_legal_nameThe legal name of the company owning the ONCHAINIDNoneYes
institution_registry_numberThe national registration number of the companyNoneYes
institution_legal_formThe legal form of the companySee closed listNo
institution_incorporation_dateThe incorporation date of the companyMUST BE an ISO date string, with timezoneNo
institution_activityThe sector of activity of the companySee Occupations and activitiesNo
institution_registry_countryThe country of incorporation of the companyMUST BE in ISO 3166 Alpha-3 format (see here)Yes
institution_building_numberThe building number part of the address of the headquarters of the companyNoneNo
institution_streetThe street part of the address of the HQ of the companyNoneYes
institution_cityThe city part of the address of the HQ of the companyNoneYes
institution_stateThe state part of the address of the HQ of the companyNoneNo
institution_countryThe country part of the address of the HQ of the companyMUST BE in ISO 3166 Alpha-3 format (see here)Yes
institution_zip_codeThe ZIP code part of the address of the HQ of the companyNoneNo
institution_adminsThe list of individuals being set as the administrators of the companyMUST BE
[{ "first_name": "string", "last_name": "string", "gender": "Male or Female", "birthday": "ISO Date", "nationality": "ISO Country", "institution_admin_title": "String", "institution_admin_relation": "String", "email": "String", "phone": "String", "passport_number": "String", "id_number": "String" }]

- phone and email refer to the phone number and email address of the individual in the company
- institution_admin_title: the title of the individual in the company
- institution_admin_relation: the position of the individual in the company
The field itself is mandatory.
For the content of the field:

- first_name: mandatory
- last_name: mandatory
- gender: optional
- birthday: optional
- nationality: optional
- passport_number: mandatory if id_number is not set
- id_number:
mandatory if passport_number is not set
- institution_admin_title: mandatory
- institution_admin_relation: mandatory
- phone: mandatory
- email: mandatory

Examples

Individual

{
    "street": [
        {
            "value": "Street",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "fe0d6a6b-060e-43b4-88ee-6445a08f67ef"
        }
    ],
    "passport_number": [
        {
            "value": "87654321",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "44cacfd5-ae38-4232-87b2-8fe8da968c96"
        }
    ],
    "wallet": [
        {
            "value": "0x4794d8f485c7458fbde20bd701d913163bd7bb10",
            "schema": {
                "standard": false
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "207743da-2c7d-4c3a-8918-6793a7ed8c26"
        }
    ],
    "id_card_passport": [
        {
            "value": [
                {
                    "fileName": "36fdb1a35cd2f54f95cf2119fb5bc7ed_XL.jpg",
                    "size": 563611,
                    "data": {},
                    "fileType": "image/jpeg",
                    "url": "file.jpeg"
                }
            ],
            "schema": {
                "minItems": 1,
                "maxItems": 2,
                "type": "array",
                "items": [
                    {
                        "type": "object",
                        "required": [
                            "fileType",
                            "fileName",
                            "size",
                            "url"
                        ],
                        "properties": {
                            "fileName": {
                                "type": "string"
                            },
                            "size": {
                                "type": "number",
                                "maximum": 10240000
                            },
                            "url": {
                                "type": "string"
                            },
                            "fileType": {
                                "type": "string",
                                "enum": [
                                    "image/jpeg",
                                    "image/png",
                                    "application/pdf",
                                    "image/jpg"
                                ]
                            }
                        }
                    }
                ],
                "uniqueItems": true
            },
            "date": "2020-10-26T13:37:28.596Z",
            "version": "eb8cdd79-93f5-48f8-a180-399f37b9b779"
        }
    ],
    "first_name": [
        {
            "value": "John",
            "schema": {
                "standard": true
            },
            "date": "2020-06-16T13:06:01.371Z",
            "version": "b80b156b-6028-4436-b0b1-951bc429611c"
        }
    ],
    "individual_or_institution": [
        {
            "value": "individual",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.793Z",
            "version": "8210a57c-c9d1-41c7-b36c-8218625df646"
        }
    ],
    "occupation": [
        {
            "value": "Advertising",
            "schema": {
                "standard": true
            },
            "date": "2020-12-04T15:54:26.165Z",
            "version": "aaf15cfe-4aba-4d7e-8976-e01d049a7b7a"
        }
    ],
    "nationality": [
        {
            "value": "LUX",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "422a9e35-8644-4a76-a53a-d7099a3a76fc"
        }
    ],
    "id_number": [
        {
            "value": "12345678",
            "schema": {
                "standard": true
            },
            "date": "2020-09-02T13:10:38.954Z",
            "version": "ba3a5482-9534-42ac-90af-da577056e99b"
        }
    ],
    "state": [
        {
            "value": "",
            "schema": {
                "standard": true
            },
            "date": "2020-12-04T15:54:26.165Z",
            "version": "8866d4f8-a3b0-4802-9335-b532025caa38"
        }
    ],
    "zip_code": [
        {
            "value": "12345",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "1abe9d42-162b-41ef-ab48-21b09922262c"
        }
    ],
    "birthplace": [
        {
            "value": "Luxembourg",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "0b95ad44-7e18-48d1-86ec-7e50ad300328"
        }
    ],
    "email": [
        {
            "value": "[email protected]",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "dd4dc8f9-de9a-4537-bf9d-47180a457cb2"
        }
    ],
    "building_number": [
        {
            "value": "123",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "8e99454b-42b4-4c83-8f4f-d2a973c2685e"
        }
    ],
    "proof_of_address": [
        {
            "value": [
                {
                    "fileName": "36fdb1a35cd2f54f95cf2119fb5bc7ed_XL.jpg",
                    "size": 563611,
                    "data": {},
                    "fileType": "image/jpeg",
                    "url": "file.jpeg"
                }
            ],
            "schema": {
                "minItems": 1,
                "maxItems": 5,
                "type": "array",
                "items": [
                    {
                        "type": "object",
                        "required": [
                            "fileType",
                            "fileName",
                            "size",
                            "url"
                        ],
                        "properties": {
                            "fileName": {
                                "type": "string"
                            },
                            "size": {
                                "type": "number",
                                "maximum": 10240000
                            },
                            "url": {
                                "type": "string"
                            },
                            "fileType": {
                                "type": "string",
                                "enum": [
                                    "image/jpeg",
                                    "image/png",
                                    "application/pdf",
                                    "image/jpg"
                                ]
                            }
                        }
                    }
                ],
                "uniqueItems": true
            },
            "date": "2020-10-26T13:37:28.876Z",
            "version": "cad76093-b25a-4457-93c5-4014db2d7692"
        }
    ],
    "phone": [
        {
            "value": "+352 28810201",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "0cfbacf7-d1d5-48cc-a9aa-0dc5b46bd48e"
        }
    ],
    "gender": [
        {
            "value": "Male",
            "schema": {
                "standard": true
            },
            "date": "2020-09-02T13:10:38.954Z",
            "version": "b8262331-bee8-46a4-82bc-5d2d253c2bf4"
        }
    ],
    "city": [
        {
            "value": "Luxembourg",
            "schema": {
                "standard": true
            },
            "date": "2020-10-02T13:14:30.794Z",
            "version": "06618862-0a9f-42d1-bab9-2b2edfca31c4"
        }
    ],
    "country": [
        {
            "value": "LUX",
            "schema": {
                "standard": true
            },
            "date": "2020-09-02T13:10:38.954Z",
            "version": "9954b59e-b5ba-4c63-b973-3a7de08d7d44"
        }
    ],
    "last_name": [
        {
            "value": "Doe",
            "schema": {
                "standard": true
            },
            "date": "2020-12-07T15:21:28.333Z",
            "version": "ee432b8f-33d4-48e9-80d6-9862bd9aabef"
        }
    ],
    "birthday": [
        {
            "value": "1992-01-01T23:00:00.000Z",
            "schema": {
                "standard": true
            },
            "date": "2020-12-07T15:32:53.180Z",
            "version": "08cf136a-714b-4b25-b1c6-fbc9daceb1b3"
        }
    ],
    "politically_exposed": [
        {
            "value": {
                "exposed": false
            },
            "schema": {
                "standard": true
            },
            "date": "2020-12-04T15:54:26.165Z",
            "version": "5119fd70-f00e-446e-9eb8-ad8e519cc543"
        }
    ]
}

Institutional

{
    "last_name": [
        {
            "value": "Daff",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "2321c3e1-4ca5-4e0f-b8ab-24bfc86445fb"
        }
    ],
    "institution_city": [
        {
            "value": "Spain",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.144Z",
            "version": "2609c3c6-c74b-47a8-a48e-122cfea6f9b4"
        }
    ],
    "passport_number": [
        {
            "value": "87654321",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.916Z",
            "version": "903a7db2-1772-4775-8de6-8b438066fef6"
        }
    ],
    "individual_or_institution": [
        {
            "value": "institution",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "f6c4ae24-ba11-453c-9f15-3dd2b44480a7"
        }
    ],
    "institution_zip_code": [
        {
            "value": "60606",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "f1205c11-227d-4b13-9868-6e6cd005c614"
        }
    ],
    "phone": [
        {
            "value": "+34 628810201",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.916Z",
            "version": "64dcf7d9-fda8-4946-b69a-4f84dccfec08"
        }
    ],
    "gender": [
        {
            "value": "Male",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.916Z",
            "version": "d4a7732d-b49d-44c4-b8eb-ffdc3a7b727a"
        }
    ],
    "institution_country": [
        {
            "value": "ESP",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.144Z",
            "version": "758dc1ee-5127-4c7c-9ddb-973391e55ac8"
        }
    ],
    "institution_registry_number": [
        {
            "value": "ES12345678",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "17dc0ab0-1cf0-4f0b-995b-e66041faebe0"
        }
    ],
    "institution_admins": [
        {
            "value": [
                {
                    "id_number": "3334F"
                }
            ],
            "schema": {
                "standard": true
            },
            "date": "2021-05-03T08:25:01.161Z",
            "version": "3f0cfab5-9af2-4821-8fa8-6a83c6aa83aa"
        }
    ],
    "institution_legal_name": [
        {
            "value": "BCN Legal",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "3b038c9e-9985-4bc0-8378-1ff42ad680f0"
        }
    ],
    "institution_street": [
        {
            "value": "Loko",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "1bf0f42f-5bf9-4a12-aacc-4209b344b15d"
        }
    ],
    "institution_registry_country": [
        {
            "value": "ESP",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "68b79365-4b26-445c-804d-341b09aa90e3"
        }
    ],
    "birthday": [
        {
            "value": "1980-05-21T00:00:00.000Z",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.916Z",
            "version": "eab33489-14a2-484f-bd9f-59d82b5626bc"
        }
    ],
    "nationality": [
        {
            "value": "ESP",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.916Z",
            "version": "59d38cdd-7496-43db-bb15-f2ca11e30aa6"
        }
    ],
    "occupation": [
        {
            "value": "Finance",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.916Z",
            "version": "fd247275-0164-431b-b0b6-ab836856edca"
        }
    ],
    "zip_code": [
        {
            "value": "12345",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.985Z",
            "version": "821abc77-701f-4253-9f3e-bf6b980feb9c"
        }
    ],
    "institution_legal_form": [
        {
            "value": "Sarl",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "8e62130e-3906-451a-8f73-59a785c3f78b"
        }
    ],
    "institution_trade_name": [
        {
            "value": "BCN",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "2f240151-2801-40b5-847c-1b3611a1a100"
        }
    ],
    "building_number": [
        {
            "value": "123",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.985Z",
            "version": "b390bbfb-f265-43f0-9d71-a0b8f44f1e00"
        }
    ],
    "first_name": [
        {
            "value": "Willen",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "40be394c-476f-420b-a00b-0756848118cf"
        }
    ],
    "institution_incorporation_date": [
        {
            "value": "2015-12-15T00:00:00.000000Z",
            "schema": {
                "standard": true
            },
            "date": "2021-05-03T08:25:01.161Z",
            "version": "52934bbf-94a8-4b17-b0d5-37af983506ba"
        }
    ],
    "email": [
        {
            "value": "[email protected]",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.984Z",
            "version": "2cfdf58a-9e5c-42a7-928c-24a9d7b2b052"
        }
    ],
    "country": [
        {
            "value": "LIE",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.985Z",
            "version": "20394e73-e6ac-46c9-8c18-59831a788289"
        }
    ],
    "politically_exposed": [
        {
            "value": {
                "exposed": true,
                "details": "West"
            },
            "schema": {
                "standard": true
            },
            "date": "2021-05-03T08:25:01.161Z",
            "version": "38afc086-9f69-4d5a-ad16-a6868f0411e4"
        }
    ],
    "birthplace": [
        {
            "value": "Spain",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.916Z",
            "version": "2e35b31a-3a12-4e22-87b7-b7d8f0ea825f"
        }
    ],
    "institution_activity": [
        {
            "value": "Bank",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "44b4b188-30ea-46d0-8eff-959d6110999b"
        }
    ],
    "id_number": [
        {
            "value": "12345678",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.916Z",
            "version": "257fed3e-4966-4f94-99a4-6d4bd0712f90"
        }
    ],
    "wallet": [
        {
            "value": "0x49dc24589a0515a2b7688900002c62a315a372bd",
            "schema": {
                "standard": false
            },
            "date": "2021-01-20T11:54:51.144Z",
            "version": "0e0fc5ba-0c5b-47cf-9362-809ba5de7f3d"
        }
    ],
    "institution_building_number": [
        {
            "value": "666",
            "schema": {
                "standard": true
            },
            "date": "2021-01-20T11:54:51.143Z",
            "version": "b0617e6f-c096-4803-bf49-cd0c0bcb3999"
        }
    ],
    "ethereum_wallets": [
        {
            "value": {
                "NcrIwbgaJyIqgzeTNzJd": {
                    "alias": "NcrIwbgaJyIqgzeTNzJd",
                    "address": "0xbf6683a993eb0848b563bbe5d38bcb9c4a5e7333"
                }
            },
            "schema": {
                "standard": true
            },
            "date": "2021-05-03T08:28:24.233Z",
            "version": "8bdfcebb-4a38-462e-8435-cfca353bb30e"
        }
    ],
    "city": [
        {
            "value": "Luxembourg",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.985Z",
            "version": "9d623b46-6693-4ff2-b9cd-a6ee978ab7fb"
        }
    ],
    "street": [
        {
            "value": "Street",
            "schema": {
                "standard": true
            },
            "date": "2021-01-14T16:17:42.985Z",
            "version": "35026ad0-57a2-4ffe-9487-f00702bbed1d"
        }
    ]
}