---
title: "List the Items stored in Object Storage"
method: GET
path: "/object-storage/items"
tags: ["Object Storage"]
---

# List the Items stored in Object Storage

`GET /object-storage/items`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/object-storage/items`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/object-storage/items/get.ts> (a function with typed inputs; its response is checked against the schema)

List the current Object Storage Items for an Organization.

#### Sample Request
```
curl -X GET https://console.jumpcloud.com/api/v2/object-storage/items \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key:{API_KEY}'
```

	Note: The `limit` maximum is 100 ObjectStorageItems in a single response.

	MSP Note: Currently ObjectStorage can only operate in the context of a single organization.

## Query parameters

- `filter` string[]
- `fields` string[]
- `skip` string, int64
- `sort` string[]
- `limit` string, int64

## Response `200`

Success listing Object Storage Items.

- DevicesObjectStorageItemPublic[]
  - `objectId` string, hex
  - `versions` DevicesObjectStorageVersionPublic[]
    - `createdAt` string, date-time
    - `displayVersion` string
    - `metadata` DevicesObjectStorageMetadataPublic
      - `metadataExe` DevicesMetadataEXE: MetadataEXE holds parsed metadata for a Windows .exe installer (NSIS, Inno Setup, etc.).
        - `arch` string
        - `author` string
        - `installerEngineVersion` string
        - `sha256sum` string
        - `signatureLabel` string
        - `size` integer
        - `title` string
        - `url` string
        - `version` string
      - `metadataFile` DevicesMetadataFile
        - `mimeType` string
        - `sha256sum` string
        - `size` integer
      - `metadataIpa` DevicesMetadataIPA
        - `assetKind` string
        - `bundleIdentifier` string
        - `bundleVersion` string
        - `packageKind` string
        - `sha256sum` string
        - `shortVersion` string
        - `subtitle` string
        - `title` string
      - `metadataMsi` DevicesMetadataMSIPublic
        - `manufacturer` string
        - `productCode` string
        - `productName` string
        - `productVersion` string
        - `sha256sum` string
        - `upgradeCode` string
      - `metadataPkg` DevicesMetadataPKG
        - `assetKind` string
        - `bundleIdentifier` string
        - `bundleVersion` string
        - `managedInstallEligibilityStatus` 'MANAGED_INSTALL_ELIGIBILITY_NOT_EVALUATED' | 'MANAGED_INSTALL_ELIGIBLE' | 'MANAGED_INSTALL_INELIGIBLE' | 'MANAGED_INSTALL_ELIGIBILITY_UNKNOWN'
        - `packageKind` string
        - `sha256sum` string
        - `shortVersion` string
        - `subtitle` string
        - `title` string
    - `name` string
    - `objectId` string, hex
    - `rejectedReason` string
    - `sha256sum` string
    - `size` integer
    - `status` 'UNKNOWN' | 'PENDING' | 'VALIDATING' | 'AVAILABLE' | 'REJECTED' | 'INACTIVE'
    - `storagePath` string
    - `updatedAt` string, date-time
    - `version` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)