Data space description

Note

The data space description is optional.

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 using the dataSpaceDescriptionUrl attribute. The format for this JSON document is provided below and expected to be self-explanatory.

This document was introduced as a first draft in iSHARE 3.0 and is expected to undergo transformations in upcoming iSHARE versions.

{
  "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": "[email protected]",
      "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"
      }
    ]
  }
}