---
title: Get User Groups
framework: Apple Business API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple business api 2.5+]
path: applebusinessapi/get-user-groups
---

# Get User Groups

Get a list of user groups in an organization.

## URL

GET https://api-business.apple.com/v1/userGroups

## Query Parameters

fields[userGroups]: The fields to return for included related types. limit: The number of included related resources to return.

## Response Codes

200 OK: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 429 : Too Many Requests

## Example

Example

## Topics

### Responses

- [UserGroupsResponse](applebusinessapi/usergroupsresponse.md)

## See Also

### UserGroups

- [Get User Group Information](applebusinessapi/get-usergroup-information.md)
- [Get User IDs for a User Group](applebusinessapi/get-all-user-ids-for-a-user-group.md)