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. Format of each should match the following pattern: ^\S*$.

      • 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. Format of each should match the following pattern: ^\S*$.

      • 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
}