# Get

Launch stage: Beta

`GET /api/2.0/identity/{name=external-groups/*}`

Retrieves an external group with the given external ID from the customer's
 IdP. If the group does not exist, it will be created in the account. If the
 customer is not onboarded onto Automatic Identity Management (AIM), this will
 return an error. Workspace-scoped variant for workspace-authenticated callers.

API scopes: identity

## Path parameters

- `name` (string, required)
  Required. The resource name of the external group.
   Format: external-groups/{external_group_id}

## Returns

Returns the ExternalGroup object.

## Response

```json
{
  "name": "string",
  "external_group_id": "string",
  "internal_id": "string",
  "display_name": "string",
  "account_id": "string"
}
```