---
title: "Get a stored app by appkey"
method: GET
path: "/v1/storage/*"
tags: ["Storage"]
---

# Get a stored app by appkey

`GET /v1/storage/*`

Returns metadata for a single uploaded app — its filename, type, version, icon, and download URL.

## Query parameters

- `splat` integer, required

## Response `200`

Get a stored app by appkey

- TestingbotEntitiesStorageFile — Testingbot_Entities_StorageFile model
  - `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).

## Other responses

- `401` — Authentication required
- `404` — App not found

---

[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)