---
title: pp_get_group
description: "``` /** * Retrieve a Permission Group object by providing its ID * @param int group_id * @param string agent_type (pp_group, bp_group, etc.) * @return object Permission Group * - ID * - group_name * - group_description * - metagroup_type…"
url: "https://publishpress.com/knowledge-base/pp-get-group/"
updated: "2025-05-06"
category: PublishPress Permissions / Developer
---

# pp_get_group

```
/**
 * Retrieve a Permission Group object by providing its ID

 * @param int group_id
 * @param string agent_type (pp_group, bp_group, etc.)
 * @return object Permission Group
 *  - ID
 *  - group_name
 *  - group_description
 *  - metagroup_type
 *  - metagroup_id
 */
function pp_get_group( $group_id, $agent_type = 'pp_group' )
```

## Example usage

```
$group_id = 123;
$group = pp_get_group( $group_id );
```

## Notes

metagroup_type and metagroup_id do not apply to custom-defined groups.