---
title: "GET /v1/organizations"
method: GET
path: "/v1/organizations"
tags: ["SSOReadyService"]
---

# GET /v1/organizations

`GET /v1/organizations`

Gets a list of organizations.

## Query parameters

- `pageToken` string

## Response `200`

OK

- ListOrganizationsResponse
  - `organizations` Organization[] — List of organizations.
    - `id` string — Unique identifier for this organization.
    - `environmentId` string — The environment this organization belongs to.
    - `displayName` string — An optional human-friendly name for this organization.
    - `externalId` string — An identifier you can attach to an organization. Meant to be used to correlate an SSOReady organization to your internal equivalent concept. External IDs are unique within an environment. No two organizations in the same environment can have the same external ID.
    - `domains` string[] — A list of domains that users from this organization use. SAML connections and SCIM directories within this organization will only produce users whose email are included in `domains`. SSOReady will reject SAML and SCIM users that do not fall within `domains`.
  - `nextPageToken` string — Value to use as `pageToken` for the next page of data. Empty if there is no more data.

## Other responses

- `default` — Default error response

## Changes

- **2024-10-15** `0827d713f08e` — 1 info
  - added the optional property `organizations/items/displayName` to the response with the `200` status
- **2024-08-16** `132245ed6de0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ssoready/apis/ssoreadyservice-api/changes/v1/organizations/get.md)

---

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