---
title: pp_get_group_members
description: "``` /** * Retrieve users who are members of a specified group * @param int group_id * @param string agent_type * @param string cols ('all' | 'id') * @param array args : * - status ('active' | 'scheduled' | 'expired'…"
url: "https://publishpress.com/knowledge-base/pp-get-group-members/"
updated: "2025-05-06"
category: PublishPress Permissions / Developer
---

# pp_get_group_members

```
/**
 * Retrieve users who are members of a specified group

 * @param int group_id
 * @param string agent_type
 * @param string cols ('all' | 'id')
 * @param array args :
 *   - status ('active' | 'scheduled' | 'expired' | 'any')
 * @return array of objects or IDs
 */
function pp_get_group_members( $group_id, $agent_type = 'pp_group', $cols = 'all', $args = array() )
```

## Example usage

```
$group = pp_get_group_by_name( 'Cool Group' );

$active_member_ids = pp_get_group_members( $group->ID, 'pp_group', 'id' );
$former_member_ids = pp_get_group_members( $group->ID, 'pp_group', 'id', array( 'status' => 'expired' ) );
```

## Notes

- Only active group members are returned, unless a different status argument is specified.
- scheduled and expired statuses require PP Membership extension