Enterprise Credential Vocabulary
Abstract
This specification describes an experimental vocabulary for asserting Enterprise Credentials. Enterprises can use these credentials to prove certain claims about themselves to business partners. In addition, Enterprise Credentials can be used for authorisation purposes.
Click here to open the JSON-LD file: oid.jsonld
Use Case and Requirements
The following vocabulary is derived from the enterprise data collected and managed by the Bundesanzeiger. It provides an overview of the current presentation of existing data and maps it to credential schema definitions (JSON-LD). These can be used to create and define credentials, representing the data schema as the single source of truth for credentials based on these schemas.
Examples
The examples presented in this section are W3C-Credentials. For brevity, they are shown without proof. W3C-Credentials can be issued using any of the following proofs:
- LD-Proof
- JOSE
- JOSE + "Selective Disclosure for JWTs"
Natural Person Credential
The following example represents the credential of a Natural Person (NaturalPerson):
{
"@context": [
"https://www.w3.org/ns/credentials/v2",
"https://oid.spherity.com/contexts/oid/v1.1.jsonld"
],
"type": [
"VerifiableCredential",
"LegalEntityCertificate"
],
"id": "urn:uuid:f086cced-1153-4540-993b-b4d52ca499c2",
"validFrom": "2019-12-03T12:19:52Z",
"validUntil": "2029-12-03T12:19:52Z",
"issuer": "did:key:z6MkiY62766b1LJkExWMsM3QG4WtX7QpY823dxoYzr9qZvJ3",
"credentialSubject": {
"id": "did:key:fictive-1",
"type": "NaturalPerson",
"givenName": "JOHN",
"familyName": "DOE",
"gender": "Male",
"birthDate": "1970-01-01",
"domicile": {
"adminUnitL1": "Germany",
"postName": "Berlin",
"postCode": 10119
}
}
}
This particular credential uses key binding to bind the credential to the holder. The holder of this credential is the Natural Person described in the credential subject. Therefore, a DID which is controlled by the Natural Persons is assigned to the term id of the credential subject. This enables the Natural Person to present this credential in form of a verifiable credential.
Legal Person Id Credential (aka EBWOID)
The following example shows a European Business Wallet Owner Identification Data (EBWOID) Credential:
{
"@context": [
"https://www.w3.org/ns/credentials/v2",
"https://oid.spherity.com/contexts/oid/v1.2.jsonld"
],
"type": [
"VerifiableCredential",
"EbwoidCredential"
],
"id": "urn:uuid:f086cced-1153-4540-993b-b4d52ca499c2",
"validFrom": "2019-12-03T12:19:52Z",
"validUntil": "2029-12-03T12:19:52Z",
"issuer": "did:key:z6MkiY62766b1LJkExWMsM3QG4WtX7QpY823dxoYzr9qZvJ3",
"credentialSubject": {
"id": "did:key:fictive-1",
"type": "Ebwoid",
"euid": "DEPLPOAG.123456789",
"companyName": "Flower Power AG"
}
}
This credential is bound to the Legal Entity. Therefore, a DID which is under control of the Legal Person is assigned to the term id of the credential subject.
Legal Person Self-Attestation Credential
The following example shows a self-signed minimal company identity credential (LegalPersonSelfAttestation). The legal entity issues this credential itself — the issuer DID matches the credential subject DID — and it contains only the EUID and company name:
{
"@context": [
"https://www.w3.org/ns/credentials/v2",
"https://oid.spherity.com/contexts/oid/v1.1.jsonld"
],
"type": [
"VerifiableCredential",
"LegalPersonSelfAttestation"
],
"id": "urn:uuid:a1b2c3d4-0000-0000-0000-e5f6a7b8c9d0",
"validFrom": "2019-12-03T12:19:52Z",
"validUntil": "2029-12-03T12:19:52Z",
"issuer": "did:key:fictive-1",
"credentialSubject": {
"id": "did:key:fictive-1",
"type": "LegalPersonId",
"euid": "DEPLPOAG.123456789",
"companyName": "Flower Power AG"
}
}
Unlike an authority-issued LegalEntityCertificate, the issuer here is the company itself, making this a self-attestation rather than a third-party assertion.
Legal Person Base Data Credential (LEI)
The following example shows a credential which includes two types within the credentialSubject.
The LegalPersonBaseData extends the Ebwoid term by additional base data of the enterprise.
{
"@context": [
"https://www.w3.org/ns/credentials/v2",
"https://oid.spherity.com/contexts/oid/v1.2.jsonld"
],
"type": [
"VerifiableCredential",
"LeiCredential"
],
"id": "urn:uuid:f086cced-1153-4540-993b-b4d52ca499c2",
"validFrom": "2019-12-03T12:19:52Z",
"validUntil": "2029-12-03T12:19:52Z",
"issuer": "did:key:z6MkiY62766b1LJkExWMsM3QG4WtX7QpY823dxoYzr9qZvJ3",
"credentialSubject": {
"id": "did:key:fictive-1",
"type": [
"Ebwoid",
"LegalPersonBaseData"
],
"euid": "DEPLPOAG.123456789",
"companyName": "Flower Power AG",
"companyIdentifier": "urn:mdms:12345678",
"address": {
"type": "oid:LegalPersonAddress",
"addressArea": "Friedrichswerder",
"adminUnitL1": "Germany",
"adminUnitL2": "Berlin",
"locatorDesignator": "33",
"postCode": 10119,
"postName": "Berlin",
"thoroughfare": "Unter den Linden"
},
"registerIdentification": {
"registerType": "ABC123",
"registerTypeDescription": "Amtsgericht Tiergarten",
"registerLocation": "Berlin, Moabit",
"registerNumber": "123AVB",
"companyId": "ACDC",
"companyIdCountryCode": "DE"
},
"previousName": ["AL", "DI"],
"status": "active",
"liquidationStatus": "none",
"insolvencyStatus": "none",
"legalForm": "GmbH",
"isFoundation": false,
"isNfrdObligated": false,
"isTrust": false,
"businessObject": "Trading Company",
"registrationDate": "2010-01-01",
"exchange": {
"name": "Boerse Stuttgart",
"country": "Germany",
"marketIdentificationCode": "AA",
"tickerSymbol": "BB"
},
"isin": "1234567890",
"vatId": "22222ABC",
"ekrn": "3333",
"regulator": {
"name": "BaFin",
"regulatorId": "DeBa",
"description": "Int. Trade"
},
"wz2008": {
"type": "Industry",
"code": "IT",
"industryDescription": "Tech Int. Trade"
},
"nace020": {
"type": "Industry",
"code": "IT",
"industryDescription": "Tech Int. Trade"
},
"lei": "ABC988",
"leiStatus": "active",
"leiNextIssuance": "2027-01-10"
}
}
Legal Person Credential
This example shows a credential which holds the complete information about an enterprise in the credential subject including the relations to other legal entities.
{
"@context": [
"https://www.w3.org/ns/credentials/v2",
"https://oid.spherity.com/contexts/oid/v1.1.jsonld"
],
"type": [
"VerifiableCredential",
"LegalEntityCertificate"
],
"id": "urn:uuid:f086cced-1153-4540-993b-b4d52ca499c2",
"validFrom": "2019-12-03T12:19:52Z",
"validUntil": "2029-12-03T12:19:52Z",
"issuer": "did:key:z6MkiY62766b1LJkExWMsM3QG4WtX7QpY823dxoYzr9qZvJ3",
"credentialSubject": {
"id": "did:key:fictive-1",
"type": [
"LegalPersonId",
"LegalPersonBaseData",
"LegalPerson"
],
"euid": "ANY EUID",
"companyName": "Flower Power AG",
"companyIdentifier": "urn:mdms:12345678",
"address": {
"addressArea": "Friedrichswerder",
"adminUnitL1": "Germany",
"adminUnitL2": "Berlin",
"locatorDesignator": "33",
"postCode": 10119,
"postName": "Berlin",
"thoroughfare": "Unter den Linden"
},
"registerIdentification": {
"registerType": "ABC123",
"registerTypeDescription": "Amtsgericht Tiergarten",
"registerLocation": "Berlin, Moabit",
"registerNumber": "123AVB",
"companyId": "ACDC",
"companyIdCountryCode": "DE"
},
"previousName": ["AL", "DI"],
"status": "active",
"liquidationStatus": "none",
"insolvencyStatus": "none",
"legalForm": "GmbH",
"isFoundation": false,
"isNfrdObligated": false,
"isTrust": false,
"businessObject": "Trading Company",
"registrationDate": "2010-01-01",
"exchange": {
"name": "Boerse Stuttgart",
"country": "Germany",
"marketIdentificationCode": "AA",
"tickerSymbol": "BB"
},
"isin": "1234567890",
"vatId": "22222ABC",
"ekrn": "3333",
"regulator": {
"name": "BaFin",
"regulatorId": "DeBa",
"description": "Int. Trade"
},
"wz2008": {
"@type": "Industry",
"code": "IT",
"description": "Tech Int. Trade"
},
"nace020": {
"@type": "Industry",
"code": "IT",
"description": "Tech Int. Trade"
},
"lei": "ABC988",
"leiStatus": "active",
"leiNextIssuance": "2027-01-10",
"businessYear": {
"revenue": "2933",
"currency": "EUR",
"employeeCount": "39",
"balance": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"date": "2024-01-01"
},
"ultimateBeneficiaryOwner": {
"naturalPersonId": "did:key:fictive-2",
"capital": {
"share": {
"@type": "Share",
"relative": "20",
"absolute": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"absoluteInEur": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"isDirectShare": true
},
"votingRightsRelativeDirect": "20",
"shareRelativeDirect": "20"
},
"votingRights": {
"share": {
"@type": "Share",
"relative": "20",
"absolute": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"absoluteInEur": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"isDirectShare": true
},
"votingRightsRelativeDirect": "20",
"votingRightsRelative": "20",
"shareRelativeDirect": "20",
"otherControlReason": "20"
},
"otherControl": {
"share": {
"@type": "Share",
"relative": "20",
"absolute": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"absoluteInEur": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"isDirectShare": true
},
"votingRightsRelativeDirect": "20",
"shareRelativeDirect": "20"
},
"fictitious": {
"share": {
"@type": "Share",
"relative": "20",
"absolute": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"absoluteInEur": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"isDirectShare": true
},
"votingRightsRelativeDirect": "20",
"shareRelativeDirect": "20"
}
},
"functionary": {
"legalEntityId": "did:key:fictive-3",
"role": "CEO",
"isAuthorizedRepresentative": true,
"isExclusionOfParagraph181": false,
"authorizationExtent": "full"
},
"shareholder": {
"@type": "Shareholder",
"legalEntityId": "did:key:fictive-4",
"share": {
"@type": "Share",
"relative": "20",
"absolute": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"absoluteInEur": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"isDirectShare": true
},
"votingRightsRelative": "20"
},
"generalPartner": {
"@type": "Shareholder",
"legalEntityId": "did:key:fictive-6",
"share": {
"@type": "Share",
"relative": "20",
"absolute": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"absoluteInEur": {
"@type": "Balance",
"amount": "399399",
"currency": "EUR"
},
"isDirectShare": true
}
},
"directParentCompany": "did:key:fictive-7",
"ultimateParentCompany": "did:key:fictive-8",
"handoverFlag": false,
"handoverDescription": "no flag",
"evidence": {
"@type": "Evidence",
"source": "Transparency register",
"verifiedField": ["CEO", "CTO"],
"verificationDate": "2014-01-01"
}
}
}
Concepts
The Enterprise Credential embeds existing enterprise data into credentials. As a result, the embedded information can be used prove certain claims about the enterprise. It also enables representatives to prove their role within an enterprise to service providers and business partners.
For example, when opening a bank account on behalf of a company, the applicant needs to provide proof of authorisation and company information to undergo a KYC process. Today, this KYC process is mainly a manual endeavour that requires manual labour and involves waiting times. With the presentation of corporate credentials, the process can be fully automated, reducing time, overhead and liability risks. Verifiable credentials permit sharing information based on cryptographically signed data. The enterprise requests the credentials from the Bundesanzeiger receives an Enterprise Credential based on the official registered data. The Bundesanzeiger cryptographically asserts the correctness and authenticity of the data. The enterprise can then use this for further service providers With this setup, the bank institute can validate the data by itself and can check, if the credential was issued by a well known and eligible authority (e.g. the Bundesanzeiger).
Information Model - Enterprise Credential
Verifiable Credentials
The Enterprise Credential is a list of LegalEntityCertificate credentials. There are two kinds of legal entities: human and non-human. In law, a human person is called a Natural Person and a non-human person is called a Legal Person. Therefore, there are two types of credential subjects derived from the abstract class LegalEntity:
NaturalPersonLegalPerson
Legal Person Data Model (Enterprise)
The full data model of a Legal Person is shown below. There are three types representing a Legal Person depending on the amount of disclosed data:
LegalPersonIdonly containing ID and name of the companyLegalPersonBaseDatacontaining only the base data of the Legal Person, mostly describing the Legal Person itselfLegalPersondescribing the full structure of the Legal Person, including their relationship to other legal entities (Natural Persons and Legal Personss)
Please note that an Enterprise Credential issued by the register consists of a list of credentials which contains:
- one
LegalEntitycredential of the requesting Legal Entity - zero or more
LegalPersonBaseDatacredentials of related Legal Persons - zero or more
NaturalPersoncredentials of related Natural Persons
Ebwoid (aka EBWOID)
The Ebwoid is an unique identifier of a Legal Person, i.e. a corporation, firm or organisation.
LegalPersonBaseData
The LegalPersonBaseData extends the LegalPersonId by base data about the Legal Person.
LegalPerson
Legal Persons are entities such as corporations, firms or organisations. They are treated in law as if they were persons. The LegalPerson extends the LegalPersonBaseData by comprehensive data about the Legal Person, like relations to other legal entities.
Natural Person
Natural persons acquire legal personality "naturally", simply by being born.
Credential Vocabulary
LegalEntityCertificate
The LegalEntityCertificate is the top-level credential type for authority-issued Enterprise Credentials describing a legal entity.
| Key | Value |
|---|---|
| Term | LegalEntityCertificate |
| URL | https://oid.spherity.com/oid#LegalEntityCertificate |
LegalPersonSelfAttestation
A self-signed minimal company identity credential in which the legal entity asserts its own EUID and company name. The issuer DID matches the credential subject DID, distinguishing it from authority-issued credentials. Use this type instead of LegalEntityCertificate when the company itself is the issuer.
A LegalPersonSelfAttestation is required when requesting natural person credentials (e.g. NaturalPerson) on behalf of a legal entity, as it establishes the legal entity's identity without relying on an external authority.
| Key | Value |
|---|---|
| Term | LegalPersonSelfAttestation |
| URL | https://oid.spherity.com/oid#LegalPersonSelfAttestation |
KycCredential
A Know Your Customer (KYC) credential issued by an authority such as the Bundesanzeiger. Attests that a KYC process has been completed for the subject.
| Key | Value |
|---|---|
| Term | KycCredential |
| URL | https://oid.spherity.com/oid#KycCredential |
LpidCredential
A Legal Person Identification Data (LPID) credential issued by an authority such as the Bundesanzeiger. Contains the EUID and company name of a legal person.
| Key | Value |
|---|---|
| Term | LpidCredential |
| URL | https://oid.spherity.com/oid#LpidCredential |
EbwoidCredential
An EBWOID credential issued by an authority such as the Bundesanzeiger. Contains the EUID and company name of a legal person. Successor of LpidCredential.
| Key | Value |
|---|---|
| Term | EbwoidCredential |
| URL | https://oid.spherity.com/oid#EbwoidCredential |
LeiCredential
A Legal Entity Identifier (LEI) credential issued by an authority such as the Bundesanzeiger. Contains base data of the legal person including the LEI, address, register identification, and related fields.
| Key | Value |
|---|---|
| Term | LeiCredential |
| URL | https://oid.spherity.com/oid#LeiCredential |
euid
EUID technical structure (source):
<country code><business register code>.<domestic registration number>_<optional validation character>
Example from Bolagsverket: SEBOLREG.5560678965s
| Key | Value |
|---|---|
| Term | euid |
| URL | https://oid.spherity.com/oid#euid |
| Expected Value | string |
otherControlReason
Reason for Other Control of the Ultimate Beneficial Owner.
| Key | Value |
|---|---|
| Term | otherControlReason |
| URL | https://oid.spherity.com/oid#otherControlReason |
| Expected Value | string |
shareRelativeDirect
Percentage of Direct Shares in the Company Held by the Person.
| Key | Value |
|---|---|
| Term | shareRelativeDirect |
| URL | https://oid.spherity.com/oid#shareRelativeDirect |
| Expected Value | string |
votingRightsRelative
Total Percentage of Voting Rights in the Company Held Directly or Indirectly by the Person.
| Key | Value |
|---|---|
| Term | votingRightsRelative |
| URL | https://oid.spherity.com/oid#votingRightsRelative |
| Expected Value | string |
votingRightsRelativeDirect
Percentage of Direct Voting Rights of the Company Held by the Person.
| Key | Value |
|---|---|
| Term | votingRightsRelativeDirect |
| URL | https://oid.spherity.com/oid#votingRightsRelativeDirect |
| Expected Value | string |
votingRightsShare
Total Percentage of Voting Rights in the Company Held Directly or Indirectly by the Person.
| Key | Value |
|---|---|
| Term | votingRightsShare |
| URL | https://oid.spherity.com/oid#votingRightsShare |
| Expected Value | string |
NaturalPerson
A natural person describes a human who may act as a legal entity.
| Field | Description |
|---|---|
| familyName | Natural person's family name |
| givenName | Natural person's given name |
| gender | Natural person's specified gender |
| birthDate | Natural person's birth date |
| birthPlace | Natural person's birth place |
| postalAddress | Natural person's postal address |
| taxDomicile | Natural person's tax domicile |
| isAlive | Indicates if natural person is alive |
| jobTitle | Natural person's job title |
| citizenship | Natural person's citizenship |
| domicile | Natural person's current domicile |
familyName
Natural person's family name.
| Key | Value |
|---|---|
| Term | familyName |
| URL | http://schema.org/familyName |
givenName
Natural person's given name.
| Key | Value |
|---|---|
| Term | givenName |
| URL | http://schema.org/givenName |
gender
Natural person's specified gender.
| Key | Value |
|---|---|
| Term | gender |
| URL | http://schema.org/gender |
birthDate
Natural person's birth date.
| Key | Value |
|---|---|
| Term | birthDate |
| URL | http://schema.org/birthDate |
jobTitle
Natural person's job title.
| Key | Value |
|---|---|
| Term | familyName |
| URL | http://schema.org/jobTitle |
birthPlace
Natural person's birth place.
| Key | Value |
|---|---|
| Term | birthPlace |
| URL | http://schema.org/birthPlace |
postalAddress
Natural person's postal address.
| Key | Value |
|---|---|
| Term | postalAddress |
| URL | http://schema.org/PostalAddress |
taxDomicile
Natural person's tax domicile.
| Key | Value |
|---|---|
| Term | taxDomicile |
| URL | https://oid.spherity.com/oid#NaturalPerson_taxDomicile |
| Expected Value | http://schema.org/addressCountry |
isAlive
Indicates whether the natural person is alive.
| Key | Value |
|---|---|
| Term | isAlive |
| URL | https://oid.spherity.com/oid#NaturalPerson_isAlive |
| Expected Value | http://schema.org/Boolean |
citizenship
Natural person's citizenship.
| Key | Value |
|---|---|
| Term | citizenship |
| URL | https://oid.spherity.com/oid#NaturalPerson_citizenship |
| Expected Value | http://schema.org/addressCountry |
domicile
Natural person's current domicile.
| Key | Value |
|---|---|
| Term | domicile |
| URL | https://oid.spherity.com/oid#NaturalPerson_domicile |
adminUnitL1
Geographical name of the administrative unit (e.g. country)
| Key | Value |
|---|---|
| Term | adminUnitL1 |
| URL | https://oid.spherity.com/oid#NaturalPerson_domicile_adminUnitL1 |
| Expected Value | http://www.w3.org/ns/locn#adminUnitL1 |
postCode
Post code of the city
| Key | Value |
|---|---|
| Term | postCode |
| URL | https://oid.spherity.com/oid#NaturalPerson_domicile_postCode |
| Expected Value | http://www.w3.org/ns/locn#postCode |
postName
Reflects the city name
| Key | Value |
|---|---|
| Term | postName |
| URL | https://oid.spherity.com/oid#NaturalPerson_domicile_postName |
| Expected Value | http://www.w3.org/ns/locn#postName |
LegalPersonId
The Legal Person Identification Data uniquely identifies a legal person, as defined by the EWC.
| Field | Description |
|---|---|
| euid | Unique id for legal persons |
| companyName | Name of the company |
companyName
The name of the company as defined in the official company registers.
| Key | Value |
|---|---|
| Term | companyName |
| URL | https://oid.spherity.com/oid#LegalPersonId_companyName |
| Expected Value | https://schema.org/name |
Ebwoid
The EBWOID uniquely identifies a legal person, as defined by the EWC. Successor of LegalPersonId.
| Field | Description |
|---|---|
| euid | Unique id for legal persons |
| companyName | Name of the company |
companyName
The name of the company as defined in the official company registers.
| Key | Value |
|---|---|
| Term | companyName |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_companyName |
| Expected Value | https://schema.org/name |
LegalPersonBaseData
Description of a Legal Entity according to registry.
| Field |
|---|
| companyIdentifier |
| address |
| registerIdentification |
| previousName |
| status |
| liquidationStatus |
| insolvencyStatus |
| legalForm |
| isFoundation |
| isNfrdObligated |
| isTrust |
| businessObject |
| registrationDate |
| exchange |
| isin |
| vatId |
| ekrn |
| regulator |
| wz2008 |
| nace020 |
| lei |
| isOnOrganizedMarket |
| leiStatus |
| leiNextIssuance |
companyIdentifier
The unique identification number provided by Bundesanzeiger Verlag, which identifies the company to be checked (focus Legal Entity) or entity (as part of the MDMS service).
| Key | Value |
|---|---|
| Term | companyIdentifier |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_companyIdentifier |
| Expected Value | string |
address
Address of the Legal Person according to the address in the official register.
| Key | Value |
|---|---|
| Term | address |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_address |
adminUnitL1
Geographical name of the administrative unit (e.g. country)
| Key | Value |
|---|---|
| Term | adminUnitL1 |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_address_adminUnitL1 |
| Expected Value | http://www.w3.org/ns/locn#adminUnitL1 |
adminUnitL2
Geographical name of the administrative unit within the adminUnitL1 (e.g. state)
| Key | Value |
|---|---|
| Term | adminUnitL2 |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_address_adminUnitL2 |
| Expected Value | http://www.w3.org/ns/locn#adminUnitL2 |
addressArea
Area within the post code reagion (e.g. name of village)
| Key | Value |
|---|---|
| Term | addressArea |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_address_addressArea |
| Expected Value | http://www.w3.org/ns/locn#addressArea |
postCode
Post code of the city
| Key | Value |
|---|---|
| Term | postCode |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_address_postCode |
| Expected Value | http://www.w3.org/ns/locn#postCode |
postName
Reflects the city name
| Key | Value |
|---|---|
| Term | postName |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_address_postName |
| Expected Value | http://www.w3.org/ns/locn#postName |
thoroughfare
Reflects the street name
| Key | Value |
|---|---|
| Term | thoroughfare |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_address_thoroughfare |
| Expected Value | http://www.w3.org/ns/locn#thoroughfare |
locatorDesignator
House number and similar
| Key | Value |
|---|---|
| Term | locatorDesignator |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_address_locatorDesignator |
| Expected Value | http://www.w3.org/ns/locn#locatorDesignator |
registerIdentification
Information about the official register in which the focus company is registered.
| Key | Value |
|---|---|
| Term | registerIdentification |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_registerIdentification |
| Field | Description |
|---|---|
| registerType | Register code |
| registerTypeDescription | Registration authority |
| registerLocation | Name of the district court |
| registerNumber | Official identification number |
| companyId | Identification number of the company |
| companyIdCountryCode | Country code for the identification number |
registerType
Register code in which the focus company is registered according to the official register.
| Key | Value |
|---|---|
| Term | registerType |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_registerIdentification_registerType |
| Expected Value | string |
registerTypeDescription
Registration authority where the focus company is registered according to the official register.
| Key | Value |
|---|---|
| Term | registerTypeDescription |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_registerIdentification_registerType |
| Expected Value | string |
registerLocation
Name of the district court where the focus company is registered according to the official register.
| Key | Value |
|---|---|
| Term | registerLocation |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_registerIdentification_registerLocation |
| Expected Value | string |
registerNumber
Official identification number of the district court where the focus company is registered according to the official register.
| Key | Value |
|---|---|
| Term | registerNumber |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_registerIdentification_registerNumber |
| Expected Value | string |
companyId
Identification number of the company in the register (international) according to the official national register.
| Key | Value |
|---|---|
| Term | companyId |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_registerIdentification_companyId |
| Expected Value | string |
companyIdCountryCode
Country code for the identification number of the company in the register (international) according to the official national register.
| Key | Value |
|---|---|
| Term | companyIdCountryCode |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_registerIdentification_companyIdCountryCode |
| Expected Value | string |
previousName
Previous registered names of the focus company according to the official register
| Key | Value |
|---|---|
| Term | previousName |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_previousName |
| Expected Value | string |
status
Activity status of the focus company according to the official register.
| Key | Value |
|---|---|
| Term | status |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_status |
| Expected Value | string |
liquidationStatus
Liquidation status of the focus company.
| Key | Value |
|---|---|
| Term | liquidationStatus |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_liquidationStatus |
| Expected Value | string |
insolvencyStatus
Insolvency status of the focus company.
| Key | Value |
|---|---|
| Term | insolvencyStatus |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_insolvencyStatus |
| Expected Value | string |
legalForm
Legal form of the focus company according to the official register.
| Key | Value |
|---|---|
| Term | legalForm |
| URL | https://oid.spherity.com/oid#legalForm |
| Expected Value | string |
isFoundation
Indicates whether the focus company is a foundation.
| Key | Value |
|---|---|
| Term | isFoundation |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_isFoundation |
| Expected Value | https://schema.org/Boolean |
isNfrdObligated
Indicates whether the focus company is required to report under the Nfrd (Non financial reporting directive) with regard to the new CSRD - Corprate Sustainability Reporting Directive.
| Key | Value |
|---|---|
| Term | isNfrdObligated |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_isNfrdObligated |
| Expected Value | https://schema.org/Boolean |
isTrust
Indicates whether the focus company is a trust.
| Key | Value |
|---|---|
| Term | isTrust |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_isTrust |
| Expected Value | https://schema.org/Boolean |
businessObject
Description of the type of business activities of the company, including the type and purpose according to the official register.
| Key | Value |
|---|---|
| Term | businessObject |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_businessObject |
| Expected Value | string |
registrationDate
Date the company was registered.
| Key | Value |
|---|---|
| Term | registrationDate |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_registrationDate |
| Expected Value | https://schema.org/date |
exchange
Stock exchange of the focus Legal Entity.
| Key | Value |
|---|---|
| Term | exchange |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_exchange |
| Field | Description |
|---|---|
| name | Name of the stock exchange |
| country | Country of the stock exchange |
| marketIdentificationCode | Stock exchange identification code |
| ticketSymbol | Stock ticker symbol |
marketIdentificationCode
Stock exchange identification code of the focus Legal Entity.
| Key | Value |
|---|---|
| Term | country |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_exchange_marketIdentificationCode |
| Expected Value | string |
tickerSymbol
Stock ticker symbol of the focus Legal Entity.
| Key | Value |
|---|---|
| Term | ticketSymbol |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_exchange_tickerSymbol |
| Expected Value | string |
isin
ISIN - international securities identification number for the uniquely identified security of the focus Legal Entity.
| Key | Value |
|---|---|
| Term | isin |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_isin |
| Expected Value | string |
ekrn
EKRN (Uniform and Continuous Legal Entity Number) is the identification number assigned to the focus company by the transparency register upon initial registration.
| Key | Value |
|---|---|
| Term | ekrn |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_ekrn |
| Expected Value | string |
regulator
Descriptions of the responsible regulator.
| Key | Value |
|---|---|
| Term | regulator |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_regulator |
| Field | Description |
|---|---|
| name | Regulator name |
| regulatorId | Assigned ID |
| description | Classification of the type of entity |
regulatorId
Identification of whether the company is registered with BaFin (Federal Financial Supervisory Authority in Germany).
| Key | Value |
|---|---|
| Term | regulatorId |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_regulator_regulatorId |
| Expected Value | string |
description
Classification of the type of entity according to BaFin (Federal Financial Supervisory Authority in Germany) definition.
| Key | Value |
|---|---|
| Term | description |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_regulator_description |
| Expected Value | string |
wz2008
wz2008 industry description.
| Key | Value |
|---|---|
| Term | wz2008 |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_wz2008 |
| Expected Value | https://oid.spherity.com/oid#Industry |
nace020
nace020 industry description.
| Key | Value |
|---|---|
| Term | nace020 |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_nace020 |
| Expected Value | https://oid.spherity.com/oid#Industry |
lei
Company ID according to LEI (Legal Entity Identifier).
| Key | Value |
|---|---|
| Term | lei |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_lei |
| Expected Value | string |
isOnOrganizedMarket
Company ID according to LEI (Legal Entity Identifier).
| Key | Value |
|---|---|
| Term | isOnOrganizedMarket |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_isOnOrganizedMarket |
| Expected Value | https://schema.org/Boolean |
leiStatus
Status of the LEI (Legal Entity Identifier).
| Key | Value |
|---|---|
| Term | leiStatus |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_leiStatus |
| Expected Value | string |
leiNextIssuance
Next date for a new LEI (Legal Entity Identifier) issuance.
| Key | Value |
|---|---|
| Term | leiNextIssuance |
| URL | https://oid.spherity.com/oid#LegalPersonBaseData_leiNextIssuance |
| Expected Value | https://schema.org/date |
Industry
Description of Industries according defined by different authorities.
| Key | Value |
|---|---|
| Term | Industry |
| URL | https://oid.spherity.com/oid#Industry |
code
Standardized industry code.
| Key | Value |
|---|---|
| Term | code |
| URL | https://oid.spherity.com/oid#Industry_code |
| Expected Value | string |
industryDescription
Standardized industry description.
| Key | Value |
|---|---|
| Term | industryDescription |
| URL | https://oid.spherity.com/oid#Industry_description |
| Expected Value | string |
LegalPerson
Description of a Legal Person, including its business details and ownership information.
| Field | Description |
|---|---|
| businessYear | Information about the business year, including revenue, currency, employee count, balance, and date |
| ultimateBeneficiaryOwner | Details of the ultimate beneficiary owner, including person, capital, voting rights, other control, and fictitious entries |
| functionary | Information about the functionary associated with the Legal Person |
| shareholder | Information about shareholders |
| generalPartner | Information about general partners |
| directParentCompany | Information about the direct parent company |
| ultimateParentCompany | Information about the ultimate parent company |
| handoverFlag | Indicator whether there is a handover |
| handoverDescription | Description of the handover |
| evidence | Evidence related to the Legal Person |
businessYear
Details about the business year of the Legal Person.
| Key | Value |
|---|---|
| Term | businessYear |
| URL | https://oid.spherity.com/oid#LegalPerson_businessYear |
| Field | Description |
|---|---|
| revenue | Revenue of the Legal Entity during the business year |
| currency | Currency of the revenue |
| employeeCount | Number of employees during the business year |
| balance | Balance information for the business year |
| date | Date of the financial statements |
revenue
Revenue of the Legal Entity during the business year.
| Key | Value |
|---|---|
| Term | revenue |
| URL | https://oid.spherity.com/oid#LegalPerson_businessYear_revenue |
| Expected Value | string |
employeeCount
Number of employees during the business year.
| Key | Value |
|---|---|
| Term | employeeCount |
| URL | https://oid.spherity.com/oid#LegalPerson_businessYear_employeeCount |
| Expected Value | string |
balance
Balance information for the business year.
| Key | Value |
|---|---|
| Term | balance |
| URL | https://oid.spherity.com/oid#LegalPerson_businessYear_balance |
| Expected Value | https://oid.spherity.com/oid#Balance |
ultimateBeneficiaryOwner
Details of the ultimate beneficiary owner.
| Key | Value |
|---|---|
| Term | ultimateBeneficiaryOwner |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner |
| Field | Description |
|---|---|
| naturalPersonId | Natural person Id of the ultimate ultimate beneficiary owner |
| natureOfInterest | Element used to provide information about nature of interest |
| description | Textual description of the entity |
| ownershipType | Direct or indirect ownership |
| registrableDate | Date of UBO registration |
| inactiveDate | Specifies when the entity became inactive |
| lastChangeDate | Last date the UBO information was changed |
| capital | Details about the capital held by the ultimate beneficiary owner |
| votingRights | Information about the voting rights held by the ultimate beneficiary owner |
| otherControl | Other control details of the ultimate beneficiary owner |
| fictitious | Fictitious details of the ultimate beneficiary owner |
natureOfInterest
The element is used to provide information about nature of interest.
| Key | Value |
|---|---|
| Term | natureOfInterest |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_natureOfInterest |
| Expected Value | string |
description
Optional textual description of the entity.
| Key | Value |
|---|---|
| Term | description |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_description |
| Expected Value | string |
ownershipType
Specifies if the ownership is direct or indirect.
| Key | Value |
|---|---|
| Term | ownershipType |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_ownershipType |
| Expected Value | string |
registrableDate
Specifies the date the UBO was first registered.
| Key | Value |
|---|---|
| Term | registrableDate |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_registrableDate |
| Expected Value | http://schema.org/Date |
inactiveDate
Specifies the date the UBO became inactive.
| Key | Value |
|---|---|
| Term | inactiveDate |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_inactiveDate |
| Expected Value | http://schema.org/Date |
lastChangeDate
Specifies the date the UBO was last modified.
| Key | Value |
|---|---|
| Term | lastChangeDate |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_lastChangeDate |
| Expected Value | http://schema.org/Date |
naturalPersonId
Unique Id of the person who is the ultimate beneficiary owner. This Id is the Id of the credentials subject information of the natural person certificate providing all natural person information.
| Key | Value |
|---|---|
| Term | naturalPersonId |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_naturalPersonId |
| Expected Value | DID |
capital
Details about the capital held by the ultimate beneficiary owner.
| Key | Value |
|---|---|
| Term | capital |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_capital |
| Field | Description |
|---|---|
| share | Information about the share held |
| votingRightsRelativeDirect | Relative direct voting rights |
| shareRelativeDirect | Relative direct share |
share
This term appears multiple times in the document. Needs to be reviewed.
Information about the share held by the ultimate beneficiary owner.
| Key | Value |
|---|---|
| Term | share |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_capital_share |
| Expected Value | https://oid.spherity.com/oid#Share |
votingRights
Information about the voting rights held by the ultimate beneficiary owner.
| Key | Value |
|---|---|
| Term | votingRights |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_votingRights |
| Field | Description |
|---|---|
| share | Information about the share of voting rights |
| votingRightsRelativeDirect | Relative direct voting rights |
| votingRightsRelative | Relative voting rights |
| shareRelativeDirect | Relative direct share |
| otherControlReason | Reason for other control |
share
This term appears multiple times in the document. Needs to be reviewed.
Information about the share of voting rights held by the ultimate beneficiary owner.
| Key | Value |
|---|---|
| Term | share |
| URL | https://oid.spherity.com/oidLegalPerson_ultimateBeneficiaryOwner_votingRights_share |
| Expected Value | https://oid.spherity.com/oid#Share |
otherControl
Other control details of the ultimate beneficiary owner.
| Key | Value |
|---|---|
| Term | otherControl |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateBeneficiaryOwner_otherControl |
| Field | Description |
|---|---|
| share | Information about the share |
| votingRightsRelativeDirect | Relative direct voting rights |
| shareRelativeDirect | Relative direct share |
fictitious
Fictitious details of the ultimate beneficiary owner.
| Key | Value |
|---|---|
| Term | fictitious |
| URL | https://oid.spherity.com/oidLegalPerson_ultimateBeneficiaryOwner_fictitious |
| Field | Description |
|---|---|
| share | Information about the share |
| votingRightsRelativeDirect | Relative direct voting rights |
| shareRelativeDirect | Relative direct share |
share
This term appears multiple times in the document. Needs to be reviewed.
Information about the share in fictitious control.
| Key | Value |
|---|---|
| Term | share |
| URL | https://oid.spherity.com/oid#fictitiousShareLegalPerson_ultimateBeneficiaryOwner_fictitious_share) |
| Expected Value | https://oid.spherity.com/oid#Share |
functionary
Information about the functionary associated with the Legal Person
| Key | Value |
|---|---|
| Term | functionary |
| URL | https://oid.spherity.com/oid#LegalPerson_functionary |
| Field | Description |
|---|---|
| legalEntityId | Legal entity id of the functionary |
| role | Role of the functionary |
| isAuthorizedRepresentative | Indicator if the functionary is an authorized representative |
| isExclusionOfParagraph181 | Indicator if the functionary is excluded from Paragraph 181 |
| authorizationExtent | Extent of the functionary's authorization |
legalEntityId
Legal entity of the functionary.
| Key | Value |
|---|---|
| Term | legalEntityId |
| URL | https://oid.spherity.com/oid#LegalPerson_functionary_legalEntityId |
| Expected Value | DID |
role
Role of the functionary.
| Key | Value |
|---|---|
| Term | role |
| URL | https://oid.spherity.com/oid#LegalPerson_functionary_role |
| Expected Value | string |
isAuthorizedRepresentative
Indicator if the functionary is an authorized representative.
| Key | Value |
|---|---|
| Term | isAuthorizedRepresentative |
| URL | https://oid.spherity.com/oid#LegalPerson_functionary_isAuthorizedRepresentative |
| Expected Value | https://schema.org/Boolean |
isExclusionOfParagraph181
Indicator if the functionary is excluded from Paragraph 181.
| Key | Value |
|---|---|
| Term | isExclusionOfParagraph181 |
| URL | https://oid.spherity.com/oid#LegalPerson_functionary_isExclusionOfParagraph181 |
| Expected Value | https://schema.org/Boolean |
authorizationExtent
Extent of the functionary's authorization.
| Key | Value |
|---|---|
| Term | authorizationExtent |
| URL | https://oid.spherity.com/oid#LegalPerson_functionary_authorizationExtent |
| Expected Value | string |
shareholder
Information about shareholders.
| Key | Value |
|---|---|
| Term | shareholder |
| URL | https://oid.spherity.com/oid#LegalPerson_shareholder |
| Expected Value | https://oid.spherity.com/oid#Shareholder |
generalPartner
Information about general partners.
| Key | Value |
|---|---|
| Term | generalPartner |
| URL | https://oid.spherity.com/oid#LegalPerson_generalPartner |
| Expected Value | [https://oid.spherity.com/oid#Shareholder |
directParentCompany
Unique Id of the direct parent company. This Id is the Id of the credential subject of the legal entity certificate.
| Key | Value |
|---|---|
| Term | directParentCompany |
| URL | https://oid.spherity.com/oid#LegalPerson_directParentCompany |
| Expected Value | DID |
ultimateParentCompany
Unique Id of the ultimate parent company. This Id is the Id of the credential subject of the legal entity certificate.
| Key | Value |
|---|---|
| Term | ultimateParentCompany |
| URL | https://oid.spherity.com/oid#LegalPerson_ultimateParentCompany |
| Expected Value | DID |
handoverFlag
Indicator whether there is a handover.
| Key | Value |
|---|---|
| Term | handoverFlag |
| URL | https://oid.spherity.com/oid#LegalPerson_handoverFlag |
| Expected Value | https://schema.org/Boolean |
handoverDescription
Description of the handover.
| Key | Value |
|---|---|
| Term | handoverDescription |
| URL | https://oid.spherity.com/oid#LegalPerson_handoverDescription |
| Expected Value | string |
evidence
Evidence related to the Legal Entity.
| Key | Value |
|---|---|
| Term | evidence |
| URL | https://oid.spherity.com/oid#LegalPerson_evidence |
| Expected Value | https://oid.spherity.com/oid#Evidence |
Balance
Balance information for the Legal Entity.
| Key | Value |
|---|---|
| Term | Balance |
| URL | https://oid.spherity.com/oid#Balance |
| Field | Description |
|---|---|
| amount | Amount of the balance |
| currency | Currency of the balance |
amount
Amount of the balance.
| Key | Value |
|---|---|
| Term | amount |
| URL | https://oid.spherity.com/oid#Balance_amount |
| Expected Value | string |
Share
Information about shares.
| Key | Value |
|---|---|
| Term | Share |
| URL | https://oid.spherity.com/oid#Share |
| Field | Description |
|---|---|
| relative | Relative share value |
| absolute | Absolute share value |
| absoluteInEur | Absolute share value in EUR |
| isDirectShare | Indicator if it is a direct share |
relative
Relative share value.
| Key | Value |
|---|---|
| Term | relative |
| URL | https://oid.spherity.com/oid#Share_relative |
| Expected Value | string |
absolute
Absolute share value.
| Key | Value |
|---|---|
| Term | absolute |
| URL | https://oid.spherity.com/oid#Share_absolute |
| Expected Value | https://oid.spherity.com/oid#Balance |
absoluteInEur
Absolute share value in EUR.
| Key | Value |
|---|---|
| Term | absoluteInEur |
| URL | https://oid.spherity.com/oid#Share_absoluteInEur |
| Expected Value | https://oid.spherity.com/oid#Balance |
isDirectShare
Indicator if it is a direct share.
| Key | Value |
|---|---|
| Term | isDirectShare |
| URL | https://oid.spherity.com/oid#Share_isDirectShare |
| Expected Value | https://schema.org/Boolean |
Shareholder
Information about shareholders.
| Key | Value |
|---|---|
| Term | Shareholder |
| URL | https://oid.spherity.com/oid#Shareholder |
| Field | Description |
|---|---|
| legalEntityId | Legal entity Id of the shareholder |
| share | Share information |
| votingRightsRelative | Relative voting rights |
legalEntityId
This term should be checked
Legal Entity Id of the shareholder. This Id is the Id of the credential subject of the legal entity certificate.
| Key | Value |
|---|---|
| Term | legalEntityId |
| URL | https://oid.spherity.com/oid#Shareholder_legalEntityId |
| Expected Value | DID |
share
This term appears multiple times in the document. Needs to be reviewed
Share information of the shareholder.
| Key | Value |
|---|---|
| Term | share |
| URL | https://oid.spherity.com/oid#Shareholder_share |
| Expected Value | https://oid.spherity.com/oid#Share |
ShareholderLegalPerson
Information about Legal Persons who are shareholders.
| Key | Value |
|---|---|
| Term | ShareholderLegalPerson |
| URL | https://oid.spherity.com/oid#ShareholderLegalPerson |
| Field | Description |
|---|---|
| handover | Handover information |
| handoverDescription | Description of the handover |
| shareholder | Information about the shareholder |
| generalPartner | Information about the general partner |
handover
Handover information for the Legal Person.
| Key | Value |
|---|---|
| Term | handover |
| URL | https://oid.spherity.com/oid#ShareholderLegalPerson_handover |
| Expected Value | https://schema.org/Boolean |
handoverDescription
Description of the handover.
| Key | Value |
|---|---|
| Term | handoverDescription |
| URL | https://oid.spherity.com/oid#ShareholderLegalPerson_handoverDescription |
| Expected Value | string |
shareholder
Information about the shareholder.
| Key | Value |
|---|---|
| Term | shareholder |
| URL | https://oid.spherity.com/oid#ShareholderLegalPerson_shareholder |
| Expected Value | https://oid.spherity.com/oid#Shareholder |
generalPartner
Information about the general partner.
| Key | Value |
|---|---|
| Term | generalPartner |
| URL | https://oid.spherity.com/oid#ShareholderLegalPerson_generalPartner |
| Expected Value | https://oid.spherity.com/oid#Shareholder |
Evidence
Evidence related to the Legal Entity.
| Key | Value |
|---|---|
| Term | Evidence |
| URL | https://oid.spherity.com/oid#Evidence |
| Field | Description |
|---|---|
| source | Source of the evidence |
| verifiedField | Verified field |
| verificationDate | Date of verification |
source
Source of the evidence.
| Key | Value |
|---|---|
| Term | source |
| URL | https://oid.spherity.com/oid#Evidence_source |
| Expected Value | string |
verifiedField
Verified field in the evidence.
| Key | Value |
|---|---|
| Term | verifiedField |
| URL | https://oid.spherity.com/oid#Evidence_verifiedField |
| Expected Value | string |