# Data space description

{% hint style="info" %}
**Note**

The data space description is optional.
{% endhint %}

Data Spaces Governance Bodies may maintain a data space description document, to provide more structured information about the Data Space. A URL pointing to this document may be included in the [Data Spaces endpoint](https://dev.ishare.eu/participant-registry-role/dataspaces) using the `dataSpaceDescriptionUrl` attribute. The format for this JSON document is provided below and expected to be self-explanatory.

{% hint style="info" %}
This document was introduced as a first draft in iSHARE 3.0 and is expected to undergo transformations in upcoming iSHARE versions.
{% endhint %}

```json
{
  "dataSpaceDescription": {
    "version": {
      "number": "1.0",
      "date": "2025-10-01",
      "description": "Initial version of the Data Space Description document."
    },
    "baseProfile": {
      "dataSpaceId": "EU.NL.EXAMPLE.ID",
      "name": "Example Data Space",
      "description": "This is an example data space for demonstration purposes.",
      "website": "https://example.com",
      "status": "operational",
      "countryOfRegistration": "NL",
      "countriesOperation": ["NL", "DE", "FR"],
      "tags": ["tag1", "tag2"],
      "sectors": ["roadTransport", "logistics"]
    },
    "dataSpaceGovernanceBody": {
      "id": "EXAMPLE-ID",
      "name": "Example Governance Body",
      "website": "https://governance.example.com",
      "email": "governance@example.com",
      "description": "Example description of the governance body."
    },
    "frameworks": [
      {
        "type": "trustFramework",
        "name": "iSHARE",
        "version": "3.0",
        "website": "https://framework.ishare.eu",
        "description": "Trust Framework applied in the data space."
      },
      {
        "type": "architectureFramework",
        "name": "IDSA Reference Architecture",
        "version": "4.0",
        "website": "https://internationaldataspaces.org/architecture/",
        "description": "Reference architecture applied in the Data Space."
      }
    ],
    "trustAnchors": [
      {
        "id": "did:ishare:NTRNL-10000000",
        "name": "Participant Registry",
        "type": "iSHAREParticipantRegistry",
        "version": "3.0",
        "url": "https://registry.example.com",
        "description": "iSHARE Participant Registry for managing participants in the Data Space."
      }
    ],
    "participantIdentifiers": [
      {
        "name": "iSHARE-DID",
        "prefix": "did:ishare:[Continent code][Country code]",
        "suffix": "",
        "uri": "https://did.ishare.eu/",
        "description": "Participants in this Data Space are identified using iSHARE-IDs.",
        "defaultIdentifier": true
      },
      {
        "name": "Chamber of Commerce",
        "prefix": "EU.NL.kvk:",
        "suffix": "",
        "uri": "https://www.kvk.nl/",
        "description": "Participants in this Data Space are identified using KvK(Chamber of Commerce) numbers.",
        "defaultIdentifier": false
      }
    ],
    "technologyStandards": [
      {
        "name": "Verifiable Credentials",
        "uri": "https://www.w3.org/ns/credentials/v2",
        "version": "2.0",
        "website": "https://www.w3.org/TR/vc-data-model-2.0/",
        "description": "Verifiable Credentials are applied in the data space."
      }
    ],
    "dataModels": [
      {
        "type": "ontology",
        "name": "Open Trip Model",
        "uri": "https://w3id.org/opentripmodel/",
        "version": "5.7",
        "website": "https://opentripmodel.org/",
        "description": "The Open Trip Model.",
        "technology": "https://www.w3.org/2011/gld/"
      }
    ],
    "dataSpaceServices": [
      {
        "name": "Vocabulary Hub",
        "type": "vocabularyService",
        "version": "1.0",
        "identifier": "vocabhub",
        "descriptionURL": "https://vocabhub.example.com/apidesc",
        "description": "a service implemented by all participants of this dataspace who plays vocabulary provider role",
        "api": "https://vocabhub.example.com/api"
      },
      {
        "name": "Container ETA",
        "type": "dataspaceService",
        "version": "1.0",
        "identifier": "containerETA",
        "descriptionURL": "https://service.example.com/containereta",
        "description": "a service implemented by all participants of this dataspace who plays transporter role"
      }
    ],
    "dataspaceRoles": [
      {
        "type": "role",
        "name": "Provider",
        "id": "provider"
      },
      {
        "type": "role",
        "name": "Consumer",
        "id": "consumer"
      },
      {
        "type": "role",
        "name": "Data rights holder",
        "id": "datarightsholder"
      }
    ]
  }
}
```