---
title: "List your storage apps"
method: GET
path: "/v1/storage"
tags: ["Storage"]
---

# List your storage apps

`GET /v1/storage`

Paginated list of every app you've uploaded to TestingBot storage, newest first.

## Query parameters

- `offset` integer
- `count` integer

## Response `200`

List your storage apps

- TestingbotEntitiesStorageFileList — Testingbot_Entities_StorageFileList model
  - `data` TestingbotEntitiesStorageFile[], required — Storage objects for this page.
    - `id` integer, required — Unique numeric storage object ID.
    - `app_url` string, required — TestingBot storage URL (`tb://<appkey>`) — pass as a capability to reference this app in mobile tests.
    - `url` string, required — Signed HTTPS URL to download the binary directly.
    - `filename` string, required — Original uploaded filename.
    - `type` string, required — Detected app type (ANDROID for .apk/.aab, IOS for .ipa/.zip, OTHER otherwise).
    - `version` string, required — CFBundleShortVersionString / versionName extracted from the binary.
    - `min_device_version` string, required — Minimum OS version required by the app.
    - `thumb` string, required — App icon (signed PNG URL).
    - `created_at` string, date-time, required — Upload timestamp.
    - `state` string, required — Metadata extraction state: PROCESSING right after upload, DONE once version / min_device_version / thumb are populated. Poll until DONE before relying on those fields.
    - `sim_only` boolean, required — True for iOS simulator-only IPAs (no signing).
  - `meta` TestingbotEntitiesMeta, required
    - `offset` integer, required — Number of items skipped from the start of the result set.
    - `count` integer, required — Items returned in this page (matches the requested `count` query param).
    - `total` integer, required — Total number of items available across all pages.

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/versions/eff607a49246/schema)
