---
title: "List directory group members"
method: GET
path: "/directories/{directory_id}/groups/{group_id}/members"
tags: ["Directories"]
---

# List directory group members

`GET /directories/{directory_id}/groups/{group_id}/members`

## Request

- Base URL: `https://api.clerk.com/v1`
- URL: `https://api.clerk.com/v1/directories/{directory_id}/groups/{group_id}/members`
- Auth: HTTP bearer

Returns the members of a group, as reported by the identity provider, using cursor-based pagination.
Each member carries the Clerk user it is linked to, or null until that user has been provisioned.

## Path parameters

- `directory_id` string, required
- `group_id` string, required

## Query parameters

- `limit` integer
- `starting_after` string

## Response `200`

A cursor-paginated list of the members of a group.

- object
  - `data` DirectoryGroupMember[], required
    - `object` 'directory_group_member', required: String representing the object's type. Always "directory_group_member".
    - `id` string, required: The directory user ID of the member, as assigned by the directory.
    - `user_id` string, nullable, required: The ID of the Clerk user this member is linked to. Null until the member has been provisioned into Clerk.
  - `cursor` object, required: Cursor information for pagination.
    - `starting_after` string, nullable: Cursor to fetch the next page of results. Pass it back as `starting_after` on the next request.
    - `ending_before` string, nullable: Cursor to fetch the previous page of results. Pass it back as `ending_before` on the next request.
    - `has_next_page` boolean, required: Whether more results can be fetched using the `starting_after` cursor.

## Other responses

- `401`: Authentication invalid
- `403`: Authorization invalid
- `404`: Resource not found

## Changes

- **2026-10-23** `2971dafb5d9d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/directories/:directory_id/groups/:group_id/members/get.md)

---

[API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [All operations](https://skmtc.dev/clerk/apis/clerk-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clerk/apis/clerk-backend-api/revisions/8bdc1f8790c7?raw)