---
title: "Get SSO linkages"
method: GET
path: "/v2/authn/sso/sso-linkage"
tags: ["SSO Authentication"]
---

# Get SSO linkages

`GET /v2/authn/sso/sso-linkage`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/authn/sso/sso-linkage`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/authn/sso/sso-linkage/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves SSO linkage information for specified SSO configurations.

## Query parameters

- `partitionId` string, required
- `accountId` string, required

## Response `200`

SSO linkages retrieved successfully

- SSOLinkage[]
  - `ssoName` string: Name of the SSO configuration
  - `emailAddress` string, email
  - `partitionId` string: Partition identifier
  - `accountId` string: Account identifier
  - `userId` string: User identifier
  - `externalId` string: External identity provider ID
  - `externalEmail` string, email: Email from external identity provider

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - insufficient permissions

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/7223246c352c?raw)