iSHARE Developer Portal
Other resources
Version 2.0.1
Version 2.0.1
  • Welcome to the iSHARE Developer Portal
  • Introduction
    • Getting started
      • Test certificates
      • Test participants
    • Release info
    • Help & support
    • UI Guidelines
    • Conformance test tool
  • Roles
  • iSHARE Satellite role
    • Getting started
    • Access token (M2M)
    • Parties
    • Parties (single party)
    • Trusted list
    • Versions
    • Capabilities
    • Dataspaces
    • Create entitled party
  • Authorisation Registry Role
    • Getting started
    • Access token (M2M)
    • Delegation
    • Capabilities
  • Service Provider Role
    • Getting started
    • Access token (M2M)
    • Return
    • Service
    • Capabilities
  • Service Consumer Role
    • Getting started
  • Identity Provider
    • Getting started
    • Authorize
    • Login
    • Access token
    • User info
    • Capabilities
  • Entitled Party
    • Getting started
  • All roles (common endpoints)
    • Access token (M2M)
    • Capabilities
  • Reference
    • iSHARE JWT
      • Client Assertion
    • Authentication
    • Authorization
    • Delegation mask
      • Policy sets
    • Delegation evidence
      • Policy sets
    • Postman collections
Powered by GitBook
LogoLogo

  • Cookie Policy

  • Privacy Policy

  • Imprint

  • Contact Us

Copyright © 2024 iSHARE Foundation

On this page
  1. iSHARE Satellite role

Versions

PreviousTrusted listNextCapabilities

Last updated 8 hours ago

Response model

The model of the versions_token JWT response is available on the iSHARE OpenAPI documentation.

Decoded versions_token parameters:

It contains iSHARE compliant JWT claims. In addition to that it also contains the following parameters:

  • versions_info

    Array of Objects. Root level.

    Contains collection of trusted certificate authorities.

    • version_name

      String. Contained in the object of versions_info.

      Version name. Expected format should be {major}.{minor}.{patch}.

    • valid_from

      Timestamp (ISO 8601). Contained in the object of versions_info.

      UTC timestamp which states since when version is valid.

    • valid_to

      Timestamp (ISO 8601). Contained in the object of versions_info.

      UTC timestamp which states till when version is valid.

    • version_status

      String. Contained in the object of versions_info.

      Status of the version. Available values are active and planned.

Example request

> Authorization: Bearer IIeDIrdnYo2ngwDQYJKoZIhvcNAQELBQAwSDEZMBcGA1UEAwwQaVNIQ

GET /versions

Example response

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

{
  "versions_token": "eyJ4NWMiOlsiTUlJRWlEQ0NBbkNnQXdJQkFnSUllRElyZG5ZbzJuZ3dEUVlKS29aSWh2Y05BUUVMQlFBd1NERVpNQmNHQTFVRUF3d1FhVk5JUVZKRlZHVnpkRU5CWDFSTVV6RU5NQXNHQTFVRUN3d0VWR1Z6ZERFUE1BMEdBMVVFQ2d3R2FWTklRVkpGTVFzd0NRWURWUVFHRXdKT1REQWVGdzB4T1RBeU1UVXhNVFEyTlRoYUZ3MHlNVEF5TVRReE1UUTJOVGhhTUVreEhEQWFCZ05WQkFNTUUybFRTRUZTUlNCVFkyaGxiV1VnVDNkdVpYSXhIREFhQmdOVkJBVVRFMFZWTGtWUFVra3VUa3d3TURBd01EQXdNREF4Q3pBSkJnTlZCQVlUQWs1TU1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBMFJvb2hlUEwwMk52NEJaVEoza3A3bktzaHNtanJjcjhNQmFBaFFwWlpBc2dUQWxtUWlDVFBtM2M4cVlQcU4rVHVnZ0ZXQ05uKzlXNTRDNVVHcXNJd3RYVGszWWV4QXdaNG9qUlJ0bzhsMUhQRFZBUzZXdlc3NEFDTlpsRWdHd2pyQ0d5MitNNVFQN083d0IwVDZvRkJvZlJ3SFpHemdidFNiU1FodXF3VXhmMEdaSTh4QWwyL0dUSDI1VmZwOVQ3MUpFcG9aOWtzUDNDSWk1QkhrbGJUNUdLeEVPRmZkTU11cFg3bVduTlFiTHh1UXBBdEdDdW9yR2ZQRkU3RjVldkUxem9wd2NlQTVGc0UxTGFCUnF0K0VPcFBJbVNhalIwMmJjaEs5alM2bllFV3MvRlpHTHRKYWxsNUwzU25aTTZPaFd4TStsS0d6Rkt3NVRJWE45RE13SURBUUFCbzNVd2N6QU1CZ05WSFJNQkFmOEVBakFBTUI4R0ExVWRJd1FZTUJhQUZCWTg1eURwMXBUdkgrV2k4Ymo4dnVyZkxEZUJNQk1HQTFVZEpRUU1NQW9HQ0NzR0FRVUZCd01CTUIwR0ExVWREZ1FXQkJSZndpalQ3NWRJS1BsRkMvQ3RSRHFVS1g5VE5qQU9CZ05WSFE4QkFmOEVCQU1DQmFBd0RRWUpLb1pJaHZjTkFRRUxCUUFEZ2dJQkFLNFBXVHEvZHF0Vm0rNFdDZDFLUUo0dGorbjRjY0lBWUxETXFZU0JKc042UTJjdE1SQy8rK3lNL293UEhCcmlUendXL2pvQXBOUGVaaDFJVFRnU3phMzhtM2h4b0RxMXV4NkhWR3lLNVFDUW9qRmRsZWM3dE9IbG1jYnV5VjRDRXlNWmJHK3lMbVZESTNxNTNWQVBnV3ZLSWkyUlVwc1BOdzJsbzZINjZ2SE5wNWZpcEIvdEU0Q0RsYS9UYU41MWxOM2xYT3c0bHRiWmJ6YmQ2TXhJbEVDUWZKSDVlUHJpcGFrSmhuaVZrWnZRVmthS0FlcFNYMGFEWUxPcFFRbmV0RFdab1ZKS0FzR0VMM0hMaWhxWXNEejcvQlQzRHdUMEtDNSs5OGdqR1p3dkx3ZXRKOTZLWFRBRTUwMmYzak95UDdERDZ1SytKS2d2UVp5dkk1L0V1cDBUdE5sUmZKeThhZDhweCszOG9JeEdBbGJzS29XbXowb2FNR0MrbFZHTlAyTTQ4TTdWa3RCVHB5bXF4Vnd0VGt2TVBqWldIS2xYdDJXMzNtTktHakpTOTVJNXZxT0tQV1NTc1dkSlJZSkNsbUVybWlkTlczMWxXQVZQcjFpU1M0SlhEdllQTENQNDRhNGVkMEdhV1pSdi9iK0QyK1FVZ09iOFN6bWpQdmYvMkdOdHFXUmR5WXRYWjl2eDAzNGkrWEYveWU4c2lOK1grd0ZIdFJ1bXRzd2Irc2NRZjRmVTZNaktCS1VzUERBUkFHakhqNXhIQkRqcTg0bmpHdVFjbDBoYlMzK1pTVjROcWtKSVVzMkxVdDlFdjFYN2FCNy85NUVYQWNnTlhkM0tQVm0zcDhORDc1QXFNMEZHUUVhUXlPd3FLY3FUQ2xKQ3VmR3NVWTRzN3JXUiIsIkxTMHRMUzFDUlVkSlRpQkRSVkpVU1VaSlEwRlVSUzB0TFMwdERRcE5TVWxHWTFSRFEwRXhiV2RCZDBsQ1FXZEpTVk5HVWtwM1IwRkJlV3BWZDBSUldVcExiMXBKYUhaalRrRlJSVXhDVVVGM1VrUkZWazFDVFVkQk1WVkZEUXBCZDNkTllWWk9TVkZXU2taV1IxWjZaRVZPUWsxUk1IZERkMWxFVmxGUlRFUkJVbFZhV0U0d1RWRTRkMFJSV1VSV1VWRkxSRUZhY0ZVd2FFSlZhMVY0RFFwRGVrRktRbWRPVmtKQldWUkJhelZOVFVJMFdFUlVSVFJOUkdONVRYcEZNVTFVVVhoTk1XOVlSRlJKZWsxRVkzbE5ha1V4VFZSUmVFMHhiM2RUUkVWYURRcE5RbU5IUVRGVlJVRjNkMUZoVms1SlVWWktSbFpIVm5wa1JVNUNXREZTVFZWNlJVNU5RWE5IUVRGVlJVTjNkMFZXUjFaNlpFUkZVRTFCTUVkQk1WVkZEUXBEWjNkSFlWWk9TVkZXU2taTlVYTjNRMUZaUkZaUlVVZEZkMHBQVkVSRFEwRnBTWGRFVVZsS1MyOWFTV2gyWTA1QlVVVkNRbEZCUkdkblNWQkJSRU5ERFFwQloyOURaMmRKUWtGUWRXVlNXRlZIVTFWbmRUZHhjRUZYU21wQlZrZzVlak14T1ZodWRVWnNaVlpsVHk5WWVHSktObFUwYVhoWVVrdDJWemgyUzFSV0RRb3haRkpqWmxGbFEzRllhemQxWVM5YWMzRk9jbkU0T1VWNE9UVmlNRzV4UjFWMk1VNXZTekpVT0hsRlFXdFJlbmw2V1Zwd1Z6UmpNbGxOUTJObk5XRnREUXBTZDBObVdXRm9TSFJLYlZoS1YzRlNSV1YyVFRWclNtOVBZV05MU0M5SFZXSnpaVzFVT1RSQ01FdFlVMDVSTmtsWFkwcDVhbkIxWVc5RWNHSTJWMlE1RFFvM1ZESnNkVkF4U1ZFMVoydG1kMVV6T0VOYVNrdFdhMkpaTTJWS2EweHNUM2QzZEVaelJsQlFNazAwWmpoMU5EYzVUMnROVlhJMUwyMHJlRzQzTTBwaERRcGFVMHBHVDBoMlNVNDJSRVp3UVd4ek1tRjROMEpvVlZOc1lrdE5NMWxGZFU1aU1FODBiMDgxZVc1RVJraDJiV3hzY0RaT2RUQkdNbGh2TUVKMU1GQXZEUXAxY1dJdk1EaFlkbFpYYm1VM2QyTjNWMXBTT1N0a056aHhLMDlzWmtNdmJTdDNRWGRCY1cxUlNFVnlPR2hLVG5aU05sTXZPRFJJUVdwVlpFMTVSMk5aRFFwVWRtOTJNSFJpTUZwM0wwRkxkMFJuT0ZCRE9WVkdVbGxpTUdOQ2NqQXJMMGRtWjIxS1VEVlJUVUZtVEhGcldHMWFkMWxSVTFveFJtRnRUbXhLYkcxNERRb3djMWxhVVZOaGRXUkhNQ3RZYTJNNU9URXJXbmN2ZURoMVYxcHBPWEZSV21WQ1QyUjNia2t5ZUdZdlNFcFlTRXB6WVZwbVJIWlVjRFZwT0dsV1VEYzFEUW94Y21ocGJuZE1hVEprV201dFUzTlJPVFpuZG5SVVVVSnZORW8xUVhaR0szTTVTV3dyVkhWclpVeDBiRXRCUW1GdlRYZDZPSGRaUWtOdVprdDJWWFJyRFFwd04wcFZOV2xxYWxsR1lYRlJjMFpTTTFKd1QwaFlZMGd2YzNCYVZGbElkVk56TVU5d1NGWmljakF2WTBaMFYxcHdkalIwVTFGcmJGQnhRMnBrWkZOQkRRcFRTRGxyTTA5Q1FXaDRaVzU1V0V4cmJqbFZPVUZCU1RNMGNGcGlSbFlyYld0elIwZHlUamQxYTJzMGIySlRkRWszZWk4MVFXZE5Ra0ZCUjJwWmVrSm9EUXBOUVRoSFFURlZaRVYzUlVJdmQxRkdUVUZOUWtGbU9IZElkMWxFVmxJd2FrSkNaM2RHYjBGVmNtRXpTM05VYmxWV2JsazRTMWhuYkRCU2FXbFJRblJ2RFFwTFJYZDNTRkZaUkZaU01FOUNRbGxGUmtKWk9EVjVSSEF4Y0ZSMlNDdFhhVGhpYWpoMmRYSm1URVJsUWsxQk5FZEJNVlZrUkhkRlFpOTNVVVZCZDBsQ0RRcG9ha0ZPUW1kcmNXaHJhVWM1ZHpCQ1FWRnpSa0ZCVDBOQlowVkJaVWxLZHpGdWJtOVBjbk5oYlhWbFZ6UmpXbEJNZW5KdWRVaFRSWFoyTVZORlRERmlEUXBtUWpaR056TmhibTE0WW5FNUswOVpWelp4YjJwb2VIWnZja2hVUm5wdlVYbHVjMUJ0WW5Odk4zUTBZak5JUVhSWFlVOXNjRE5FUzFwVlZIQjZUMnhNRFFwdVVUbG5jMFJFWmtSV1UwcHpTalZxZUdkc1JFWmFiVEJCTURkTVpETkRlRnBvYm5wWFpqbEJNRkZuVG5GT05XaERZMDl6Y213MGRVUk5kbHA2SzAwNURRcHJUQzlwYTNORGVEUllNSE52TWs5VGJURlJZV3R5WVVGU00zVnRVR015YjI5QllXTlFjMEZXUTJ4c1pXdFlSa281UkVacVNqVlZkaXR5WnpoYVMwaElEUXBNUjNKUU1UbHZMMEZ6V0VwWmNFdFFMM1IwYXpWMFFuVkJORXBDTWpCaFUyaGlZME0xTXpseVFTdFJZeXRyUkVoNVVtNU1NR0ZLZVZKWlpVSm5XVEZwRFFwQmRIVjZXSHBOVDJzMU0xaFdLMkZLYjJkRWNETm5SamN6Y3pGak1WbDVTVkpJZERkdlpsRkhMekJhYkhkakx6UXhRM2hQUkN0c2VYcEhNelJTYTJkSkRRcFZUelpWWm1wcFIwTkdVRzFhVVRKSWEzQkxlWEZNYVdaeVlWSmtjWEpJV0U5b2IxWmtOMGhwWkZsSmFXaHVXa3RFYTB4cE1XTm1aVzh5YlhvNGRGZHBEUXBWZWtFclpGQmphR0ZKUld4d1VVcFFWR3BUWWt4cVJqSkpNVGxSZVVJNFpuVlFZWHBRWms1SmFraHlXR0ZMYkdGVE0yeDFTMk5HYVhGUFdXZGpkMWRtRFFwa1dtMUVlbmhKVlRaUVdUSmllbmd2VTBSTmIxVXlOSEpCVmxOMVIwRlpRa2xCYkhkbU1uQjRiWFJNWTJKTlFUWmlXWEkwZEhKdFVXWmlTbkpOT0dZNERRcEtXbWRIVVc5SmRISndlbkpMYWtKS01tZEdVblFyTURZMVRrMVVUbXRDTlhKM09GaHlOVFpxTldScWEzRkNNQzl4U0VsalJqSlVhVmt2YXk4NE1WSnREUXBVUTFsNGNsWkllazB4WTNwb1dFaFlXWHAyYm1ReVNtd3hkMHBZZVdGalYydzNSbWxRWVdkbmR6QlpVV2xrVjBoSFRXUkpkRVYxUkM4NFUxaHBRMWhzRFFveFQwbDJkbWxqUFEwS0xTMHRMUzFGVGtRZ1EwVlNWRWxHU1VOQlZFVXRMUzB0TFEwSyIsIkxTMHRMUzFDUlVkSlRpQkRSVkpVU1VaSlEwRlVSUzB0TFMwdERRcE5TVWxHWWxSRFEwRXhWMmRCZDBsQ1FXZEpTVWhxYW1aVWRWTnFSbXBOZDBSUldVcExiMXBKYUhaalRrRlJSVXhDVVVGM1VrUkZWazFDVFVkQk1WVkZEUXBCZDNkTllWWk9TVkZXU2taV1IxWjZaRVZPUWsxUk1IZERkMWxFVmxGUlRFUkJVbFZhV0U0d1RWRTRkMFJSV1VSV1VWRkxSRUZhY0ZVd2FFSlZhMVY0RFFwRGVrRktRbWRPVmtKQldWUkJhelZOVFVJMFdFUlVSVFJOUkdONVRYcEZNVTFFVlhoTk1XOVlSRlJKTkUxRVkzbE5SRVV4VFVSVmVFMHhiM2RTUkVWV0RRcE5RazFIUVRGVlJVRjNkMDFoVms1SlVWWktSbFpIVm5wa1JVNUNUVkV3ZDBOM1dVUldVVkZNUkVGU1ZWcFlUakJOVVRoM1JGRlpSRlpSVVV0RVFWcHdEUXBWTUdoQ1ZXdFZlRU42UVVwQ1owNVdRa0ZaVkVGck5VMU5TVWxEU1dwQlRrSm5hM0ZvYTJsSE9YY3dRa0ZSUlVaQlFVOURRV2M0UVUxSlNVTkRaMHRERFFwQlowVkJORWhKVVRKbFIxaFRVREJpY1dkUGN6WkpZbko0Vkhjdk1IVTJXSGxTYVRWSUwxb3JhamhvVUhwR1pWTXZiamRWWTBSekt6UTRSMWxUWjBWT0RRb3hZMGxFUWtGSFYycHVkMDVOTm5VMFVuQlJhVWM0ZUd3M1dYUnFWM2x0ZDB0dE5FaFlkRXhCVVhGME56SmhjbGt6TjFCVFJqTXdXR2syVmxCQ1lXNTBEUXBRVkdSaFlTczVla05WT0VONVJtNUZXakptUzFSck1WTjFaek0yWnpaR05rOXFaR2REUTBkcmFtUndjRXRXZVU1SmJEVlBWeXRyYWtaeE1rRTVSM1owRFFwQ1VrZEZkMUl5WlhSdmRFdDBjMGxJU1M5bk5HTllUMFphYW5SRFEzUlFiMFZ0YWxFMk5tWlRkMkUzUVdwdmJIQkNZakpRWTNOelExWndZalZqTm5OQkRRcG1jREl3U2s1dU9EUnJSRkZGYjBocVpXOTVUa0Z4WTNSQ1JVbHpVbHBHTkd0d1ZHNDBXV2hUV0hFd1ZFZ3ZhMUowUlVWbVRrVnRla3hGVDFOaFJGZFFEUXA1VERoeFNrcHdlREZoVUVGNVpUQm1hMGRtU21rMU1XTkhVbkpHZUdZM2FtWk9PVGxVYW1SbU0zbDRkM1JVTDNsUmNYVlhUSEEyVmt4a2NXcEtUR3M1RFFwaWRFZHJLMEpwVXpscFZuUjNOREZGWXpKNWMxZ3ZNMmN3ZUdWV1ZrWkhkSGxEZDBGRFYzQjVTWGdyVVcwNE1FdHFWbGhyV1VSNGFFZHBURkZxVVVsNkRRcFdiMnhRUlZaVlJFRmFibmNyVEVOdFp6TlBXVGxKZVRCUVdGUldNSGd6UTB0SVRTdERNM1ZyV2xkclV6RmtNME5UWjBSV2JERXJZM0JJU2xRMGJUWm1EUXBMYm01alR6YzNlVlpQTUhseVZ6VXlNVGhWUjJGWlFVeFBhRGhRU0c5M016WmxPV05DTW1Nd1lsUXlaREZEU0ZKbGExTnNOQ3RDZUN0NFVVMUhkM05RRFFwNWRtVkhaM0JyU0dsa1duUlpVa1JRTkVVdlNIaE9TM2tyZDJaQ2VWRmxVM1UwV1dOVll6aEZTSGg1T1hGNmVHRmxNamhSWmxwdU4zTTBOMVl2VUdwQkRRcHJNR1JNV25sUlJHOXVSVGxSTVRCUGEwMVdNVFZFY0RsUVYwZGxRMUZLY21rMVNtUlBibklyYVVRNFJHUkljME5CZDBWQlFXRk9hazFIUlhkRWQxbEVEUXBXVWpCVVFWRklMMEpCVlhkQmQwVkNMM3BCWmtKblRsWklVMDFGUjBSQlYyZENVM1J5WTNGNFQyUlNWMlJxZDNCbFExaFNSMHRLUVVjeVoyOVVSRUZrRFFwQ1owNVdTRkUwUlVablVWVnlZVE5MYzFSdVZWWnVXVGhMV0dkc01GSnBhVkZDZEc5TFJYZDNSR2RaUkZaU01GQkJVVWd2UWtGUlJFRm5SMGROUVRCSERRcERVM0ZIVTBsaU0wUlJSVUpEZDFWQlFUUkpRMEZSUWtOSFdVNXNMekZJUmxkV2FFUnZVRzFyY0ZaeGJUTXdjbmx4Wmpaa1YzZ3hjbmhVVnpGc2F6bGhEUXBXVlU5c1VqbEpVa2hRY0RGNkwwWXZOR1ppTm0xSldFWnFSbGwzTld4Vk1tWmhTRlk1YjNBMGNrNTFSM0ZTVWxOTWFWRlFWblpQV0hoRWJIaHhRVFpFRFFwdGNYcHBVa1YyZEhSSE1IVk1XaTlHVDNsalMxazFNM0JYUmtONlJ6SnJaWEUyVDBsa09VcFRjRVp0VVVSUGFVWTNWMU4xYVdaUVRIVjNRVVJyVlhjckRRcHZXbGxIWjFkdFluZFJUekJzV0hSM04xaFBibmt6TjI1TVdtdFpiRGc1WWxKb1NXY3ZOMlppSzFodVlqZzVNVFJUVFhZd2EwZHNhekZyUTJWNVREWkdEUXBZWkZoU1ZHRmhkRFZqT1Zoc1NuSTVlWHBQVlVsRWJqVTBZbGt4UWt0VU5sbDBhWGxLWm5aRFRtRjJMMFppTWpSMk5XVnhNbG81YlVKa1dqY3dRMk01RFFvMVoxQnFjWEY0VFZwVlowcHZOVGRaZG1oTVpsaEVkM2hpVjFwWFdVTXJWMk5TT0c1SWExa3JkRnBDYkVscGFESkRXRWh6VDJGeU5XOUlObVJ5VFdSMERRcE5TVnA2TTFWYVNpOURlRVpITVhVeU0xVjZNV3BDWm0wdlJXZG5aRXRvVDFadVZEWmxaSEoxVm05MFpWZFhRMFJDT1Voa2FIaDZPRkpCVmxsdU5XUnhEUXBWYW10cVVuRTBWemxSUVdaS2RYTnlVRnBIUW01a1ZEZDVUbUZaTDBaSVdVdEpjU3QxVkdGeVYybGlhbVI0ZEdSWlEyeGhWSGRQZUdzMVNYRkxUa1k1RFFwbFEwdGlVRzE0Y3pGdGJGcHlVMHhxVFZGR1dUTlZPVkpyZG5wSkt6TkpiRUZHYTJOMFZXVmhZbkJyYlZoNGJuVlhWMU5XTWtaS1R6bGFjazlPVFZkMURRcDBkeXMxTmpkUVN6Vm5lazB3Um5GUmRtSTNjME40V25WUlJHdzFRM1EyV2xkc2RITXlXVGN5ZERad1VHcFNTVEUzSzFNNEt5dGhNblpSWkhoQ1kwNVJEUW93ZUVZeWRHcDJlbFIyYVZvelF6VkZjVWxsWVhwWFpHZEpXbXR4WmxkYWExTTRkaXN3VFVGMlRscFpLMkppZUN0MlUzZE1UMjlJVVZkeVppOVBRMHczRFFwQlVUMDlEUW90TFMwdExVVk9SQ0JEUlZKVVNVWkpRMEZVUlMwdExTMHREUW89Il0sImFsZyI6IlJTMjU2IiwidHlwIjoiSldUIn0.eyJpc3MiOiJFVS5FT1JJLk5MMDAwMDAwMDAwIiwic3ViIjoiRVUuRU9SSS5OTDAwMDAwMDAwMCIsImp0aSI6IjNmYzY2NmFhZWU1YjRiZGNhNDRmN2MyNzgyZTg4MjI5IiwiaWF0IjoxNTkxOTY2MDgxLCJleHAiOjE1OTE5NjYxMTEsImF1ZCI6IkVVLkVPUkkuTkwwMDAwMDAwMDEiLCJ2ZXJzaW9uc19pbmZvIjpbeyJ2ZXJzaW9uX25hbWUiOiIzLjAuMCIsInZhbGlkX2Zyb20iOiIyMDMwLTA3LTA0VDA4OjAwOjAwWiIsInZhbGlkX3RvIjoiMjA1MC0wMS0wNFQwODowMDowMFoiLCJ2ZXJzaW9uX3N0YXR1cyI6InBsYW5uZWQifSx7InZlcnNpb25fbmFtZSI6IjIuMC4xIiwidmFsaWRfZnJvbSI6IjIwMTgtMDEtMDFUMDA6MDA6MDBaIiwidmFsaWRfdG8iOiIyMDMxLTAxLTAyVDAwOjAwOjAwWiIsInZlcnNpb25fc3RhdHVzIjoiYWN0aXZlIn0seyJ2ZXJzaW9uX25hbWUiOiIxLjkuMCIsInZhbGlkX2Zyb20iOiIyMDE5LTAxLTA0VDA4OjAwOjAwWiIsInZhbGlkX3RvIjoiMjAzMC0wNy0wNFQwODowMDowMFoiLCJ2ZXJzaW9uX3N0YXR1cyI6ImFjdGl2ZSJ9XX0.fFWlgXVVNEnK6R2lZWuTIF_1IT7tBZwS-V7Zejb0BmkIpu1EUV-peKttdL9c-XmGaQElPLX0dqScKUabffi7y6EmfPGgDHa1DhwA9dAOManrH3g7EFzRsrb1F9QOz8xqYu3IC0wYglIMPxQZJYgah-8MoB-lTrlGP1HSE4VxAMflakTpSiYIk3wWvbguc83heiTsTYcfkPfqlAGDeqBNiYCQh-Xh3rO8phw9ZxA3xSKz19zZSVoJfM4N7X5psiHbkVEezVOsTwRuI_c5pUdjzlqGCJxgdUa0kCuaZuUnt3LM4vKTi1YwLOy-P5ZTtvjwcXIE_SQEIYa1Ra5p73XGHw"
}

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

{
  "iss": "EU.EORI.NL000000000",
  "sub": "EU.EORI.NL000000000",
  "jti": "3fc666aaee5b4bdca44f7c2782e88229",
  "iat": 1591966081,
  "exp": 1591966111,
  "aud": "EU.EORI.NL000000001",
  "versions_info": [
    {
      "version_name": "3.0.0",
      "valid_from": "2030-07-04T08:00:00Z",
      "valid_to": "2050-01-04T08:00:00Z",
      "version_status": "planned"
    },
    {
      "version_name": "2.0.1",
      "valid_from": "2018-01-01T00:00:00Z",
      "valid_to": "2031-01-02T00:00:00Z",
      "version_status": "active"
    },
    {
      "version_name": "1.9.0",
      "valid_from": "2019-01-04T08:00:00Z",
      "valid_to": "2030-07-04T08:00:00Z",
      "version_status": "active"
    }
  ]
}

Note

This page must be considered part of the iSHARE Trust Framework

Retrieves active and planned versions of iSHARE

get

Retrieves active and planned versions of iSHARE. By default returns current state. Server response is an iSHARE signed JSON Web Token. Please refer to the models 'jwt_header' and 'jwt_payload_versions_token' which indicate what the decoded response will look like.

Authorizations
Responses
200
OK
application/json
get
GET /versions HTTP/1.1
Host: isharetest.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "versions_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsIng1YyI6WyJNSUlFOWpDQ0E5NmdBd0lCQWdJSVoxUks0YnZmWjZ3d0RRWUpLb1pJaHZjTkFRRUxCUUF3UERFNk1EZ0dBMVVFQXd3eFZFVlRWQ0JwVTBoQlVrVWdSVlVnU1hOemRXbHVaeUJEWlhKMGFXWnBZMkYwYVc5dUlFRjFkR2h2Y21sMGVTQkhOVEFlRncweU16QTVNRGt4TWpJMk5USmFGdzB6TXpBNU1EWXhNakkyTlRGYU1JR0JNU1F3SWdZRFZRUUREQnRwVTBoQlVrVWdWR1Z6ZENCUVNWSWdVMkYwWld4c2FYUmxJREV4SGpBY0JnTlZCQVVURlVWVkxrVlBVa2t1VGt4VVJWTlVVRWxTVTBGVU1URVVNQklHQTFVRUN3d0xWR1Z6ZENCaGJtUWdVVUV4RmpBVUJnTlZCQW9NRFdsVFNFRlNSVlJsYzNSUVNWSXhDekFKQmdOVkJBWVRBazVNTUlJQ0lqQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FnOEFNSUlDQ2dLQ0FnRUFwMkwzUGpkTGJLeXRTeHl3UlE5bHlmNHpISkd5WGFMYTNNQkZjbWQyUzBrTklTWWx3aGloSmtFY3hHZWNpRisrVXRZV2tSUXF0eDNTZ3pWeXhjbm1yUHNIR1Q0cTFrSGk3NmFWNVdZbXFNU3RVRUsvWVozSW92MGU1MVVCV2FpeWRNMmsvY2MwQnF4MWlQYUdYT0JoR2lhdTEvN3dxQ29GSDQwN3BoSS9wWWxaMURHZStCOFFyQjNLZi9Mdjh0UCtyc3ZZK3JFMVkrSHZsWkpwVFdqQVU4ZDYzOEx3UXgxMTZXc0YxeFJFOGtkbGJVZEI0SXBOT2RqNEsvV1FhNldVd1I2Y1V4SmJibko4MWdpVm9OTHhQMzExNkwwek1HUlVMa0JFUDN4NUxzZ2djS1U2NFltUDB1Rk0zeEZzRVRQV0JzSkVKemFTVVhuMmNvVlgwdjFmbjZzWXlnVUZPWlpYVXdIeno1Sm53RHBvV3dxUHM4NzdhdGxZQ1dwbzNaRFhQME0wNHJlY1VCb3BDL2ZDcTNSUWQ4Ull5SGJHZktneDIzZ3RPTkloaUZmTkt6emgyUEc2dFdBOEpxejdCbXVhOUszSGdsWEl6cUZsNjhhaUJxNEdwdnh1UWdtUzUrb2hPenpvQktNSm9CYkJXc2l1RDJiaEk1VXc0MWhBbG1kYjZMbEs3MUp6K3cwandXeFhvcVFJYUpqY1RNTndFNHNmRmNTZm9qdk9Eb3h1V3VLS1pzKzZ4azJ6bVpZcDRscEsycFZ0VUMyVXErMjhnVXVnbU1vb1RZa0djWHZoMEpOeURGS3AyYXFWWGZkL0s4NTgxRGJOTWV2Y3FBTXdNbXV3U1JST3Z3bmt2SlBhZGlIQVlwY29WT3hPZlZ2Tm5GR29hOTZIb1o4ZStPOENBd0VBQWFPQnRUQ0JzakFmQmdOVkhTTUVHREFXZ0JSdHhXV0p5OStSVk5GclBMY0NwUzdOaW1pUUhUQW5CZ05WSFNVRUlEQWVCZ2dyQmdFRkJRY0RBZ1lJS3dZQkJRVUhBd1FHQ0NzR0FRVUZCd01CTURjR0NDc0dBUVVGQndFREJDc3dLVEFJQmdZRUFJNUdBUUV3Q0FZR0JBQ09SZ0VFTUJNR0JnUUFqa1lCQmpBSkJnY0VBSTVHQVFZQ01CMEdBMVVkRGdRV0JCVE94aS9PYUlpQ05XZEY4cFZYc3Y0elVRWGVPVEFPQmdOVkhROEJBZjhFQkFNQ0JzQXdEUVlKS29aSWh2Y05BUUVMQlFBRGdnRUJBQ1EzaTI4RU9xcDloMTNodnFPUTFuVHFpNjhkRldFdkFDSFd2OGFvTms4VHVwbWlhTjhpOEJmYnA3SlQyVG1kbG1POTBGTHUvRUlDN1lybWk2UVlhZ1FmNUVhZlFJSUdRMUdwUzZOTS9Qcm9tempEMFJ2eUdQT2RzcGNGSG1YV3c1UFcxc1BjL2F2eFRXU3FIQ1djOFIveU5ZYk56eGxraC9EUXc5N1YzSTB5TVp4aWlkRTNwdzFvRnAwQ1hzb1d6NFVrdU9lRXRPVFlEQU5vV2QrTHNKa011ZFgybWFBUnhBUWlYOUhRWnFVVEFJRjQxbFhFeitCcTFZUVJ3S1BPL0JVS0RmRkp1K2hia2lmQ1pzY0pkUmpRYVV2RXdVWG5YQitlYlNSb0dRRnpaWVhyUVh4YkxUdmxJYXlYL2EyUGV2cDdmZ3psQ1A2STZablNYdTdwRXk0PSIsIk1JSURTRENDQWpDZ0F3SUJBZ0lJU3hSM0ltekcxQmN3RFFZSktvWklodmNOQVFFTEJRQXdKekVsTUNNR0ExVUVBd3djVkVWVFZDQnBVMGhCVWtVZ1JtOTFibVJoZEdsdmJpQmxTVVJCVXpBZUZ3MHhPVEF5TWpJeE1EQTBNekZhRncwek9UQXlNVGN4TURBeU5EbGFNRHd4T2pBNEJnTlZCQU1NTVZSRlUxUWdhVk5JUVZKRklFVlZJRWx6YzNWcGJtY2dRMlZ5ZEdsbWFXTmhkR2x2YmlCQmRYUm9iM0pwZEhrZ1J6VXdnZ0VpTUEwR0NTcUdTSWIzRFFFQkFRVUFBNElCRHdBd2dnRUtBb0lCQVFESEIyQUJRTDd6d21pMXhJa08wYTJxNmpJSmRuM1FBbTBzMWxTZVFldjlGMkYzTTVaOHFpcVFKYXVyTVp5d1pmZE52ZzkrSXFHSE9qRGU2aElodVJ6em9BbzBBYk80TjlPZGYyUkREVTk1Tjd0b0ptQXlDaVlHZ1pmWnQ3QnNLRkllUTZwNkNzZ0tjUlhQaTBmZFhkVlNIcDRiWmZRT1FkY2xNYnRJVGlybkZ0VTA2TlBBaG9ZNjc2WXo5NnhGQUUwem9tNmVNVlBQT0ltMEc4Z2Q0NFhsbmJMMHcwbWNjQ2kyVlVaanZDSUw1OU82MU84dmxWeUxzQnFOTlRDdmY5QzJDTVlhRWF0WFp5ei9sd2dINkpZSHREMHVzWHQvK00wcUtZZTFvZW9MazBaaWNGWlhjazFpUzA5a0ZkZ2dLNUJsTm9kb1dKYURCUnJvNTFXaFkyV25BZ01CQUFHall6QmhNQThHQTFVZEV3RUIvd1FGTUFNQkFmOHdId1lEVlIwakJCZ3dGb0FVbFpNa3lieWhDeks1SE9CRkhLUk8rTUxTUi80d0hRWURWUjBPQkJZRUZHM0ZaWW5MMzVGVTBXczh0d0tsTHMyS2FKQWRNQTRHQTFVZER3RUIvd1FFQXdJQmhqQU5CZ2txaGtpRzl3MEJBUXNGQUFPQ0FRRUFaSDVRanVxK085RnB2NjM3ZzBjRjZuMUlMWUJMejFlTlpqRUIzZG9BZXh2aTVDelN3M29zd0pDU2VkR1czaGgwcUhPVEsyZ0k4M2poMFcyRUFuMmlzRmd3aE1vRzJqZDJZU0ZTa204US8yZU9mYzZNZ0dTQzVzT1RMNzVKN2J5TENvcmRxZC9ONGVhajNFcUtMYVdxN3I3dXN0UDgxUDhFSWx6MEQ4YTdsZmYxRlNvMjNIV1hUV1gyK20ydm9MQUU1bDk3YUdUR1JTMVVieGhQMmpGS1lKOVh6aUtlOU1RSlNaRWxUUThqcWcya1BGa0V4L1hxQVdxbEcxZGwxeXdMSnE1aWVQdksxUjRBWU5JL1liWlFrOXNsajh2K1AvNk03RXRFcnNmMnVJU2dld0xUY1dsMjR4M25HNXhiUVp4clA4bDJqU0dZbU9USW5nS09RU25iZmc9PSIsIk1JSURNekNDQWh1Z0F3SUJBZ0lJQkxVMmNaQVpxTEV3RFFZSktvWklodmNOQVFFTEJRQXdKekVsTUNNR0ExVUVBd3djVkVWVFZDQnBVMGhCVWtVZ1JtOTFibVJoZEdsdmJpQmxTVVJCVXpBZUZ3MHhPVEF5TWpJeE1EQXlORGxhRncwek9UQXlNVGN4TURBeU5EbGFNQ2N4SlRBakJnTlZCQU1NSEZSRlUxUWdhVk5JUVZKRklFWnZkVzVrWVhScGIyNGdaVWxFUVZNd2dnRWlNQTBHQ1NxR1NJYjNEUUVCQVFVQUE0SUJEd0F3Z2dFS0FvSUJBUUNyRFAyRFdYMy9iOHVNYXB6RUJBVFNhNmlaZnZnZ3pJQlVFeGtXRWJHOWUxblZ5L2pRazIwbmZTRk1VbVJUNk5oWWNka1NZTy9XcmtpOVk0RXBDeTF4dlpIcUwrNFk2UzlKTFp3Sjc2MExwWWxlK05hVnU3bWluTVVRY3VvajVuS3pDbHZhemIwMEF4NWdrSlVmUjN2M1g1R1hxUXJrV2F6TXQrazVUTk02VFd1SjMwcU9md3JIeDV2VExtVFVVaWgrQnNHTDNmNUdPczFWVFlJQ05oaVRqTjc0bjJXcXAya1VMV0llKy9YNlJaL2hLc3BhSEdabktEVlR3SSs4Wm1XRmVqdXhBNkRPWDdSc1lMS3ZRTzIxRm1iSUJvU3M5QXp2NTkvUnhXVUpWTU8wV2hEaEtwUWdDR2p3Z1YzMm9mTmRrRmdtZFZ1bHpOUElEMlJOYlRUTEFnTUJBQUdqWXpCaE1BOEdBMVVkRXdFQi93UUZNQU1CQWY4d0h3WURWUjBqQkJnd0ZvQVVsWk1reWJ5aEN6SzVIT0JGSEtSTytNTFNSLzR3SFFZRFZSME9CQllFRkpXVEpNbThvUXN5dVJ6Z1JSeWtUdmpDMGtmK01BNEdBMVVkRHdFQi93UUVBd0lCaGpBTkJna3Foa2lHOXcwQkFRc0ZBQU9DQVFFQWx6YUJWYUZoWm1IOXV4c0xTdjNGa2t4V1Z3QlIxR2hBeHdjSmxWNHgra3FYOHRjaEo0U0RMRXVXUnJGNEROdHZTUjNyNjlLejhlWUk1WHVXMWVHMTJZakdHVmxZaWpkeHJHMUFOekduMnZkbzl2TDdkRUZVRU1LMUFLeFJzdGJUZEU3eXd6SVYvQzYxdzhKcnh3THR0OU9qZFVFVVBIdUdUanV2NW5GQlBkRnpPY3Z1K0RUTWw3M0NKUDJ6ZVpVRmd1ajU1TXNYWTQ1TXJYcmJndCtMSnFVdTRwa0IyYkx1OUZiZVJMV1pKdWtuWVNyVzRmeVFCWjJpK01zR2RpQktRY2YzZkxYanBjaDQ4L3A3U2lUazR1ZmxvQmFxVENsdC9FdFdYRFNtRmN2NFFqQmsxbVVQdTl2eGlrY0hEa0F2SnJPWEdnMGIrM2VJNGE3T1RmQWIxZz09Il19.eyJhdWQiOiJFVS5FT1JJLk5MMDAwMDAwMDAxIiwiZXhwIjoxNzExNDY0NjE1LCJpYXQiOjE3MTE0NjQ1ODUsImlzcyI6IkVVLkVPUkkuTkxURVNUUElSU0FUMSIsImp0aSI6IjY3ZGJjMGU3YmFjZDQ1MTA5YjMxZDk2ODAxYWU2MTFlIiwibmJmIjoxNzExNDY0NTg1LCJzdWIiOiJFVS5FT1JJLk5MVEVTVFBJUlNBVDEiLCJ2ZXJzaW9uc19pbmZvIjpbeyJ2ZXJzaW9uX25hbWUiOiIxLjAiLCJ2YWxpZF9mcm9tIjoiMjAyMy0wOS0wOSAxNDo1Mzo1NCIsInZhbGlkX3RvIjoiMjAyNS0wMy0yNiAxNDo0OTo0NSIsInZlcnNpb25fc3RhdHVzIjoiYWN0aXZlIn1dfQ.X5ruXvcVFBSAJezvwZOXOguZUYzZBEEWMnqTJJ9REfFRxCFbvaKaqM_gqu7b-UkZn8pAPf1YnvYWU4bSHuF3iU0wzbZhFZ5i87ZmYnNXcq9wnmFpEhRI7UaoWfq4vw--kWmmiFZPm9_vJnjPyqJ4s_hnXtYzPmvjbrY5tG93HoBaY8MurlBCNypFchGiN_VWrtWw3wz5CV-HQQRn6zt2V-VjG_ajFG0VW0fmY_wbCXdo5Lbu6pxRgZXykPFn88JurxD31OrkuxZ-ZbjwuyN0LOw7h3PlXK-h3JThNnFydPnxJEgxE_Y32jSTsfkTbbJNIS5Mab0KnDQvxeI54q56DHiD0j4oik2E6H94y48sfuZW74J4z1RtiTXGtwVrMFnNCsXTUXLxmGpPkvi_JU00-YrULmO4S4AeMJ1hAkJWrSUOkiIFNz3ocnTAV6qI1X99MYELp0Hf93-vxFqC4ekvbn6XaFggCrMb-6mge86lpqW0knNQP6y-Oq6dA8eB13AeTEVpE08ZNvq17nma_a818AhOOU7oTGIqvOB4fcVMI3CrXiGSNAQiuE8QDIWxZunz5Bv4VXbkV7xdY_oz5WUWJ6iOFifg8iSZJ9gaNDSdcSWieHE-OYzIN6gx6rZdKzwWpB8eP2ADDWCaH56drbaOr01zvZgGCnQIEvZIRJZs7WE"
}
  • GETRetrieves active and planned versions of iSHARE
  • Response model
  • Example request
  • Example response