# 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](/participant-registry-role/dataspaces.md) 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"
      }
    ]
  }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.ishare.eu/reference/data-space-description.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.