# List SSO providers

Retrieve all SSO providers configured for your organization.

Source: https://statusdashboard.com/docs/api/security/sso/list

`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](/docs/api/security/sso/get) for the full record when editing or inspecting a provider.

***

## Request
See [API Basics](/docs/api) for required headers.

This endpoint takes no request body.

***

## Sample request
```bash
curl https://api.statusdashboard.com/app/sso/providers \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `200 OK`**

```json
{
  "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](/docs/api/security/sso/get).

***

## Error responses
| Status | When                                 |
| ------ | ------------------------------------ |
| `403`  | SSO feature not enabled on the plan. |