# SAML SSO

Exchanges a user access token for a SAML response, used to perform an SSO login into a SAML service provider. The user access token, retrieved via a successful login with Transmit, is used to authorize this request.

Endpoint: GET /v1/serviceprovider/saml2/sso/{serviceProviderId}
Security: UserAccessToken

## Path parameters:

  - `serviceProviderId` (string, required)

## Query parameters:

  - `SAMLRequest` (string)
    SAMLRequest

  - `RelayState` (string)
    RelayState

## Response 201 fields (application/json):

  - `result` (object, required)

  - `result.SsoUrl` (string, required)

  - `result.SAMLResponse` (string, required)

  - `result.RelayState` (string, required)

## Response 400 fields (application/json):

  - `message` (array, required)
    Example: "Bad request"

  - `error_code` (number, required)
    Example: 400