---
search:
exclude: true
---
# ListIssuesRequest
| Field | Type | Description |
|---|---|---|
| issue_group_id | string | The unique identifier for the issue group this issue belongs to. |
| offset | uint32 | Used to paginate through results. To get the next page result, set this to the desired starting offset. For example, setting to 10 will start with the 10th record. The default value is 0. |
| limit | optional uint32 | This defines the upper bound of the number of items returned. The maximum value supported is 100, meaning that we’ll never return more than max(items.count, limit, 100). |
| filters | repeated [bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters](#bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters){ title="bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters"} | Filter the list of issues based on the current user's relationship to the issue. This is a logical AND. If no filters are supplied, all issues are returned. |
| issue_query | [bitdrift.public.unary.issues.v1.IssueQuery](bitdrift_public_unary_issues_v1_IssueQuery.md#bitdrift.public.unary.issues.v1.IssueQuery){ title="bitdrift.public.unary.issues.v1.IssueQuery"} | |
| sort | repeated [bitdrift.public.unary.issues.v1.ListIssuesRequest.Sort](#bitdrift.public.unary.issues.v1.ListIssuesRequest.Sort){ title="bitdrift.public.unary.issues.v1.ListIssuesRequest.Sort"} | Orders issues by caller-visible attributes. Apply criteria in the order provided. |
#### Example
```json
{
"filters": [
{
"platform": {
"value": [
{
"apple": {
"apps": [
{
"app_id": "com.example.app"
}
]
}
}
]
}
}
],
"issue_group_id": "12710232306638153143",
"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": "OCCURRED_AT"
}
]
}
```
# ListIssuesRequest.Sort
| Field | Type | Description |
|---|---|---|
| key | [bitdrift.public.unary.issues.v1.ListIssuesRequest.Sort.SortKey](#bitdrift.public.unary.issues.v1.ListIssuesRequest.Sort.SortKey){ title="bitdrift.public.unary.issues.v1.ListIssuesRequest.Sort.SortKey"} | Selects which caller-visible issue attribute to order by. |
| direction | [bitdrift.public.unary.common.v1.SortDirection](bitdrift_public_unary_common_v1_SortDirection.md#bitdrift.public.unary.common.v1.SortDirection){ title="bitdrift.public.unary.common.v1.SortDirection"} | Selects whether results are returned in ascending or descending order. |
#### Example
```json
{
"direction": "DESCENDING",
"key": "OCCURRED_AT"
}
```
# ListIssuesRequest.Sort.SortKey
| Name | Number | Description |
|---|---|---|
| SORT_KEY_UNSPECIFIED | 0 | |
| OCCURRED_AT | 1 | |
| ISSUE_REASON | 2 | |
# ListIssuesRequest.ListIssuesFilters
| Field | Type | Description |
|---|---|---|
| platform | [bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters.Platform](#bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters.Platform){ title="bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters.Platform"} | Filters on the platform of issues.
(Only one of platform, or time_range, advanced_filters can be set) |
| time_range | [bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters.TimeRange](#bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters.TimeRange){ title="bitdrift.public.unary.issues.v1.ListIssuesRequest.ListIssuesFilters.TimeRange"} | Filters on the time range of issues.
(Only one of time_range, or platform, advanced_filters can be set) |
| advanced_filters | [bitdrift.public.unary.issues.v1.AdvancedFilter](bitdrift_public_unary_issues_v1_AdvancedFilter.md#bitdrift.public.unary.issues.v1.AdvancedFilter){ title="bitdrift.public.unary.issues.v1.AdvancedFilter"} | Filters on the advanced filters of issues.
(Only one of advanced_filters, or platform, time_range can be set) |
#### Example
```json
{
"platform": {
"value": [
{
"apple": {
"apps": [
{
"app_id": "com.example.app"
}
]
}
}
]
}
}
```
# ListIssuesRequest.ListIssuesFilters.Platform
| Field | Type | Description |
|---|---|---|
| value | repeated [bitdrift.public.shared.platform.v1.Platform](bitdrift_public_shared_platform_v1_Platform.md#bitdrift.public.shared.platform.v1.Platform){ title="bitdrift.public.shared.platform.v1.Platform"} | The platform of an issue group to filter by. |
#### Example
```json
{
"value": [
{
"apple": {
"apps": [
{
"app_id": "com.example.app"
}
]
}
}
]
}
```
# ListIssuesRequest.ListIssuesFilters.TimeRange
| Field | Type | Description |
|---|---|---|
| time_range | [bitdrift.public.unary.common.v1.TimeRange](bitdrift_public_unary_common_v1_TimeRange.md#bitdrift.public.unary.common.v1.TimeRange){ title="bitdrift.public.unary.common.v1.TimeRange"} | |
#### Example
```json
{
"time_range": {
"relative_time_range": {
"duration": "3600s",
"offset": "3600s"
}
}
}
```