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? |
---|---|---|---|
| Indicates if the owner of the ONCHAINID is an individual or an institution | MUST BE either :
| Yes |
| The list of wallets used by the owner of the ONCHAINID | MUST BE
| Yes |
| Defines if the owner of the ONCHAINID is a politically exposed person. | MUST BE
| No |
Individuals
Field name | Description | Validation rule | Mandatory? |
---|---|---|---|
| The first name of the owner of the ONCHAINID | None | Yes |
| The last name of the owner of the ONCHAINID | None | Yes |
| The gender of the owner of the ONCHAINID | MUST BE
| No |
| The date of birth of the owner of the ONCHAINID | MUST BE an ISO date string, with timezone | Yes |
| The place of birth of the owner of the ONCHAINID | None | No |
| The nationality of the owner of the ONCHAINID | MUST BE in ISO 3166 Alpha-3 format (see here) | Yes |
| The number of the ID card of the owner of the ONCHAINID | None | Yes, if |
| The number of the passport of the owner of the ONCHAINID | None | Yes, if |
| The social security number of the owner of the ONCHAINID | None | No |
| The phone number of the owner of the ONCHAINID | None | No |
| The occupation of the owner of the ONCHAINID | No | |
| The building number from the address of the owner of the ONCHAINID | None | No |
| The street from the address of the owner of the ONCHAINID | None | Yes |
| The ZIP code of the address of the owner of the ONCHAINID | None | Yes |
| The state from the address of the owner of the ONCHAINID | None | No |
| The city of the address of the owner of the ONCHAINID | None | Yes |
| 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? |
---|---|---|---|
| The trade name of the company owning the ONCHAINID | None | Yes |
| The legal name of the company owning the ONCHAINID | None | Yes |
| The national registration number of the company | None | Yes |
| The legal form of the company | See closed list | No |
| The incorporation date of the company | MUST BE an ISO date string, with timezone | No |
| The sector of activity of the company | No | |
| The country of incorporation of the company | MUST BE in ISO 3166 Alpha-3 format (see here) | Yes |
| The building number part of the address of the headquarters of the company | None | No |
| The street part of the address of the HQ of the company | None | Yes |
| The city part of the address of the HQ of the company | None | Yes |
| The state part of the address of the HQ of the company | None | No |
| The country part of the address of the HQ of the company | MUST BE in ISO 3166 Alpha-3 format (see here) | Yes |
| The ZIP code part of the address of the HQ of the company | None | No |
| The list of individuals being set as the administrators of the company | MUST BE
| The field itself is 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"
}
]
}
Updated about 1 year ago