List SSO providers — StatusDashboard Docs

GET /app/sso/providers

Returns a summary list of SSO providers for the authenticated organization, including domain mappings. Requires the SSO feature entitlement.

The list response omits large or sensitive configuration fields (samlMetadataXml, OIDC endpoints, client secrets). Use Get SSO provider for the full record when editing or inspecting a provider.

Request

See API Basics for required headers.

This endpoint takes no request body.

Sample request

curl https://api.statusdashboard.com/app/sso/providers \
  -H "Authorization: Bearer bcf847abf5c6:def456"

Sample response

Status: 200 OK

{
  "providers": [
    {
      "providerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Acme SAML",
      "providerType": "SAML",
      "cognitoProviderName": "PLATFORM-a1b2c3d4-ef123456",
      "enabled": true,
      "domains": ["acme.com", "acme.org"],
      "createdAt": "2026-01-10T12:00:00.000Z",
      "updatedAt": "2026-04-01T08:00:00.000Z"
    },
    {
      "providerId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Acme OIDC",
      "providerType": "OIDC",
      "cognitoProviderName": "PLATFORM-b2c3d4e5-f12345678",
      "enabled": false,
      "domains": ["internal.acme.com"],
      "createdAt": "2026-02-15T09:30:00.000Z",
      "updatedAt": "2026-03-20T14:00:00.000Z"
    }
  ],
  "limits": {
    "domainsPerSSOProvider": 5
  }
}

limits.domainsPerSSOProvider is the maximum number of email domains each SSO provider may store. Contact support to request an increase.

Response fields

Top-level

Field	Type	Description
`providers`	object[]	Summary list of SSO providers (see below).
`limits.domainsPerSSOProvider`	number	Max email domains per SSO provider for your organization.

Provider object

Field	Type	Description
`providerId`	string	Unique identifier for the provider.
`name`	string	Display name for the provider.
`providerType`	`"SAML"` \| `"OIDC"`	The configured provider protocol.
`cognitoProviderName`	string	Internal Cognito identity provider name.
`enabled`	boolean	Whether this provider is active for SSO login.
`domains`	string[]	Email domains that route users to this provider.
`createdAt`	string	ISO 8601 timestamp.
`updatedAt`	string	ISO 8601 timestamp.

SAML metadata, OIDC endpoint URLs, and client secrets are available only from Get SSO provider.

Error responses

Status	When
`403`	SSO feature not enabled on the plan.