# issuesInput
Input parameters for retrieving and filtering security issues. Provides comprehensive options for customizing the issues query including filtering, sorting, pagination, and search capabilities.
### Examples
```graphql
input IssuesInput {
scanID: String
limit: Int!
page: Int
search: [AutoCompleteSearch]
offset: Int
filters: IssueFilters
sort: IssuesSort
owners: [String]
tagIds: [String]
inventoryFilters: [InventoryTypes]
dateRange: DateRange
limitAggItems: Int
offsetAggItems: Int
ignoreEnvCheck: Boolean
exportsOptions: IssuesExportOptions
issueId: String
topOffset: Int
topLevelSearch: String
scrollDirection: String
openItems: [FilterTypes]
conditionalFilters: [ConditionalFilters]
cursorValue: String
}
```
### Fields
| Field | Description | Supported fields |
| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| scanID `String` | Retrieve issues associated with a specific scan execution | |
| limit `Int!` | Maximum number of issues to return in a single response (default: 10, max: 1000) | |
| page `Int` | Page number for pagination (Deprecated, use offset instead) | |
| search [`[AutoCompleteSearch]`](/api-documentation/api-reference/api--application/types/inputs/auto-complete-search.md) | List of search filters for finding specific issues | fieldName String
value \[String]
|
| offset `Int` | Number of records to skip for pagination | |
| ~~filters~~ [~~`IssueFilters`~~](/api-documentation/api-reference/api--issue/types/inputs/issue-filters.md) ⚠️ | **Deprecated**: Use conditionalFilters instead, will be removed in Jan 2026 | apps \[String]
criticality \[CriticalityFilter]
policies \[String]
issueOwners \[String]
categories \[String]
issueNames \[String]
sourceTools \[String]
businessPriority Range
epssScore Range
epssPercentile Range
issueImportance Range
appId \[String]
cwe \[String]
severityChange \[String]
severityChangeReasons \[String]
issueStatus \[String]
issueStatusVsLastScan \[String]
issueActions \[String]
originalSeverity \[String]
uniqueLibs \[String]
filePaths \[String]
languages \[String]
image \[String]
artifactSha \[String]
artifactPath \[String]
cbomId \[String]
cve \[String]
dastUrl \[String]
codeOwners \[String]
oscar \[String]
complianceControl \[String]
complianceStandard \[String]
issuesWithout \[String]
tags \[String]
os \[String]
baseImage \[String]
resolvedReasons \[String]
registryName \[String]
scaFixType \[ScaFixType]
oxuser \[String]
issueIds \[String]
ruleId \[String]
appOwnersEmail \[String]
appOwnersName \[String]
version \[String]
apiItem \[String]
saasBom \[String]
resolvedByName \[String]
|
| sort [`IssuesSort`](/api-documentation/api-reference/api--issue/types/inputs/issues-sort.md) | Sorting instructions for the returned issues | fields \[IssueSortByFields]
order \[Direction]
|
| owners `[String]` | Filter issues by specific owner identifiers | |
| tagIds `[String]` | Filter issues by tag identifiers for RBAC scoping | |
| inventoryFilters [`[InventoryTypes]`](/api-documentation/api-reference/api--issue/types/enums/inventory-types.md) | Filters for inventory queries targeting top issues | |
| dateRange [`DateRange`](/api-documentation/api-reference/api--application/types/inputs/date-range.md) | Date range for filtering issues | from Float
to Float
|
| limitAggItems `Int` | Maximum number of aggregation items to return | |
| offsetAggItems `Int` | Number of aggregation items to skip | |
| ignoreEnvCheck `Boolean` | Bypass environment checks for organizational stats queries | |
| exportsOptions [`IssuesExportOptions`](/api-documentation/api-reference/api--issue/types/inputs/issues-export-options.md) | Options for controlling issue export behavior | flattenAgg Boolean
isDemoEnabled Boolean
name String
columns \[IssuesExportColumn]
rowsLimit Int
|
| issueId `String` | Filter by specific issue identifier | |
| topOffset `Int` | Offset for top-level issues results | |
| topLevelSearch `String` | Search string for top-level issue search | |
| scrollDirection `String` | Direction for scrolling through paginated results | |
| openItems [`[FilterTypes]`](/api-documentation/api-reference/api--application/types/enums/filter-types.md) | Filters specifying open items | |
| conditionalFilters [`[ConditionalFilters]`](/api-documentation/api-reference/api--application/types/inputs/conditional-filters.md) | Complex conditional filters for advanced filtering | condition ConditionType
fieldName FilterTypes
values \[String]
greaterThan Float
lessThan Float
|
| cursorValue `String` | A value returned by the API that represents the position of the last item in the previous page. Use this value to paginate efficiently through the results. Pass the cursorValue from the previous API response to fetch the next page of results. If omitted, the API returns the first page. | |
### References
#### Queries using this object:
* [\ getIssues.getIssuesInput](/api-documentation/api-reference/api--issue/queries/get-issues.md)
* [\ getIssuesConditionalFiltersLazy.getIssuesInput](/api-documentation/api-reference/api--issue/queries/get-issues-conditional-filters-lazy.md)
* [\ getIssuePrioritization.getIssuesInput](/api-documentation/api-reference/api--issue/queries/get-issue-prioritization.md)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.ox.security/api-documentation/api-reference/api--issue/types/inputs/issues-input.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.