# cloudItemsInput
Specifies input parameters for retrieving cloud security items with filtering and pagination.
### Examples
```graphql
input CloudItemsInput {
limit: Int
offset: Int
scanId: String
dateRange: DateRange
filters: CloudItemsFilters
filterSearch: [AutoCompleteSearch]
owners: [String]
tagIds: [String]
search: String
openItems: [FilterTypes]
orderBy: CloudItemsOrderBy
topOffset: Int
scrollDirection: String
cbomId: String
}
```
### Fields
| Field | Description | Supported fields |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| limit `Int` | Maximum number of items to return | |
| offset `Int` | Number of items to skip for pagination | |
| scanId `String` | Specific scan identifier to retrieve cloud items from | |
| dateRange [`DateRange`](https://docs.ox.security/api-documentation/api-reference/api--application/types/inputs/date-range) | Date range filter for the analysis | from Float
to Float
|
| filters [`CloudItemsFilters`](https://docs.ox.security/api-documentation/api-reference/api--cloud-security/types/inputs/cloud-items-filters) | Structured filters to apply to the cloud items search | apps \[String]
service \[String]
type \[String]
cloudProvider \[String]
assetName \[String]
accountId \[String]
region \[String]
serviceCategory \[String]
cluster \[String]
severities \[String]
isExposed \[String]
imageSource \[String]
registryType \[String]
registryName \[String]
imageScanStatus \[String]
artifactIds \[String]
|
| filterSearch [`[AutoCompleteSearch]`](https://docs.ox.security/api-documentation/api-reference/api--application/types/inputs/auto-complete-search) | Advanced search filters with autocomplete support | fieldName String
value \[String]
|
| owners `[String]` | Filter by application owners | |
| tagIds `[String]` | Filter by tag identifiers for role-based access control | |
| search `String` | Text search query to find specific cloud items | |
| openItems [`[FilterTypes]`](https://docs.ox.security/api-documentation/api-reference/api--application/types/enums/filter-types) | Filter for items that are currently open or active | |
| orderBy [`CloudItemsOrderBy`](https://docs.ox.security/api-documentation/api-reference/api--cloud-security/types/inputs/cloud-items-order-by) | Sorting configuration for the results | field String
direction Direction
|
| topOffset `Int` | Top offset for advanced pagination | |
| scrollDirection `String` | Direction for scrolling through results | |
| cbomId `String` | Cloud Bill of Materials identifier | |
### References
#### Queries using this object:
* [\ getCloudItems.cloudItemsInput](https://docs.ox.security/api-documentation/api-reference/api--cloud-security/queries/get-cloud-items)