# Dataspaces

{% openapi src="<https://raw.githubusercontent.com/iSHAREScheme/openapi/v2.0/ishare_openapi_spec.yaml>" path="/dataspaces" method="get" %}
<https://raw.githubusercontent.com/iSHAREScheme/openapi/v2.0/ishare_openapi_spec.yaml>
{% endopenapi %}

### Response model

**Decoded dataspace\_list\_token parameters:**

It contains [iSHARE compliant JWT claims](/version-2.0.1/reference/ishare-jwt.md). In addition to that it also contains the following parameters:

* `dataspace_info`\
  **Array of Objects**. Root level.\
  Contains results counts and information about dataspaces.
  * `total_count`\
    **String**.\
    Contained in the object of `dataspace_info`.\
    Total count of found dataspaces.
  * `pageCount`\
    **String**. Contained in the object of `dataspace_info`.\
    Number of pages (10 per page).
  * `count`\
    **String**. Contained in the object of `dataspace_info`.\
    Number of dataspaces returned.
  * `data`\
    **Array of Objects**.\
    Contained in the object of `dataspace_list_token`.\
    Array containing a collection of dataspace objects.
    * `dataspace_title`\
      **String**. Contained in the object of `data`.\
      Title of dataspace.
    * `dataspace_id`\
      **String**. Contained in the object of `data`.\
      Unique ID of the dataspace. This is in format of \<Continent>.\<DS>.<3 letter code for dataspaces>.\<Country>.\<dataspace name> for example EU.DS.GND.NL.DVU. Where, continent is 2 letter code, followed by "DS" (stands for dataspace), followed by 3 letter code of common eu dataspaces HLT - Health, INM - Industrial and Manufacturing, AGR - Agriculture, FIN - Finance, MOB - Mobility, GND - Green Deal, ENR - Energy, PUB - Public Administration, SKL - Skills, followed by ISO 3166-1 alpha-2 2 letter Country code and lastly the name/title of the dataspace. Name may not contain spaces or dot "." or other special characters. Maximum length of name can be 15 characters.
    * `dataspacedef_url`\
      **String**. Contained in the object of `data`.\
      URL pointing to the dataspace definition. This is expected to be based on OpenDEI model of building blocks for dataspaces. The machine redable format definition is currently under development. The specifications will be made available once published.
    * `dataspace_website`\
      **String**. Contained in the object of `data`.\
      Website address of the dataspace, typically dataspace authority. The website details out more information about the datasapce and guides (potential) participants (to become member of) the dataspace.
    * `tags`\
      **String**. Contained in the object of `data`.\
      Free text field for addting relevant tags that are relevant in the context of datasapce. Useful for searching for specific dataspaces based on tags.
    * `status`\
      **String**. Contained in the object of `data`.\
      Status of the dataspace. Available values are *new*, *in progress*, *active* and *not active*.
    * `country_reg`\
      **String**. Contained in the object of `data`.\
      Country in which the dataspace is registered in.
    * `countries_operation`\
      **Array**. Contained in the object of `data`.\
      Array of country names in which the dataspace operates.
    * `sectors`\
      **Array**. Contained in the object of `data`.\
      Array of sector names in which the dataspace operates.

### Example request

```
> Authorization: Bearer IIeDIrdnYo2ngwDQYJKoZIhvcNAQELBQAwSDEZMBcGA1UEAwwQaVNIQ

GET /dataspaces
```

### Example response

The response contains an encoded JWT, which looks like this:

```json
< Content-Type: application/json

{
  "dataspace_list_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsIng1YyI6WyJNSUlENkRDQ0F0Q2dBd0lCQWdJSUNwSHRUOUIvTGZVd0RRWUpLb1pJaHZjTkFRRUxCUUF3UERFNk1EZ0dBMVVFQXd3eFZFVlRWQ0JwVTBoQlVrVWdSVlVnU1hOemRXbHVaeUJEWlhKMGFXWnBZMkYwYVc5dUlFRjFkR2h2Y21sMGVTQkhOVEFlRncweU16QXlNalF4TmpRek1UTmFGdzB6TXpBeU1qRXhOalF6TVRKYU1IUXhIREFhQmdOVkJBTU1FMmxUU0VGU1JTQlRZMmhsYldVZ1QzZHVaWEl4SERBYUJnTlZCQVVURTBWVkxrVlBVa2t1VGt3d01EQXdNREF3TURBeEZEQVNCZ05WQkFzTUMxUmxjM1FnWVc1a0lGRkJNUk13RVFZRFZRUUtEQXBwVTBoQlVrVlVaWE4wTVFzd0NRWURWUVFHRXdKT1REQ0NBU0l3RFFZSktvWklodmNOQVFFQkJRQURnZ0VQQURDQ0FRb0NnZ0VCQUp5ems3dnlzdHhKUS9NQ3hTTWF3NHYwdllvOGcya2UxdTZPcElTUUkwTkI4SzBnR1pKN29EbCt6OHJnaHdFYnczNW5TWGxubkhqd1hIekpEcFU0NXlDY2l1N0hSaG1sb2RGNGhlVlFlZUp1MjMwV0oyNXUycWtramM1TG8xd3IvTUpzOW5oY0pyaEVkR3Z5enk2N281aDIvVHpYcitWUkFDTGF6SlhLaEh4SHNaTXNQenJSQ3hKUk9mcytrVzNpSHpiaE15dkFSWERXSnBmQ05aYWhrTDhXcGVIL09PMkxEOTJ1VURNTkZaNWR5bHN1U2kwV285MTh4Wnd5ZmJHZTIxRTZrZEZqTjJ3azZoeGpKeG01YnV0SDJzdDRmeXJLMWxpcDY0K081ZTRRNzh6MWM0blBMVEN0ZHpteUc3NFZuZmNPVFAza0JCZUw0QWlyTWkveWtxY0NBd0VBQWFPQnRUQ0JzakFmQmdOVkhTTUVHREFXZ0JSdHhXV0p5OStSVk5GclBMY0NwUzdOaW1pUUhUQW5CZ05WSFNVRUlEQWVCZ2dyQmdFRkJRY0RBZ1lJS3dZQkJRVUhBd1FHQ0NzR0FRVUZCd01CTURjR0NDc0dBUVVGQndFREJDc3dLVEFJQmdZRUFJNUdBUUV3Q0FZR0JBQ09SZ0VFTUJNR0JnUUFqa1lCQmpBSkJnY0VBSTVHQVFZQ01CMEdBMVVkRGdRV0JCVGU3bUJwVlhWREJjcHBjYkZNYWNKM01SMldGREFPQmdOVkhROEJBZjhFQkFNQ0JzQXdEUVlKS29aSWh2Y05BUUVMQlFBRGdnRUJBSlByanZSeE40L05ld0ZLMnVWekFNUXJ2WThidGhrVFNGKzg4UHVCZmxXUEMwMXBKb3BMNHAydVRSYWdWMmhGNjFCdmFOakhERVNDbzhBT2lhdW1JMk9vMWRwN2JFdUNKRS95RHppYkJ2TExraTNZMldIQ1RoUVFsT0RsWGRSajhSN3NNaGRjZzNBS04yQWtPbWxkQlJoV0h4aFNvTDVmQ3pLUlFqS0U4MlFUUGo2R2pjcUNUWHcrSTNZSkt2VEIwRjBXa01TSEVFOGxPVkowOUdpQ3VocFZTYUg2bFZuNGN6VkxsTWJvTnAyQXdXTFRIWkk5dll6dTJReHBBVVQyeXNZNW1kVGNlRmRXYzFQQVBFTlpPaFd6UGN0Mmh3aXpqRnJtRFFyRVVNZ01pTjJkNHZKNWxhYzAwTnB1STJjS21WcWZvdmNjUlRrRG02YXdKL1RYSnZVPSIsIk1JSURTRENDQWpDZ0F3SUJBZ0lJU3hSM0ltekcxQmN3RFFZSktvWklodmNOQVFFTEJRQXdKekVsTUNNR0ExVUVBd3djVkVWVFZDQnBVMGhCVWtVZ1JtOTFibVJoZEdsdmJpQmxTVVJCVXpBZUZ3MHhPVEF5TWpJeE1EQTBNekZhRncwek9UQXlNVGN4TURBeU5EbGFNRHd4T2pBNEJnTlZCQU1NTVZSRlUxUWdhVk5JUVZKRklFVlZJRWx6YzNWcGJtY2dRMlZ5ZEdsbWFXTmhkR2x2YmlCQmRYUm9iM0pwZEhrZ1J6VXdnZ0VpTUEwR0NTcUdTSWIzRFFFQkFRVUFBNElCRHdBd2dnRUtBb0lCQVFESEIyQUJRTDd6d21pMXhJa08wYTJxNmpJSmRuM1FBbTBzMWxTZVFldjlGMkYzTTVaOHFpcVFKYXVyTVp5d1pmZE52ZzkrSXFHSE9qRGU2aElodVJ6em9BbzBBYk80TjlPZGYyUkREVTk1Tjd0b0ptQXlDaVlHZ1pmWnQ3QnNLRkllUTZwNkNzZ0tjUlhQaTBmZFhkVlNIcDRiWmZRT1FkY2xNYnRJVGlybkZ0VTA2TlBBaG9ZNjc2WXo5NnhGQUUwem9tNmVNVlBQT0ltMEc4Z2Q0NFhsbmJMMHcwbWNjQ2kyVlVaanZDSUw1OU82MU84dmxWeUxzQnFOTlRDdmY5QzJDTVlhRWF0WFp5ei9sd2dINkpZSHREMHVzWHQvK00wcUtZZTFvZW9MazBaaWNGWlhjazFpUzA5a0ZkZ2dLNUJsTm9kb1dKYURCUnJvNTFXaFkyV25BZ01CQUFHall6QmhNQThHQTFVZEV3RUIvd1FGTUFNQkFmOHdId1lEVlIwakJCZ3dGb0FVbFpNa3lieWhDeks1SE9CRkhLUk8rTUxTUi80d0hRWURWUjBPQkJZRUZHM0ZaWW5MMzVGVTBXczh0d0tsTHMyS2FKQWRNQTRHQTFVZER3RUIvd1FFQXdJQmhqQU5CZ2txaGtpRzl3MEJBUXNGQUFPQ0FRRUFaSDVRanVxK085RnB2NjM3ZzBjRjZuMUlMWUJMejFlTlpqRUIzZG9BZXh2aTVDelN3M29zd0pDU2VkR1czaGgwcUhPVEsyZ0k4M2poMFcyRUFuMmlzRmd3aE1vRzJqZDJZU0ZTa204US8yZU9mYzZNZ0dTQzVzT1RMNzVKN2J5TENvcmRxZC9ONGVhajNFcUtMYVdxN3I3dXN0UDgxUDhFSWx6MEQ4YTdsZmYxRlNvMjNIV1hUV1gyK20ydm9MQUU1bDk3YUdUR1JTMVVieGhQMmpGS1lKOVh6aUtlOU1RSlNaRWxUUThqcWcya1BGa0V4L1hxQVdxbEcxZGwxeXdMSnE1aWVQdksxUjRBWU5JL1liWlFrOXNsajh2K1AvNk03RXRFcnNmMnVJU2dld0xUY1dsMjR4M25HNXhiUVp4clA4bDJqU0dZbU9USW5nS09RU25iZmc9PSIsIk1JSURNekNDQWh1Z0F3SUJBZ0lJQkxVMmNaQVpxTEV3RFFZSktvWklodmNOQVFFTEJRQXdKekVsTUNNR0ExVUVBd3djVkVWVFZDQnBVMGhCVWtVZ1JtOTFibVJoZEdsdmJpQmxTVVJCVXpBZUZ3MHhPVEF5TWpJeE1EQXlORGxhRncwek9UQXlNVGN4TURBeU5EbGFNQ2N4SlRBakJnTlZCQU1NSEZSRlUxUWdhVk5JUVZKRklFWnZkVzVrWVhScGIyNGdaVWxFUVZNd2dnRWlNQTBHQ1NxR1NJYjNEUUVCQVFVQUE0SUJEd0F3Z2dFS0FvSUJBUUNyRFAyRFdYMy9iOHVNYXB6RUJBVFNhNmlaZnZnZ3pJQlVFeGtXRWJHOWUxblZ5L2pRazIwbmZTRk1VbVJUNk5oWWNka1NZTy9XcmtpOVk0RXBDeTF4dlpIcUwrNFk2UzlKTFp3Sjc2MExwWWxlK05hVnU3bWluTVVRY3VvajVuS3pDbHZhemIwMEF4NWdrSlVmUjN2M1g1R1hxUXJrV2F6TXQrazVUTk02VFd1SjMwcU9md3JIeDV2VExtVFVVaWgrQnNHTDNmNUdPczFWVFlJQ05oaVRqTjc0bjJXcXAya1VMV0llKy9YNlJaL2hLc3BhSEdabktEVlR3SSs4Wm1XRmVqdXhBNkRPWDdSc1lMS3ZRTzIxRm1iSUJvU3M5QXp2NTkvUnhXVUpWTU8wV2hEaEtwUWdDR2p3Z1YzMm9mTmRrRmdtZFZ1bHpOUElEMlJOYlRUTEFnTUJBQUdqWXpCaE1BOEdBMVVkRXdFQi93UUZNQU1CQWY4d0h3WURWUjBqQkJnd0ZvQVVsWk1reWJ5aEN6SzVIT0JGSEtSTytNTFNSLzR3SFFZRFZSME9CQllFRkpXVEpNbThvUXN5dVJ6Z1JSeWtUdmpDMGtmK01BNEdBMVVkRHdFQi93UUVBd0lCaGpBTkJna3Foa2lHOXcwQkFRc0ZBQU9DQVFFQWx6YUJWYUZoWm1IOXV4c0xTdjNGa2t4V1Z3QlIxR2hBeHdjSmxWNHgra3FYOHRjaEo0U0RMRXVXUnJGNEROdHZTUjNyNjlLejhlWUk1WHVXMWVHMTJZakdHVmxZaWpkeHJHMUFOekduMnZkbzl2TDdkRUZVRU1LMUFLeFJzdGJUZEU3eXd6SVYvQzYxdzhKcnh3THR0OU9qZFVFVVBIdUdUanV2NW5GQlBkRnpPY3Z1K0RUTWw3M0NKUDJ6ZVpVRmd1ajU1TXNYWTQ1TXJYcmJndCtMSnFVdTRwa0IyYkx1OUZiZVJMV1pKdWtuWVNyVzRmeVFCWjJpK01zR2RpQktRY2YzZkxYanBjaDQ4L3A3U2lUazR1ZmxvQmFxVENsdC9FdFdYRFNtRmN2NFFqQmsxbVVQdTl2eGlrY0hEa0F2SnJPWEdnMGIrM2VJNGE3T1RmQWIxZz09Il19.eyJhdWQiOiJFVS5FT1JJLk5MMDAwMDAwMDAzIiwiZGF0YXNwYWNlX2luZm8iOnsidG90YWxfY291bnQiOjcsInBhZ2VDb3VudCI6MSwiY291bnQiOjcsImRhdGEiOlt7ImRhdGFzcGFjZV90aXRsZSI6IkRMRFNfTG9naXN0aWNzX0RhdGFTcGFjZSIsImRhdGFzcGFjZV9pZCI6IkVVLkRTLk5MLkRMRFNfTG9naXN0aWNzIiwiZGF0YXNwYWNlZGVmX3VybCI6IiIsImRhdGFzcGFjZV93ZWJzaXRlIjoiIiwidGFncyI6IiIsInN0YXR1cyI6IkFjdGl2ZSIsImNvdW50cnlfcmVnIjoiIE5ldGhlcmxhbmRzIiwiY291bnRyaWVzX29wZXJhdGlvbiI6WyIgTmV0aGVybGFuZHMiXSwic2VjdG9ycyI6W119LHsiZGF0YXNwYWNlX3RpdGxlIjoiVGVzdERTUCIsImRhdGFzcGFjZV9pZCI6IkVVLkRTUC5OTFRFU1REU1AiLCJkYXRhc3BhY2VkZWZfdXJsIjoiIiwiZGF0YXNwYWNlX3dlYnNpdGUiOiIiLCJ0YWdzIjoiIiwic3RhdHVzIjoiSW5Qcm9ncmVzcyIsImNvdW50cnlfcmVnIjoiIiwiY291bnRyaWVzX29wZXJhdGlvbiI6W10sInNlY3RvcnMiOltdfSx7ImRhdGFzcGFjZV90aXRsZSI6IkNvbnRha3REUzEiLCJkYXRhc3BhY2VfaWQiOiJDb250YWt0RFMxIiwiZGF0YXNwYWNlZGVmX3VybCI6IiIsImRhdGFzcGFjZV93ZWJzaXRlIjoid3d3LmNvbnRha3QubmwiLCJ0YWdzIjoiI3Rlc3QiLCJzdGF0dXMiOiJJblByb2dyZXNzIiwiY291bnRyeV9yZWciOiIgTmV0aGVybGFuZHMiLCJjb3VudHJpZXNfb3BlcmF0aW9uIjpbIiBOZXRoZXJsYW5kcyJdLCJzZWN0b3JzIjpbIkluZm9ybWF0aW9uIFRlY2hub2xvZ3kiXX0seyJkYXRhc3BhY2VfdGl0bGUiOiJOTC5BSVJGUkVJR0hUIiwiZGF0YXNwYWNlX2lkIjoiTkwuQUlSRlJFSUdIVCIsImRhdGFzcGFjZWRlZl91cmwiOiIiLCJkYXRhc3BhY2Vfd2Vic2l0ZSI6Imh0dHBzOi8vd3d3LmNhcmdvbmF1dC5ubCIsInRhZ3MiOiIjYWlyICIsInN0YXR1cyI6IkluUHJvZ3Jlc3MiLCJjb3VudHJ5X3JlZyI6IiIsImNvdW50cmllc19vcGVyYXRpb24iOlsiIE5ldGhlcmxhbmRzIl0sInNlY3RvcnMiOlsiSW5mb3JtYXRpb24gVGVjaG5vbG9neSJdfSx7ImRhdGFzcGFjZV90aXRsZSI6IlVuaVNhbGVudG9EUyIsImRhdGFzcGFjZV9pZCI6IkVVLkRTLklUVU5JU0FMRFMiLCJkYXRhc3BhY2VkZWZfdXJsIjoiIiwiZGF0YXNwYWNlX3dlYnNpdGUiOiIiLCJ0YWdzIjoiIiwic3RhdHVzIjoiTmV3IiwiY291bnRyeV9yZWciOiJJdGFseSIsImNvdW50cmllc19vcGVyYXRpb24iOltdLCJzZWN0b3JzIjpbXX0seyJkYXRhc3BhY2VfdGl0bGUiOiJpU0hBUkUgVGVzdCBTcGFjZSIsImRhdGFzcGFjZV9pZCI6IkVVLmlTSEFSRSIsImRhdGFzcGFjZWRlZl91cmwiOiIiLCJkYXRhc3BhY2Vfd2Vic2l0ZSI6IiIsInRhZ3MiOiIiLCJzdGF0dXMiOiJBY3RpdmUiLCJjb3VudHJ5X3JlZyI6IiBOZXRoZXJsYW5kcyIsImNvdW50cmllc19vcGVyYXRpb24iOlsiIE5ldGhlcmxhbmRzIl0sInNlY3RvcnMiOlsiSW5mb3JtYXRpb24gVGVjaG5vbG9neSJdfSx7ImRhdGFzcGFjZV90aXRsZSI6IlRFU1QgRFMiLCJkYXRhc3BhY2VfaWQiOiJFVS5URVNULkVVLjEwMDEiLCJkYXRhc3BhY2VkZWZfdXJsIjoiIiwiZGF0YXNwYWNlX3dlYnNpdGUiOiIiLCJ0YWdzIjoiIiwic3RhdHVzIjoiTmV3IiwiY291bnRyeV9yZWciOiIiLCJjb3VudHJpZXNfb3BlcmF0aW9uIjpbXSwic2VjdG9ycyI6W119XX0sImV4cCI6MTY5MTA3ODk2MywiaWF0IjoxNjkxMDc4OTMzLCJpc3MiOiJFVS5FT1JJLk5MMDAwMDAwMDAwIiwianRpIjoiZGMzMjkwNzI2ZjhhNDMyYzhjMjQ4ZWJkMjAzZTdhNDEiLCJuYmYiOjE2OTEwNzg5MzMsInN1YiI6IkVVLkVPUkkuTkwwMDAwMDAwMDAifQ.O8yVlkMY-RCwHyIitS6ODIFC5F-tsTA2ovbOhZGyei_1OVpNe60cDSKrjKXS0YWuudEvx-BZKhfEhNuF2U4HSX8IanaA0dPhrg6o3XldsPVUJ5rIBnyKLEI3XotqZnSXlCt4gJ0xx9isJeQ3LOQpp2TP73gAyIg-KAIrPMd2hx1rPLk33gOT7FO_lZV3Ow8kvaCwQqM-4nX0QfgkJyt3BLFZY-tniMARkByeQdb1JeBlL4_XUDxkp0CmhADo-BbUA6fAz37VA_mdhZYqHimvdi4MiLjt_Sxik1lZouKhHS7L4gLE2FE4LE4KEqdDusMs-T3lklNkIrOKHfSFUScMHw"
}
```

After decoding, the example content of the JWT looks like this:

```json
{
  "aud": "EU.EORI.NL000000003",
  "dataspace_info": {
    "total_count": 7,
    "pageCount": 1,
    "count": 7,
    "data": [
      {
        "dataspace_title": "DLDS_Logistics_DataSpace",
        "dataspace_id": "EU.DS.NL.DLDS_Logistics",
        "dataspacedef_url": "",
        "dataspace_website": "",
        "tags": "",
        "status": "Active",
        "country_reg": " Netherlands",
        "countries_operation": [
          " Netherlands"
        ],
        "sectors": []
      },
      {
        "dataspace_title": "TestDSP",
        "dataspace_id": "EU.DSP.NLTESTDSP",
        "dataspacedef_url": "",
        "dataspace_website": "",
        "tags": "",
        "status": "InProgress",
        "country_reg": "",
        "countries_operation": [],
        "sectors": []
      },
      {
        "dataspace_title": "ContaktDS1",
        "dataspace_id": "ContaktDS1",
        "dataspacedef_url": "",
        "dataspace_website": "www.contakt.nl",
        "tags": "#test",
        "status": "InProgress",
        "country_reg": " Netherlands",
        "countries_operation": [
          " Netherlands"
        ],
        "sectors": [
          "Information Technology"
        ]
      },
      {
        "dataspace_title": "NL.AIRFREIGHT",
        "dataspace_id": "NL.AIRFREIGHT",
        "dataspacedef_url": "",
        "dataspace_website": "https://www.cargonaut.nl",
        "tags": "#air ",
        "status": "InProgress",
        "country_reg": "",
        "countries_operation": [
          " Netherlands"
        ],
        "sectors": [
          "Information Technology"
        ]
      },
      {
        "dataspace_title": "UniSalentoDS",
        "dataspace_id": "EU.DS.ITUNISALDS",
        "dataspacedef_url": "",
        "dataspace_website": "",
        "tags": "",
        "status": "New",
        "country_reg": "Italy",
        "countries_operation": [],
        "sectors": []
      },
      {
        "dataspace_title": "iSHARE Test Space",
        "dataspace_id": "EU.iSHARE",
        "dataspacedef_url": "",
        "dataspace_website": "",
        "tags": "",
        "status": "Active",
        "country_reg": " Netherlands",
        "countries_operation": [
          " Netherlands"
        ],
        "sectors": [
          "Information Technology"
        ]
      },
      {
        "dataspace_title": "TEST DS",
        "dataspace_id": "EU.TEST.EU.1001",
        "dataspacedef_url": "",
        "dataspace_website": "",
        "tags": "",
        "status": "New",
        "country_reg": "",
        "countries_operation": [],
        "sectors": []
      }
    ]
  },
  "exp": 1691078963,
  "iat": 1691078933,
  "iss": "EU.EORI.NL000000000",
  "jti": "dc3290726f8a432c8c248ebd203e7a41",
  "nbf": 1691078933,
  "sub": "EU.EORI.NL000000000"
}
```

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

*This page must be considered part of the iSHARE Trust Framework*
{% endhint %}


---

# 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/version-2.0.1/ishare-satellite-role/dataspaces.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.
