---
title: "List external groups in an organization"
method: GET
path: "/orgs/{org}/external-groups"
tags: ["teams"]
---

# List external groups in an organization

`GET /orgs/{org}/external-groups`

Lists external groups available in an organization. You can query the groups using the `display_name` parameter, only groups with a `group_name` containing the text provided in the `display_name` parameter will be returned.  You can also limit your page results using the `per_page` parameter. GitHub Enterprise Server generates a url-encoded `page` token using a cursor value for where the next page begins. For more information on cursor pagination, see "[Offset and Cursor Pagination explained](https://dev.to/jackmarchant/offset-and-cursor-pagination-explained-b89)."

You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see "[GitHub's products](https://docs.github.com/enterprise-server@3.8/github/getting-started-with-github/githubs-products)" in the GitHub Help documentation.

## Path parameters

- `org` string, required

## Query parameters

- `per_page` integer
- `page` integer
- `display_name` string

## Response `200`

Response

- ExternalGroups — A list of external groups available to be connected to a team
  - `groups` object[] — An array of external groups available to be mapped to a team
    - `group_id` integer, required — The internal ID of the group
    - `group_name` string, required — The display name of the group
    - `updated_at` string, required — The time of the last update for this group

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-7.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-7/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-7/versions/5438365412fe/schema)