---
id: mdo-da-vocab-1.1
title: Data Agreement Vocab - Version 1.1
sidebar_label: Version 1.1
slug: /data-agreements/v1.1
---

> **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 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/automated-data-agreements/main/interface-specs/data-agreement-schema/v1/data-agreement-schema-context.jsonld |

## id

**Description:** Identifier to the data agreement instance addressed to a specific individual (Data Subject).

| @type                                      | Example value(s)                     |
| :----------------------------------------- | :----------------------------------- |
| https://dictionary.mydata.org/prodserv/#uid | b728d03e-c983-4322-8a46-2bf126b403de |

## version

**Description:** Version number of the data agreement

| @type                      | Example value(s) |
| :------------------------- | :--------------- |
| https://schema.org/version | v1.0.0           |

## template_id

**Description:** Identifier to the template of the data agreement.

| @type                                      | Example value(s)                     |
| :----------------------------------------- | :----------------------------------- |
| https://dictionary.mydata.org/prodserv/#uid | 91be609a-4acd-468f-b37a-0f379893b65c |

## template_version

**Description:** Version number of the data agreement template

| @type                      | Example value(s) |
| :------------------------- | :--------------- |
| https://schema.org/version | v1.0.0           |

## data_controller_name

**Description:** An organisation constituted as a legally defined entity in any jurisdiction.

| @type                                      | Example value     |
| :----------------------------------------- | :---------------- |
| https://w3c.github.io/dpv/dpv/#LegalEntity | Happy Shopping AB |

## data_controller_url

**Description:** Organisation or data controller URL.

| @type                  | Example value         |
| :--------------------- | :-------------------- |
| https://schema.org/URL | www.happyshopping.com |

## data_controller_legal_id

**Description:** This is the legal ID to the data controller

| @type                      | Example value                                                           |
| :------------------------- | :---------------------------------------------------------------------- |
| https://schema.org/leiCode | Organisation number, e.g. Swedish org no. 559133-2720, DUNS number etc. |

## 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)       |
| :------------------------------- | :--------------------- |
| http://www.w3.org/ns/dpv#Purpose | Marketing and Campaign |

## purpose_description

**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://schema.org/Text | Collecting user data for offering custom tailored shopping experience |

## lawful_basis

**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 |
| :---------------------------------- | :------------ |
| http://www.w3.org/ns/dpv#LegalBasis | consent       |

## method_of_use

**Description:** This is used to describe whether controller is using personal data for internal purposes of for data exchange towards an external third party. Data exchange could be for exposing data (as a Data Source) or consuming data as a Data Using Service.

| @type                   | Example value(s)                    |
| :---------------------- | :---------------------------------- |
| https://schema.org/Text | null/data-source/data-using-service |

## policy

Description: Encapsulate the data policies used in the use of personal data.

### data_retention_period

**Description:** The amount of time that an organization holds onto any personal data, in days.

| @type                     | Example value |
| :------------------------ | :------------ |
| https://schema.org/Number | 30            |

:::Note
**Example:** GDPR does not specify retention periods for personal data. Instead, it states that personal data may only be kept in a form that permits identification of the individual for no longer than is necessary for the purposes for which it was processed. Typical limit is for 3 years.
:::

### geographic_restriction

**Description:** The geographic restrictions required or followed regarding storage of data.

| @type                                             | Example value |
| :------------------------------------------------ | :------------ |
| https://w3c.github.io/dpv/dpv/#StorageRestriction | Europe        |

### industry_sector

**Description:** Indicate or restrict scope for interpretation and application of purpose in a domain.

| @type                                 | Example value |
| :------------------------------------ | :------------ |
| https://w3c.github.io/dpv/dpv/#Sector | Public        |

### jurisdiction

**Description:** Indicates a legal jurisdiction, e.g. of some legislation, or where some government service is based.

| @type                           | Example value |
| :------------------------------ | :------------ |
| https://schema.org/jurisdiction | Sweden        |

### policy_url

**Description:** A URL specifying the privacy policy that discloses some or all of the ways an organisation gathers, uses, discloses, and manages a customer or client's personal data.

| @type                  | Example value                            |
| :--------------------- | :--------------------------------------- |
| https://schema.org/URL | https://happyshoping.com/privacy-policy/ |

### storage_location

**Description:** The geographic location where the personal data is stored

| @type                                    | Example value |
| :--------------------------------------- | :------------ |
| http://www.w3.org/ns/dpv#StorageLocation | Europe        |

### third_party_disclosure

**Description:** This is a boolean value to indicate that the DA is used for third party data disclosures. This indicates that some data disclosures will happen and is used to release personal data to DUS based on an agreement

| @type                      | Example value |
| :------------------------- | :------------ |
| https://schema.org/Boolean | True or False |

### code_of_conduct

**Description:** The data controller may follow a code of conduct which sets the proper application of privacy regulation taking into account specific features within a sector. The code of conduct shall reference the name of the code of conduct and with a public accessible reference.

| @type                  | Example value                             |
| :--------------------- | :---------------------------------------- |
| https://schema.org/URL | https://happyshoping.com/code-of-conduct/ |

## personal_data []

**Description:** Encapsulates the attributes used for the the usage purpose defined. Its an array of personal data attributes.

### attribute_category

**Description:** A category of personal data.

| @type                                         | Example value(s) |
| :-------------------------------------------- | :--------------- |
| http://www.w3.org/ns/dpv#PersonalDataCategory | Personal, Health |

### attribute_id

**Description:** Identifiery for the attribute.

| @type                                      | Example value(s)                    |
| :----------------------------------------- | :---------------------------------- |
| https://dictionary.mydata.org/prodserv/#uid | f216cb1-aedb-571e-46f7-2fef51dedb54 |

### attribute_name

**Description:** Name of the attribute

| @type                   | Example value(s) |
| :---------------------- | :--------------- |
| https://schema.org/Text | Name             |

### attribute_sensitive

**Description:** Indicates that personal data is sensitive or belongs to a special category as per a regulations, typically requiring additional measures of handling.

| @type                      | Example value(s) |
| :------------------------- | :--------------- |
| https://schema.org/Boolean | true             |

### attribute_retrictions []

**Description:** [OPTIONAL] If provided, this can be used t restrict where the data is being consumed from. Its an array of attribute retrictions

| @type                         | Example value(s) |
| :---------------------------- | :--------------- |
| https://schema.org/Collection | NIL              |

## dpia

**Description:** Encapsulate the organisation performing the Data Protection Impact Assessment (DPIA).

### date

**Description:** The date on which the DPIA report is generated after a DPIA.

| @type                       | Example value             |
| :-------------------------- | :------------------------ |
| https://schema.org/DateTime | 2021-05-08T08:41:59+0000" |

### summary_url

**Description:** The URl providing the DPIA result reports, summary etc that can be verified by any interested parties.

| @type                  | Example value                     |
| :--------------------- | :-------------------------------- |
| https://schema.org/URL | https://org.com/dpia_results.html |

## event

**Description:** Encapsulates the data agreement lifecyle event data. For e.g. Data Agreement Offer, Accept, Reject, Terminate etc.

### did

**Description:** The DID associated with the entity executing the event. E.g. An organisation (Data Controller) or an Individual (Data Subject).

| @type                                                                                                                    | Example value                                               |
| :----------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| https://github.com/decentralised-dataexchange/automated-data-agreements/blob/main/docs/did-spec.md#2the-didmydata-format | did:mydata:z6MkiTBz1ymuepAQ4HEHYSF1H8quG5GLVVQR3djdX3mDooWp |

### id

**Description:** The identifier of the event.

| @type                                      | Example value                        |
| :----------------------------------------- | :----------------------------------- |
| https://dictionary.mydata.org/prodserv/#uid | 3da6f76e-598c-11ec-bf63-0242ac130002 |

### state

**Description:** The current state of the event during a data agreement lifecycle. E.g. Offer, Accept, Reject and Terminate

| @type                   | Example value |
| :---------------------- | :------------ |
| https://schema.org/Text | Offer         |

### timestamp

**Description:** The time at which the event occurred.

| @type                       | Example value            |
| :-------------------------- | :----------------------- |
| https://schema.org/DateTime | 2021-05-08T08:41:59+0000 |

## data_subject_did

**Description:** Decentralised Identifier (DID) of the individual (Data Subject)

| @type                                                                                                                    | Example value(s)                                            |
| :----------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| https://github.com/decentralised-dataexchange/automated-data-agreements/blob/main/docs/did-spec.md#2the-didmydata-format | did:mydata:z6MkGskxnGjLrk3gKS2mesDpuwRBokeWcmrgHxUXfnncxiZP |

## proof

**Description:** Encapsulates the event signatures that allows anyone (e.g. an auditor) to verify the authencity and source of the data 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 |

## revocation_list

**Description:** Link to the storage location of the recocation list for the agreement

| @type                  | Example value(s)                        |
| :--------------------- | :-------------------------------------- |
| https://schema.org/URL | https://www.org.com/revocation:list.crl |

## data_expiry

**Description:** Expiry for the agreement (in epoch time - seconds)

| @type                       | Example value(s)     |
| :-------------------------- | :------------------- |
| https://schema.org/Duration | Epoc time in seconds |