---
search:
exclude: true
---
# ListIssueGroupsRequest
**Source definition:** [`src/bitdrift/public/unary/issues/v1/issues.proto#L222-L258`]()
| Field | Type | Description |
|---|---|---|
| offset | optional uint32 | The starting offset for pagination. For example, set this to 10 to start with the 10th record. Defaults to 0. |
| limit | optional uint32
between 1 and 100 | The maximum number of items to return. The server returns at most min(items.count, limit, 100) items. |
| issue_query | [bitdrift.public.unary.issues.v1.IssueQuery](bitdrift_public_unary_issues_v1_IssueQuery.md "bitdrift.public.unary.issues.v1.IssueQuery") | |
| issue_group_query | [bitdrift.public.unary.issues.v1.IssueGroupQuery](bitdrift_public_unary_issues_v1_IssueGroupQuery.md "bitdrift.public.unary.issues.v1.IssueGroupQuery") | |
| sort | array of [bitdrift.public.unary.issues.v1.ListIssueGroupsRequest.Sort](#bitdrift.public.unary.issues.v1.ListIssueGroupsRequest.Sort "bitdrift.public.unary.issues.v1.ListIssueGroupsRequest.Sort")
up to 100 items | Orders issue groups by caller-visible attributes. Apply criteria in the order provided. |
#### Example
```json
{
"issue_group_query": {
"assignee": [
{
"email": "user@example.com",
"id": "usr_abc123",
"name": "Jane Doe"
}
],
"issue_group_status": [
"NEW"
]
},
"issue_query": {
"advanced_filters": {
"and_conditions": [
{
"or_conditions": [
{
"lhs_typed": "LHS_TYPED_APP_ID",
"operator": "EQUAL",
"rhs": "com.example.app"
}
]
}
]
},
"feature_flag_filters": [
{
"exclusive": false,
"name": "EXC_BAD_ACCESS",
"variant": "null pointer"
}
],
"grouping_key": [
"12710232306638153143"
],
"platforms": [
{
"apple": {
"apps": [
{
"app_id": "com.example.app"
}
]
}
}
],
"time_range": {
"relative_time_range": {
"duration": "3600s",
"offset": "3600s"
}
}
},
"limit": 25,
"offset": 1,
"sort": [
{
"direction": "DESCENDING",
"key": "MOST_RECENT_OCCURRENCE"
}
]
}
```
# ListIssueGroupsRequest.Sort
**Source definition:** [`src/bitdrift/public/unary/issues/v1/issues.proto#L223-L239`]()
| Field | Type | Description |
|---|---|---|
| key | [bitdrift.public.unary.issues.v1.ListIssueGroupsRequest.Sort.SortKey](#bitdrift.public.unary.issues.v1.ListIssueGroupsRequest.Sort.SortKey "bitdrift.public.unary.issues.v1.ListIssueGroupsRequest.Sort.SortKey")
must be a defined enum value | Selects which caller-visible issue group attribute to order by. |
| direction | [bitdrift.public.unary.common.v1.SortDirection](bitdrift_public_unary_common_v1_SortDirection.md "bitdrift.public.unary.common.v1.SortDirection")
must be a defined enum value | Selects whether results are returned in ascending or descending order. |
#### Example
```json
{
"direction": "DESCENDING",
"key": "MOST_RECENT_OCCURRENCE"
}
```
# ListIssueGroupsRequest.Sort.SortKey Enum
**Source definition:** [`src/bitdrift/public/unary/issues/v1/issues.proto#L224-L232`]()
| Name | Number | Description |
|---|---|---|
| SORT_KEY_UNSPECIFIED | 0 | |
| MOST_RECENT_OCCURRENCE | 1 | |
| EARLIEST_OCCURRENCE | 2 | |
| FIRST_REPORTED | 3 | |
| IMPACTED_USERS | 4 | |
| IMPACTED_SESSIONS | 5 | |
| ISSUE_REASON | 6 | |