---
title: List beta groups
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-betagroups
---

# List beta groups

Find and list beta groups for all apps.

## URL

GET https://api.appstoreconnect.apple.com/v1/betaGroups

## Query Parameters

fields[apps]: Fields to return for included related types. fields[betaGroups]: Fields to return for included related types. fields[betaRecruitmentCriteria]: fields[betaTesters]: Fields to return for included related types. fields[builds]: Fields to return for included related types. filter[app]: Attributes, relationships, and IDs by which to filter. filter[builds]: Attributes, relationships, and IDs by which to filter. filter[id]: Attributes, relationships, and IDs by which to filter. filter[isInternalGroup]: Attributes, relationships, and IDs by which to filter. filter[name]: Attributes, relationships, and IDs by which to filter. filter[publicLinkEnabled]: Attributes, relationships, and IDs by which to filter. filter[publicLinkLimitEnabled]: Attributes, relationships, and IDs by which to filter. filter[publicLink]: Attributes, relationships, and IDs by which to filter. include: Relationship data to include in the response. limit: Number of resources to return. limit[betaTesters]: Number of included related resources to return. limit[builds]: Number of included related resources to return. sort: Attributes by which to sort.

## Response Codes

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

## See Also

### Getting Beta Group Information

- [Read beta group information](appstoreconnectapi/get-v1-betagroups-_id_.md)
- [Read the app information of a beta group](appstoreconnectapi/get-v1-betagroups-_id_-app.md)
- [Get the app ID for a beta group](appstoreconnectapi/get-v1-betagroups-_id_-relationships-app.md)
- [Read Metrics for Beta Testers in a Beta Group](appstoreconnectapi/get-v1-betagroups-_id_-metrics-betatesterusages.md)
- [Read Recruitment Criteria for a Beta Group](appstoreconnectapi/get-v1-betagroups-_id_-betarecruitmentcriteria.md)
- [List beta recruitment criterion IDs for a beta group](appstoreconnectapi/get-v1-betagroups-_id_-relationships-betarecruitmentcriteria.md)
- [Read build compatibility for a beta group](appstoreconnectapi/get-v1-betagroups-_id_-betarecruitmentcriterioncompatiblebuildcheck.md)
- [Get the compatible build check ID for a beta group recruitment criterion](appstoreconnectapi/get-v1-betagroups-_id_-relationships-betarecruitmentcriterioncompatiblebuildcheck.md)