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 name

Description

Validation rules

Mandatory?

individual_or_institution

Indicates if the owner of the ONCHAINID is an individual or an institution

MUST BE either :

  • individual
  • institution

Yes

ethereum_wallets

The list of wallets used by the owner of the ONCHAINID

MUST BE

[{
    "address": "string, valid eth address",
    "alias": "string, less than 40 characters"
}]

Yes

politically_exposed

Defines 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 name

Description

Validation rule

Mandatory?

first_name

The first name of the owner of the ONCHAINID

None

Yes

last_name

The last name of the owner of the ONCHAINID

None

Yes

gender

The gender of the owner of the ONCHAINID

MUST BE

  • Male
  • Female

No

birthday

The date of birth of the owner of the ONCHAINID

MUST BE an ISO date string, with timezone

Yes

birthplace

The place of birth of the owner of the ONCHAINID

None

No

nationality

The nationality of the owner of the ONCHAINID

MUST BE in ISO 3166 Alpha-3 format (see here)

Yes

id_number

The number of the ID card of the owner of the ONCHAINID

None

Yes, if passport_number is not set

passport_number

The number of the passport of the owner of the ONCHAINID

None

Yes, if id_number is not set

ssn_number

The social security number of the owner of the ONCHAINID

None

No

phone

The phone number of the owner of the ONCHAINID

None

No

occupation

The occupation of the owner of the ONCHAINID

See Occupations and activities

No

building_number

The building number from the address of the owner of the ONCHAINID

None

No

street

The street from the address of the owner of the ONCHAINID

None

Yes

zip_code

The ZIP code of the address of the owner of the ONCHAINID

None

Yes

state

The state from the address of the owner of the ONCHAINID

None

No

city

The city of the address of the owner of the ONCHAINID

None

Yes

country

The country of the address of the owner of the ONCHAINID

MUST BE in ISO 3166 Alpha-3 format (see here)

Yes

Institutional

Field name

Description

Validation rule

Mandatory?

institution_trade_name

The trade name of the company owning the ONCHAINID

None

Yes

institution_legal_name

The legal name of the company owning the ONCHAINID

None

Yes

institution_registry_number

The national registration number of the company

None

Yes

institution_legal_form

The legal form of the company

See closed list

No

institution_incorporation_date

The incorporation date of the company

MUST BE an ISO date string, with timezone

No

institution_activity

The sector of activity of the company

See Occupations and activities

No

institution_registry_country

The country of incorporation of the company

MUST BE in ISO 3166 Alpha-3 format (see here)

Yes

institution_building_number

The building number part of the address of the headquarters of the company

None

No

institution_street

The street part of the address of the HQ of the company

None

Yes

institution_city

The city part of the address of the HQ of the company

None

Yes

institution_state

The state part of the address of the HQ of the company

None

No

institution_country

The country part of the address of the HQ of the company

MUST BE in ISO 3166 Alpha-3 format (see here)

Yes

institution_zip_code

The ZIP code part of the address of the HQ of the company

None

No

institution_admins

The list of individuals being set as the administrators of the company

MUST 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"
        }
    ]
}