--- id: mdo-dda-vocab-1.0 title: Data Disclosure Agreement Vocab - Version 1.0 sidebar_label: Version 1.0 slug: /data-disclosure-agreements/v1.0 --- > **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration: > > ```bash > npx skills add L3-iGrant/skills > ``` The Data Disclosure Agreement Vocabulary provides terms to describe and represent information related to processing of personal data based on established requirements such as for the EU General Data Protection Regulation (GDPR). ## @context **Description:** Defines the context of any this document. E.g. the link to the JSON-LD | @type | Example value(s) | | :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | | https://schema.org/URL | https://raw.githubusercontent.com/decentralised-dataexchange/data-exchange-agreements/main/interface-specs/jsonld/contexts/dexa-context.jsonld | ## @id **Description:** Identifier to the Data Disclosure Agreement instance addressed to an Organisation (Data Using Service). | @type | Example value(s) | | :----------------------------------------- | :----------------------------------- | | https://dictionary.mydata.org/prodserv/#uid | b728d03e-c983-4322-8a46-2bf126b403de | ## language **Description:** Language of the Data Disclosure Agreement | @type | Example value(s) | | :---------------------------------------------- | :--------------- | | https://dictionary.mydata.org/prodserv/#language | v1.0.0 | ## version **Description:** Version number of the Data Disclosure Agreement | @type | Example value(s) | | :------------------------- | :--------------- | | https://schema.org/version | 0.0.1 | ## templateId **Description:** Identifier to the template of the Data Disclosure Agreement. | @type | Example value(s) | | :----------------------------------------------------------------------- | :----------------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#templateId | 91be609a-4acd-468f-b37a-0f379893b65c | ## templateVersion **Description:** Version number of the Data Disclosure Agreement template | @type | Example value(s) | | :---------------------------------------------------------------------------- | :--------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#templateVersion | 0.0.1 | ## dataController **Description:** An organisation constituted as a legally defined entity in any jurisdiction. | @type | Example value | | :--------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dataController | nil | ## dcDid **Description:** Data controller decentralised identifier | @type | Example value | | :------------------------------------------------------------------ | :------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dcDid | did:mydata:abc | ## dcIndustrySector **Description:** Data controller industry sector | @type | Example value | | :----------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dcIndustrySector | Retail | ## dcLegalId **Description:** Data controller legal identifier | @type | Example value | | :---------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dcLegalId | lei:abc | ## dcName **Description:** Data controller name | @type | Example value | | :------------------------------------------------------------------- | :---------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dcName | Happy Shopping AB | ## dcURL **Description:** Data controller URL | @type | Example value | | :------------------------------------------------------------------ | :------------------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dcURL | https://happyshopping.com | ## agreementPeriod **Description:** Agreement period | @type | Example value | | :---------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#agreementPeriod | 365 | ## purpose **Description:** Describes the purpose for which a data controller (Data Source or Data Using Service) uses personal data for. This is also the purpose for which the data agreeent is being formulated | @type | Example value(s) | | :-------------------------------------------------------------------- | :--------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#purpose | Marketing and Campaign | ## purposeDescription **Description:** Provides description of the purpose for which the personal data us used, comprehensive to the individual whose data is being used by the data controller. | @type | Example value(s) | | :------------------------------------------------------------------------------- | :-------------------------------------------------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#purposeDescription | Collecting user data for offering custom tailored shopping experience | ## lawfulBasis **Description:** An organization processing personal data to have a valid lawful basis for that personal data processing activity. GDPR, for e.g., provides six legal bases for processing personal data, consent being one. Possible values as per GDPR are: consent, legal_obligation, contract, vital_interest, public_task and legitimate_interest. | @type | Example value | | :------------------------------------------------------------------------ | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#lawfulBasis | consent | ## codeOfConduct **Description:** Code of conduct | @type | Example value | | :-------------------------------------------------------------------------- | :--------------------------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#codeOfConduct | https://happyshopping.com/code_of_conduct.html | ## personalData **Description:** Personal data exposed by the Data Source | @type | Example value | | :------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#personalData | nil | ## pdAttributeId **Description:** Personal data attribute ID | @type | Example value | | :-------------------------------------------------------------------------- | :----------------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#pdAttributeId | a601c468-4d26-41e1-8ad9-30eb16746751 | ## pdAttributeName **Description:** Personal data attribute name | @type | Example value | | :---------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#pdAttributeName | Customer ID | ## pdAttributeSensitive **Description:** Personal data attribute sensitive | @type | Example value | | :--------------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#pdAttributeSensitive | true | ## pdAttributeCategory **Description:** Personal data attribute category | @type | Example value | | :-------------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#pdAttributeCategory | KYC | ## dataUsingService **Description:** Data Using Service | @type | Example value | | :----------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dataUsingService | nil | ## dusDid **Description:** Data Using Service decentralised identifier | @type | Example value | | :------------------------------------------------------------------- | :-------------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusDid | did:mydata:3Wcyfb5QZ7mvtBXrY8Jg3h | ## dusIndustrySector **Description:** Data Using Service industry sector | @type | Example value | | :------------------------------------------------------------------------------ | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusIndustrySector | Retail | ## dusJurisdiction **Description:** Data Using Service jurisdiction | @type | Example value | | :---------------------------------------------------------------------------- | :------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusJurisdiction | EU | ## dusLegalId **Description:** Data Using Service legal ID | @type | Example value | | :----------------------------------------------------------------------- | :------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusLegalId | lei:3Wcyfb5QZ7mvtBXrY8Jg3h | ## dusName **Description:** Data Using Service name | @type | Example value | | :-------------------------------------------------------------------- | :---------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusName | Happy Shopping AB | ## dusPrivacyRights **Description:** Data Using Service privacy rights | @type | Example value | | :----------------------------------------------------------------------------- | :---------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusPrivacyRights | https://retail.se/policy.html | ## dusSignatureContact **Description:** Data Using Service signature contact | @type | Example value | | :-------------------------------------------------------------------------------- | :----------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusSignatureContact | did:sov:3Wcyfb5QZ7mvtBXrY8Jg3h | ## dusUrl **Description:** Data Using Service URL | @type | Example value | | :------------------------------------------------------------------- | :------------------------------------ | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusUrl | https://happyshopping.com/policy.html | ## dusUsagePurposes **Description:** Data Using Service purposes | @type | Example value | | :----------------------------------------------------------------------------- | :-------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusUsagePurposes | Account transaction history | ## dusWithdrawal **Description:** Data Using Service withdrawal | @type | Example value | | :-------------------------------------------------------------------------- | :-------------------------------- | | https://docs.igrant.io/schema/data-disclosure-agreement/v1.0/#dusWithdrawal | https://retail.se/withdrawal.html | ## proof **Description:** Encapsulates the event signatures that allows anyone (e.g. an auditor) to verify the authencity and source of the Data Disclosure Agreement. Its uses linked data proofs as per W3C and contains a set of attributes that represent a Linked Data digital proof and the parameters required to verify it. ### id **Description:** Identifier of the proof | @type | Example value(s) | | :----------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ | | https://github.com/decentralised-dataexchange/automated-data-agreements/blob/main/docs/did-spec.md#2the-didmydata-format | did:mydata:z6MkiTBz1ymuepAQ4HEHYSF1H8quG5GLVVQR3djdX3mDooWp#1 | ### type **Description:** Type of the proof | @type | Example value(s) | | :----------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ | | https://github.com/decentralised-dataexchange/automated-data-agreements/blob/main/docs/did-spec.md#2the-didmydata-format | did:mydata:z6MkiTBz1ymuepAQ4HEHYSF1H8quG5GLVVQR3djdX3mDooWp#1 | ### created **Description:** Creation time of the proof | @type | Example value(s) | | :---------------------------------------- | :----------------------- | | http://www.w3.org/2001/XMLSchema#dateTime | 2021-05-08T08:41:59+0000 | ### proofPurpose **Description:** Purpose of the proof | @type | Example value(s) | | :------------------------------------- | :---------------- | | https://w3id.org/security#proofPurpose | contractAgreement | ### proofValue **Description:** Value of the proof (Signature digest) | @type | Example value(s) | | :----------------------------------- | :----------------------------------------------------------------------------------------------- | | https://w3id.org/security#proofValue | z6MkwW6aqMnjgrhJXFUko3NnZPGzVpkNzhYK7yEhnsibmLwLz6MkwW6aqMnjgrhJXFUko3NnZPGzVpkNzhYK7yEhnsibmLwL | ### verificationMethod **Description:** Method of verification for the proof | @type | Example value(s) | | :----------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- | | https://github.com/decentralised-dataexchange/automated-data-agreements/blob/main/docs/did-spec.md#2the-didmydata-format | did:mydata:z6MkiTBz1ymuepAQ4HEHYSF1H8quG5GLVVQR3djdX3mDooWp |