Retrieves all historical configuration of a given sso configuration for a given authorisation server.

GET /organisations/{OrganisationId}/authorisationservers/{AuthorisationServerId}/sso-configuration/{ssoConfigurationId}/versions

Headers

  • x-fapi-auth-date string

    The time when the PSU last logged in with the TPP. All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: Sun, 10 Sep 2017 19:43:31 UTC

    Format should match the following pattern: ^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$.

  • x-fapi-customer-ip-address string

    The PSU's IP address if the PSU is currently logged in with the TPP.

  • x-fapi-interaction-id string

    An RFC4122 UID used as a correlation id.

  • x-customer-user-agent string

    Indicates the user-agent that the PSU is using.

Path parameters

  • OrganisationId string Required

    The organisation ID

    Minimum length is 1, maximum length is 40. Format should match the following pattern: ^[^<>]*$.

  • AuthorisationServerId string(uuid) Required

    The authorisation server Id

    Maximum length is 40. Format should match the following pattern: ^[^<>]*$.

  • ssoConfigurationId string(uuid) Required

    The unique identifier representing a given sso configuration of an authorisation server

Query parameters

  • page integer

    The page number to return of the result set

  • size integer

    The size of the pages to return

  • sort string

    The field name to sort

  • status string

    Filters the response by one or more status values

    Format should match the following pattern: ^[^<>]*$. Values are Active, Assignable, Pending, Rejected, or Inactive.

Responses

  • 200 application/json

    A paginated set of sso configuration versions for a given authorisation server sso configuration

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

    Hide response attributes Show response attributes object
    • content array[object]

      SSO Configuration Version for a given IDP SSO configuration

      Hide content attributes Show content attributes object

      SSO Configuration Version for a given IDP SSO configuration

      • AdditionalScopeValues string

        Additional space-separated scope values that will be requested alongside the default of openid, email and profile

        Maximum length is 255. Default value is empty.

      • AuthenticationPolicies array[string] Required

        List of sign-in policies that are applied during authentication

        Values are CLICK_TO_ACCEPT_TERMS, ESIGNATURE_TERMS, RECOVERY_CODES, TWO_FACTOR, or VERIFY_EMAIL_AND_MOBILE.

      • ClientID string Required

        The Client ID to be used by the Raidiam IDP to retrieve identity claims from the external IDP used for SSO

        Maximum length is 255.

      • GroupClaim string Required

        The name of the claim in the ID Token returned by the external IDP containing the list of user group identifiers

        Maximum length is 60.

      • GroupClaimPath string

        Valid JSON Path indicating the location in the ID Token of the group claim

        Maximum length is 255. Format should match the following pattern: ^\$[.\[].*. Default value is $..

      • RestrictedDomains array[string] Required

        List of email domains that will be forced to use this IDP for SSO

        Not more than 10 elements. Maximum length of each is 255.

      • SupportedDomains array[string] Required

        List email domains that will have the option to use this IDP for SSO

        Not more than 10 elements. Maximum length of each is 255.

      • Status string Required

        The status of a resource that has an approval flow

        Format should match the following pattern: ^[^<>]*$. Values are Active, Assignable, Pending, Rejected, or Inactive.

      • CreatedAt string(date-time)
      • ID string(uuid)

        Unique identifier of the given OpenID Connect Provider's SSO Configuration

      • SsoConfigurationID string(uuid)

        Unique identifier of the given OpenID Connect Provider's SSO Configuration

      • UpdatedAt string(date-time)
      • Version integer(int16)

        Version number of the SSO configuration

    • empty boolean
    • numberOfElements integer
    • offset integer
    • pageNumber integer
    • pageable object
      Hide pageable attributes Show pageable attributes object
      • number integer

        Page number

      • offset integer

        Offset

      • size integer

        Size of the page

      • sort object
        Hide sort attributes Show sort attributes object
        • orderBy array[object]
          Hide orderBy attributes Show orderBy attributes object
          • ascending boolean

            Whether ascending

          • direction string

            Direction of sort, i.e. ascending or descending

            Values are ASC or DESC.

          • ignoreCase boolean

            Was the case ignored

          • property string

            Name of the property used for sorting

        • sorted boolean
      • sorted boolean

        Is the page sorted

      • unpaged boolean

        Is this an unpaged response

    • size integer
    • totalPages integer
    • totalSize integer
  • 401

    Unauthorized

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 403

    Forbidden

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 429

    Too many requests, maximum capacity reached. Requests are now throttled.

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 500

    Internal Server Error

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 502

    Bad Gateway

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 504

    Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

GET /organisations/{OrganisationId}/authorisationservers/{AuthorisationServerId}/sso-configuration/{ssoConfigurationId}/versions
curl \
 --request GET 'https://matls-api.sandbox.raidiam.io/organisations/{OrganisationId}/authorisationservers/{AuthorisationServerId}/sso-configuration/{ssoConfigurationId}/versions' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "x-fapi-auth-date: string" \
 --header "x-fapi-customer-ip-address: string" \
 --header "x-fapi-interaction-id: string" \
 --header "x-customer-user-agent: string"
Response examples (200)
# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "content": [
    {
      "AdditionalScopeValues": "",
      "AuthenticationPolicies": [
        "CLICK_TO_ACCEPT_TERMS"
      ],
      "ClientID": "string",
      "GroupClaim": "string",
      "GroupClaimPath": "$.",
      "RestrictedDomains": [
        "string"
      ],
      "SupportedDomains": [
        "string"
      ],
      "Status": "Active",
      "CreatedAt": "2025-05-04T09:42:00Z",
      "ID": "string",
      "SsoConfigurationID": "string",
      "UpdatedAt": "2025-05-04T09:42:00Z",
      "Version": 42
    }
  ],
  "empty": true,
  "numberOfElements": 42,
  "offset": 42,
  "pageNumber": 42,
  "pageable": {
    "number": 42,
    "offset": 42,
    "size": 42,
    "sort": {
      "orderBy": [
        {
          "ascending": true,
          "direction": "ASC",
          "ignoreCase": true,
          "property": "createdAt"
        }
      ],
      "sorted": true
    },
    "sorted": true,
    "unpaged": true
  },
  "size": 42,
  "totalPages": 42,
  "totalSize": 42
}