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"
}
]
}
Updated almost 3 years ago