---
title: "Get organization SSO status"
method: GET
path: "/organizations/{organization}/sso"
tags: ["Organization SSO"]
---

# Get organization SSO status

`GET /organizations/{organization}/sso`

Get SSO add-on status, identity provider connection state, directory sync, and verified domains
### Authorization
A service token or OAuth token must have at least one of the following access or scopes in order to use this API endpoint:

**Service Token Accesses**
 `manage_sso`

**OAuth Scopes**

 | Resource | Scopes |
| :------- | :---------- |
| Organization | `manage_sso` |

## Path parameters

- `organization` string, required

## Response `200`

Returns organization SSO status

- object
  - `type` 'OrganizationSSO', required — The resource type
  - `id` string, required — The organization ID
  - `enabled` boolean, required — Whether the SSO add-on is enabled for the organization
  - `configured` boolean, required — Whether an identity provider connection is active
  - `directory` boolean, required — Whether directory sync is enabled
  - `has_verified_domain` boolean, required — Whether the organization has at least one verified email domain
  - `domains` object[], required
    - `type` 'OrganizationDomain', required — The resource type
    - `id` string, required — The public ID of the organization domain
    - `domain` string, required — The domain name
    - `state` 'pending' | 'verified' | 'failed', required — The verification state of the domain
    - `verified_at` string, nullable, required — When the domain was verified
    - `failure_reason` string, nullable, required — The reason domain verification failed
    - `created_at` string, required — When the domain was created
    - `updated_at` string, required — When the domain was last updated
  - `domain_verification_url` string, nullable, required — URL to open for verifying an email domain, returned when SSO is enabled

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-08-28** `6d28c038c4fd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/planetscale/apis/planetscale-api/changes/organizations/:organization/sso/get.md)

---

[API](https://skmtc.dev/planetscale/apis/planetscale-api.md) · [All operations](https://skmtc.dev/planetscale/apis/planetscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/planetscale/planetscale-api/revisions/6d28c038c4fd/schema)